SumUp MCP Server

SumUp 的 模型上下文协议（MCP）服务，用于大模型与 SumUp API 之间的交互。MCP 服务允许你通过 MCP 客户端（例如 Cursor、Claude）连接 SumUp 服务，并使用自然语言操作你的 SumUp 账户。

此软件包以 Cloudflare Worker 的形式运行，为 SumUp 提供 MCP 传输。

身份验证遵循 MCP OAuth 资源服务器流程：

• Worker 会发布受保护资源元数据，指引客户端前往 SumUp 授权服务器。
• 客户端向 /mcp 发送 Authorization: Bearer <access-token>。
• Bearer 令牌必须是由 SUMUP_AUTH_HOST 签发、且对 Worker 资源 URL 有效的 JWT 访问令牌。

sup_sk_... 等 SumUp API 密钥不能用作托管服务的 Bearer 令牌。

Worker 提供 /mcp 用于 Streamable HTTP，并提供 /sse 用于旧版 SSE 传输。这两个路由都绑定到 Durable Object，因此 MCP 会话状态可在同一 Worker 部署中的多个请求之间保留。

在 MCP 客户端中使用

将支持 OAuth 的 Streamable HTTP 客户端连接到 https://mcp.sumup.com/mcp，然后在浏览器中登录 SumUp。客户端会从受保护资源元数据中发现授权服务器。

同时安装技能和 MCP

SumUp 插件包含集成技能和托管 MCP 配置。对于 Codex：

codex plugin marketplace add sumup/sumup-skills
codex plugin add sumup@sumup
codex plugin list

启动新会话，并在出现提示时完成授权。对于其他助手，请参阅插件设置指南。

直接连接

如果你只需要 MCP 工具，可直接配置托管服务。对于 Codex：

codex mcp add sumup --url https://mcp.sumup.com/mcp
codex mcp login sumup
codex mcp list

对于 Claude Code：

claude mcp add --transport http --scope user sumup https://mcp.sumup.com/mcp
claude mcp list

在 Claude Code 中打开 /mcp 进行身份验证。对于 Cursor，将此条目合并到 ~/.cursor/mcp.json 中：

{
  "mcpServers": {
    "sumup": {
      "url": "https://mcp.sumup.com/mcp"
    }
  }
}

在 Cursor 的 MCP 设置中完成授权。如果你已安装 SumUp 插件，请使用插件自带的连接，而不要重复添加手动配置项。

连接后，可以尝试一个只读提示词：“使用 SumUp MCP 工具显示我的商户资料。”

如需了解 Gemini CLI、VS Code、Claude Desktop 的设置和故障排除，请参阅 MCP 设置指南。对于 stdio 客户端和 API 密钥工作流，请使用本地 MCP CLI，它要求 Node.js 22 或更高版本。

开发

开发环境设置、本地测试和贡献者工作流请参阅 CONTRIBUTING.md。