mcpField
S
sumup-mcp

sumup-mcp

github.com/sumupAgent 工作流559 次安装3 周前更新
代码仓库

关于 sumup-mcp

SumUp MCP 服务的配置与使用指南，适用于将 SumUp 工具接入支持 MCP 的客户端。内容涵盖托管 OAuth 和本地 API 密钥配置、故障排查、提示词模式及生产环境安全实践。

主要功能

  1. 01配置托管 MCP 端点
  2. 02设置本地 stdio 服务
  3. 03排查 OAuth 身份验证
  4. 04验证工具发现状态
  5. 05遵循支付安全实践

适用场景

  1. 01将 SumUp 接入 MCP 客户端
  2. 02诊断授权循环问题
  3. 03在沙盒中测试结账流程

MCP 相关

该技能说明客户端如何通过 streamable HTTP 和 OAuth 连接托管的 SumUp MCP 服务，或通过 API 密钥以 stdio 运行本地 `@sumup/mcp` 包，并提供配置与验证指引。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sumup/sumup-skills --skill sumup-mcp

安装后在 Claude Code 中输入/sumup-mcp确认已加载。

附带文件agents/openai.yamlassets/small-logo.svg

详细介绍

SumUp MCP 服务指南

当用户请求设置或使用 SumUp MCP 服务时，请使用此技能。

规范端点：

  • https://mcp.sumup.com/mcp

此技能涵盖的内容

  • 在支持 MCP 的客户端中配置 MCP 服务
  • 排查身份验证握手问题
  • 用于工具驱动的 SumUp API 任务的提示词模式
  • 在生产环境和沙盒环境中的安全使用防护措施

选择设置方式

如果已安装 SumUp 插件或扩展，请使用其内置的 MCP 连接，而不是添加重复服务。对于新的助手设置，优先使用 https://developer.sumup.com/tools/llms/plugins/ 中介绍的打包集成。

对于 Codex，请在终端中安装插件：

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

启动新会话以加载其技能和工具。出现提示时，完成 SumUp OAuth 授权。对于 Codex IDE 扩展，请使用独立技能和直接 MCP 连接。

托管端点使用为 MCP 资源签发的 OAuth 访问令牌。不要将 SumUp API 密钥（sup_sk_...）配置为其 Bearer 令牌。对于使用 API 密钥身份验证或仅支持 stdio 的客户端，请使用本地 @sumup/mcp package，并确保 Node.js 版本为 22 或更高，同时设置 SUMUP_API_KEY。

直接托管设置

  1. 添加名为 sumup 的 MCP 服务条目。
  2. 将 URL 设置为 https://mcp.sumup.com/mcp。
  3. 如果客户端要求明确指定传输方式，请使用可流式 HTTP 传输。
  4. 出现客户端提示时，完成身份验证流程。
  5. 在首次提示任务前，确认可以发现工具。
Codex
codex mcp add sumup --url https://mcp.sumup.com/mcp
codex mcp login sumup
codex mcp list

完成浏览器授权流程；在会话中使用 /mcp 查看工具。

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

在 Claude Code 中运行 /mcp，然后选择 SumUp 服务进行身份验证。

Cursor

将以下内容合并到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）中：

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

在 Cursor 的 MCP 设置中完成授权。

对于 Gemini CLI、VS Code、Claude Desktop 或其他客户端，请参阅 https://developer.sumup.com/tools/llms/mcp-server/ 和客户端当前的文档。使用客户端实际的配置架构；不同客户端的字段名称各不相同。

本地设置

要使用 API 密钥身份验证运行本地 stdio 服务：

SUMUP_API_KEY='sup_sk_...' npx -y @sumup/mcp

请将实际密钥保存在客户端的私有配置或环境中。它不能用作托管 OAuth 端点的凭据。

提示词模式

  • “使用 SumUp MCP 工具显示我的商户资料。”（只读验证。）
  • “列出我过去 24 小时内的 SumUp 商户结账。”
  • “创建一个金额为 12.34 EUR 的沙盒结账，并返回结账 ID。”
  • “检查此结账 ID，并总结状态变更。”
  • “显示为对账此参考编号对应的失败付款所需的数据。”

常见故障

无法连接服务
  • 确认 URL 和传输方式完全正确。
  • 检查客户端是否允许出站 HTTPS。
  • 在全新会话中重试。
身份验证循环或未授权
  • 重新执行身份验证握手，并确保账户和环境正确。
  • 对于托管连接，请移除任何 API 密钥 Bearer 标头，并通过 OAuth 进行身份验证。对于本地连接，请检查 SUMUP_API_KEY。
  • 确认令牌／会话具有所需的作用域。
未显示工具
  • 在客户端中刷新／重新加载 MCP 服务。
  • 确认服务别名与提示词／配置中预期的名称一致。

安全与可靠性规则

  • 切勿在提示词或日志中暴露机密或原始令牌。
  • 对于新的工作流和回归测试，优先使用沙盒。
  • 对于支付关键操作，请通过确定性读取验证最终结账状态。
  • 记录结账 ID／参考编号，以便审计和对账。

必须遵守的回复约定

回答 MCP 设置／使用请求时，请包含：

  1. 完整的服务配置代码片段。
  2. 身份验证步骤，以及常见故障发生的位置。
  3. 一条用于确认设置成功的验证命令／提示词。
  4. 在用于生产环境之前，可在沙盒中执行的一项安全初始任务。

评论

支持 Markdown