SumUp MCP Server

SumUp の Model Context Protocol（MCP） サーバーは、LLM と 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 は Streamable HTTP 用の /mcp と、レガシー SSE トランスポート用の /sse を公開します。どちらのルートも Durable Object に固定されているため、同じ Worker デプロイメント内のリクエスト間で MCP セッションの状態が維持されます。

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 キーを使ったワークフローには、Node.js 22 以降が必要なローカル MCP CLIを使用してください。

開発

開発環境のセットアップ、ローカルテスト、コントリビューター向けワークフローについては、CONTRIBUTING.mdを参照してください。