概要
SumUpのマーチャントアカウント、取引、支払い、チェックアウト、レシート、カードリーダー、チームメンバー、サブアカウントを任意のAIエージェントから参照できます。読み取り専用で、Bearerトークン認証に対応しています。
ガイド付きセットアップ
SumUp を ChatGPT に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで SumUp を接続して、MCP URL を ChatGPT に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
ChatGPT のプラグインディレクトリにある AnythingMCP プラグインは、AnythingMCP Cloud 上で社内データベース（PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB、読み取り専用）への質問に答えます。掲載ページを開き (新しいタブで開きます)、Install plugin をクリックしてください。それ以外のコネクタは、AnythingMCP の MCP URL を使ってカスタム MCP サーバーとして ChatGPT に追加します。
こう聞いてみよう
SumUp のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要。cloud.anythingmcp.com を直接ご利用いただけます。 サインインし、Connectors → SumUp をクリックして認証情報を貼り付け、MCP APIキーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要です。
SumUp + ChatGPT
SumUpのマーチャントアカウント、取引、支払い、チェックアウト、レシート、カードリーダー、チームメンバー、サブアカウントを任意のAIエージェントから参照できます。読み取り専用で、Bearerトークン認証に対応しています。
前提条件
コネクタに組み込まれているセットアップ手順の全文を確認してください（アプリ内ストアでコネクタを選択すると表示されます）。このコネクタに必要な環境変数は次のとおりです。
SUMUP_API_KEY
ステップ 1 — 認証情報を取得する
セットアップには約2分かかります。SumUpのマーチャントアカウントと、そのアカウントのAPIキーが必要です。
- https://me.sumup.com のSumUpダッシュボードにサインインします。
- Settings → For Developers(または開発者ポータル)を開きます。
- APIキー(Personal Access Token)を生成し、
SUMUP_API_KEYに貼り付けます。このキーは、すべての呼び出しでBearerトークンとして送信されます。 - コネクターをインストールして
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 — ChatGPTにコネクタを追加する
サーバーURL: AnythingMCPで MCP Servers を開き、このコネクタが属しているサーバーのURL（
https://cloud.anythingmcp.com/mcp/…）をコピーしてください。このガイドでYOUR_SERVER_IDと書かれている箇所で使用します。
ChatGPTでは、MCPサーバーを Plugins ページからプラグインとして追加します。Web版かつ有料プランで利用できます。開発者モードはもう必要ありません。Businessワークスペースでは、追加できるのは管理者とオーナーのみです。EnterpriseとEduでは、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins にアクセスし、Add、続いて Add custom MCP server をクリックします。
- 名前を入力します。例: Name:
SumUp。 - Connection で、Server URL に
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Authentication は OAuth のままにします。 - I understand and want to continue を選択し、Create as a plugin をクリックします。ChatGPTから求められたら、AnythingMCPにサインインしてアクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| ツール | 機能 |
|---|---|
sumup_get_merchant_profile | 認証済みAPIキーに紐づくマーチャントプロフィールとアカウント情報（マーチャントコード、会社名など）を取得します… |
sumup_list_transactions | 認証済みマーチャントアカウントの取引履歴を、日付範囲や支払いステータスで絞り込み、ページネーション付きで一覧表示します |
sumup_get_transaction | 取引IDまたは取引コードを指定して、特定の取引の詳細情報を取得します |
sumup_list_payouts | マーチャントの銀行口座に振り込まれたペイアウト履歴と精算レポートを、日付範囲で絞り込んで取得します |
sumup_list_checkouts | 顧客向けに作成されたオンラインチェックアウトと支払いリンクを、ステータスやチェックアウト参照で任意に絞り込んで一覧表示します |
sumup_list_subaccounts | メインのマーチャントアカウント配下に設定されたオペレーターサブアカウントを取得します |
sumup_list_memberships | API キーのユーザーが所属するマーチャントアカウント（および組織）を、resource.id としてのマーチャントコード、アカウント名などとともに一覧表示します… |
sumup_get_merchant | マーチャントコードでマーチャントアカウントを取得します：会社名と法的情報、業種とプロファイル、国、デフォルトの通貨とロケールなど… |
sumup_list_merchant_payouts | 2 つの日付の間にマーチャントの銀行口座へ振り込まれたペイアウトを一覧表示します（現行の v1.0 API）：ペイアウト日、金額、手数料、通貨、ステータス、参照番号など… |
sumup_list_merchant_transactions | マーチャントの取引を一覧表示します（現行の v2.1 API）：カード、現金、オンラインの支払い、返金、チャージバックを金額、通貨、ステータスなどとともに… |
sumup_get_merchant_transaction | 1 件の取引の詳細をすべて取得します（現行の v2.1 API）：金額、VAT、チップ、手数料、ステータス、カードと入力方式、商品、ペイアウト計画など… |
sumup_get_receipt | 取引の構造化されたレシートを取得します：マーチャント情報、商品と VAT を含む取引データ、カード（EMV）およびアクワイアラーのデータ |
sumup_get_checkout | ID でオンラインチェックアウトを 1 件取得します：金額、通貨、ステータス（PENDING、PAID、FAILED、EXPIRED）、チェックアウト参照、説明など… |
sumup_get_customer | 保存済みの顧客（定期払いやトークン化されたオンライン決済に使用）を、自分で割り当てた顧客 ID で取得します：氏名などの個人情報… |
sumup_list_payment_instruments | 顧客の保存済み支払い手段を一覧表示します：カードトークン、カード種別とマスクされた情報、マンデート、作成日など… |
sumup_list_payment_methods | マーチャントがオンラインチェックアウトで利用できる支払い方法（カード、Apple Pay、Google Pay、iDEAL、Bancontact など）を一覧表示します… |
sumup_list_members | マーチャントアカウントのメンバー（ユーザー）を、メールアドレス、ロール、ステータス（accepted、pending など）、権限とともに一覧表示します |
sumup_get_member | マーチャントアカウントのメンバーを 1 件取得します：ユーザー、メールアドレス、ロール、権限、ステータス、タイムスタンプ |
sumup_list_roles | マーチャントアカウントのカスタムロールを名前と権限とともに一覧表示し、メンバーのロールで何ができるかを説明できるようにします |
sumup_get_role | マーチャントアカウントのカスタムロールを 1 件、権限とともに取得します |
sumup_list_persons | マーチャントアカウントに登録された人物（法定代理人、オーナー、その他の事業関係者）を一覧表示します… |
sumup_get_person | マーチャントアカウントに登録された人物を 1 件取得します |
sumup_list_readers | マーチャントアカウントとペアリングされたカードリーダー（SumUp Solo など）を一覧表示します：ID、名前、ステータス、デバイスのモデルと識別子 |
sumup_get_reader | ペアリング済みのカードリーダーを 1 台取得します：名前、ステータス、デバイスのモデルと識別子、メタデータ、タイムスタンプ |
sumup_get_reader_status | カードリーダーのリアルタイムのステータスを取得します：オンラインかオフラインか、バッテリー残量、接続タイプ、ファームウェア、現在のチェックアウトの状態 |
sumup_get_reader_checkout | カードリーダーに送信されたチェックアウトを取得します：金額、ステータス、結果の取引 |
FAQ
無料のChatGPTプランでカスタムMCPサーバーは使えますか？ OpenAIはカスタムMCPサーバーを有料プラン限定として案内しており、Freeプランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?