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 包，要求 Node.js 22 或更高版本，并设置 SUMUP_API_KEY。
直接托管设置
添加一个名为 sumup 的 MCP 服务器条目。
将 URL 设为 https://mcp.sumup.com/mcp。
如果客户端要求显式指定传输方式，请使用 streamable HTTP 传输。
在客户端提示时完成认证流程。
在首次任务提示前确认工具可被发现。
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 欧元的沙箱结账并返回结账 id。”
“检查此结账 id 并总结状态变更。”
“显示为此参考对账失败支付所需的数据。”
常见失败模式
服务器不可达
确认准确的 URL 与传输方式。
检查客户端是否允许出站 HTTPS。
从干净会话重试。
认证循环或未授权
重新执行认证握手，确保使用正确的账户/环境。
对于托管连接，移除任何 API 密钥 Bearer 头，改为通过 OAuth 认证。对于本地连接，检查 SUMUP_API_KEY。
确认令牌/会话具有所需的作用域。
工具未出现
在客户端中刷新/重新加载 MCP 服务器。
确认服务器别名与提示词/配置中的预期名称一致。
安全与可靠性规则
切勿在提示词或日志中暴露密钥或原始令牌。
新工作流与回归测试优先使用沙箱。
对于支付关键操作，通过确定性读取验证最终结账状态。
记录结账 id/参考以便审计与对账。
必需的响应契约
在回答 MCP 设置/使用请求时，需包含：
准确的服务器配置片段。
认证步骤及常见失败位置。
一条用于确认设置完成的验证命令/提示词。
在生产使用前于沙箱中执行的第一个安全任务。
适用场景：当用户提及 SumUp MCP、需要接入或使用 SumUp MCP 服务器、排查 MCP 认证问题，或在支持 MCP 的 AI 客户端中驱动 SumUp API 任务时。
限制：本文档未提供收费、价格等信息；具体客户端配置字段名可能不同，需参考各客户端最新文档；托管端点必须使用 OAuth，不能使用 API 密钥作为 Bearer 令牌。