概要
SumUpのマーチャントアカウント、取引、支払い、チェックアウト、レシート、カードリーダー、チームメンバー、サブアカウントを任意のAIエージェントから参照できます。読み取り専用で、Bearerトークン認証に対応しています。
ガイド付きセットアップ
SumUp を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで SumUp を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
SumUp のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要で cloud.anythingmcp.com をそのまま使えます。 サインインし、Connectors → SumUp をクリックして認証情報を貼り付け、MCP APIキーを発行するだけです。Docker も
git cloneもローカルサーバーも不要です。
SumUp + Microsoft Copilot
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 — Microsoft Copilotにコネクターを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
SumUpのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 機能 |
|---|---|
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
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?