mcpField
S
sumup-mcp

sumup-mcp

github.com/sumupエージェントワークフロー559 回インストール3 週間前に更新
リポジトリ

sumup-mcp について

SumUp MCP サーバーの設定と利用を案内するスキルで、SumUp のツールを MCP 対応クライアントに接続する人を対象としています。ホスト型 OAuth とローカルの API キー設定、トラブルシューティング、プロンプト例、本番利用の安全策を扱います。

主な機能

  1. 01ホスト型 MCP エンドポイントの設定
  2. 02ローカル stdio サーバーの設定
  3. 03OAuth 認証の問題の診断
  4. 04ツール検出の確認
  5. 05決済の安全対策

活用シーン

  1. 01SumUp の MCP クライアントへの接続
  2. 02認証ループの原因調査
  3. 03サンドボックスでの決済テスト

MCP 対応

クライアントから streamable HTTP と OAuth でホスト型 SumUp MCP サーバーに接続する方法と、API キーを使ってローカルの `@sumup/mcp` パッケージを stdio で実行する方法を説明します。設定と確認の手順も含みます。

インストール

コマンドをコピーしてターミナルで実行します。

$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 サーバーを重複して追加せず、バンドルされている 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 のみ対応するクライアントには、Node.js 22 以降と SUMUP_API_KEY を使用して、ローカルの @sumup/mcp パッケージを利用してください。

直接ホスト型セットアップ

  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（1 つのプロジェクト）にマージします。

{
  "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. セットアップを確認するための検証コマンド／プロンプトを 1 つ。
  4. 本番環境で使う前にサンドボックスで行う安全な最初のタスク。

コメント

Markdown 対応