SumUp MCPでGemini CLIと支払いを確認

💡 インストール不要で cloud.anythingmcp.com をそのまま使えます。 サインインし、Connectors → SumUp をクリックして認証情報を貼り付け、MCP APIキーを発行するだけです。Docker も git clone もローカルサーバーも不要です。

SumUp + Gemini

SumUpのマーチャントアカウント、取引、支払い、チェックアウト、レシート、カードリーダー、チームメンバー、サブアカウントを任意のAIエージェントから参照できます。読み取り専用で、Bearerトークン認証に対応しています。

前提条件

コネクターに組み込まれている詳細なセットアップ手順をご確認ください(アプリ内ストアでコネクターを選択すると表示されます)。このコネクターに必要な環境変数は次のとおりです。

SUMUP_API_KEY

ステップ1 — 認証情報を取得する

セットアップには約2分かかります。SumUpのマーチャントアカウントと、そのアカウントのAPIキーが必要です。

1. https://me.sumup.com のSumUpダッシュボードにサインインします。
2. Settings → For Developers(または開発者ポータル)を開きます。
3. APIキー(Personal Access Token)を生成し、SUMUP_API_KEY に貼り付けます。このキーは、すべての呼び出しでBearerトークンとして送信されます。
4. コネクターをインストールして sumup_get_merchant_profile を実行します。キーに紐づくアカウントのマーチャントコード、会社名、通貨、国が返され、キーが有効であることを確認できます。

読み取れる内容: マーチャントプロフィール、取引履歴(デフォルトでは新しい順。ステータス(SUCCESSFUL、CANCELLED、FAILED など)での絞り込みや、指定したISO 8601タイムスタンプ以降に変更された取引での絞り込みが可能で、1ページあたり最大100件)、IDまたは取引コード(TD6Q7P2 など)で指定した1件の取引、2つの日付(YYYY-MM-DD)の間に銀行口座へ入金された支払い、独自のチェックアウト参照で絞り込めるオンラインチェックアウトと支払いリンク、そしてメインアカウント配下のオペレーターサブアカウントです。

マーチャントコード、レシート、チーム、カードリーダー: 現行バージョンのSumUp APIは、アカウントをマーチャントコードで指定します。マーチャントコードは sumup_get_merchant_profile で取得でき、キーが複数のアカウントにアクセスできる場合は sumup_list_memberships で一覧を、sumup_get_merchant で個々のアカウントを確認できます。このコードを使って、AIは現行APIバージョンの取引と支払い(返金やチャージバックなどの控除を含む)、取引のレシート、個別のオンラインチェックアウト、オンラインで利用できる支払い方法、保存済みの顧客とそのトークン化されたカード(下4桁のみ)、メンバー、カスタムロール、登録済みの人物(オーナー、法定代理人)、そしてペアリング済みのカードリーダーとそのリアルタイムのステータスや送信されたチェックアウトも読み取ります。従来の取引ツールと支払いツールは、既存の設定のためにそのまま残ります。403が返る場合は、キーのユーザーにSumUp上でそのアカウントへの権限がありません。

読み取り専用: 26個のツールはすべて読み取りのみを行います。SumUpアカウント内のデータが変更されることはありません。返金、新しいチェックアウト、リーダーでの決済、メンバーの変更はSumUpダッシュボードで行ってください。

すでにインストール済みですか？ 以前にインストールしたコネクターにも、カタログ更新で新しいツールが届きます。AnythingMCPでコネクターを開き、Catalog update available の下で新しいツールの一覧を確認して Apply update をクリックしてください。認証情報や自分で追加したツールはそのまま残ります。

ステップ2 — アダプターをインストールする

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ3 — Geminiにコネクターを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう — Gemini CLI が SumUp のツールを呼び出せるようになりました。

利用可能なツール

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクターのランディングページ
• Claudeに接続する
• ChatGPTに接続する