SumUp MCP 连接 Gemini CLI：付款查询

💡 无需安装？直接使用 cloud.anythingmcp.com。 登录后，点击 Connectors → SumUp，粘贴你的凭据，生成 MCP API 密钥即可。无需 Docker，无需 git clone，无需本地服务器。

SumUp + Gemini

通过任意 AI 智能体查看 SumUp 商户账户、交易、结算、结账、收据、刷卡终端、团队成员和子账户。只读，采用 Bearer 令牌认证。

前提条件

请参阅连接器内置的完整设置说明（在应用内商店中选择该连接器即可查看）。此连接器所需的环境变量如下：

SUMUP_API_KEY

第 1 步 — 获取凭据

设置大约需要 2 分钟。你需要一个 SumUp 商户账户，以及该账户的 API 密钥。

1. 登录 SumUp 控制台：https://me.sumup.com。
2. 打开 Settings → For Developers（或开发者门户）。
3. 生成 API 密钥（个人访问令牌），并将其粘贴到 SUMUP_API_KEY 中。每次调用时，它都会作为 Bearer 令牌发送。
4. 安装连接器并运行 sumup_get_merchant_profile：它会返回该密钥所对应账户的商户代码、公司名称、币种和国家/地区，以此证明密钥可用。

可读取的内容：商户资料；交易历史（默认按时间从新到旧），可按状态（如 SUCCESSFUL、CANCELLED 或 FAILED）筛选，或只查看自某个 ISO 8601 时间戳以来发生变更的交易，每页最多 100 条；按 ID 或交易代码（如 TD6Q7P2）查询单笔交易；两个日期（YYYY-MM-DD）之间转入你银行账户的结算款；在线结账和支付链接，可按你自己的结账引用筛选；以及主账户下的运营方子账户。

商户代码、收据、团队和刷卡终端：当前版本的 SumUp API 通过商户代码定位账户，sumup_get_merchant_profile 会返回该代码；如果密钥可访问多个账户，sumup_list_memberships 会列出它们，sumup_get_merchant 则显示其中一个。借助该代码，AI 还能通过当前 API 版本读取交易和结算（结算包含退款、拒付等扣款）、某笔交易的收据、单个在线结账、在线可用的支付方式、已保存的客户及其令牌化的银行卡（仅显示后四位）、成员、自定义角色和登记的人员（所有者、法定代表人），以及已配对的刷卡终端及其实时状态和发送到终端的结账。旧版交易和结算工具会保留，供现有配置使用。返回 403 表示该密钥的用户在 SumUp 中没有该账户的权限。

只读：这 26 个工具都只读取数据，不会更改你 SumUp 账户中的任何内容。退款、新建结账、终端收款和成员变更请在 SumUp 控制台中完成。

已经安装？ 之前安装的连接器可通过目录更新获得新工具：在 AnythingMCP 中打开该连接器，在 Catalog update available 下查看新工具列表，然后点击 Apply update。你的凭据和你自己添加的工具保持不变。

第 2 步 — 安装适配器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

第 3 步 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list）— anythingmcp 应显示为已连接。
4. 开始输入提示 — Gemini CLI 现在可以调用 SumUp 的工具。

可用工具

常见问题

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

后续步骤

• 连接器落地页
• 连接到 Claude
• 连接到 ChatGPT