概要
SumUpのマーチャントアカウント、取引、支払い、チェックアウト、レシート、カードリーダー、チームメンバー、サブアカウントを任意のAIエージェントから参照できます。読み取り専用で、Bearerトークン認証に対応しています。
ガイド付きセットアップ
SumUp を Cursor に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで SumUp を接続して、MCP URL を Cursor に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
SumUp のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要で cloud.anythingmcp.com をそのまま使えます。 サインインし、Connectors → SumUp をクリックして認証情報を貼り付け、MCP APIキーを発行するだけです。Docker も
git cloneもローカルサーバーも不要です。
SumUp + Cursor
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 — Cursorにコネクターを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう — エージェントが
SumUpのツールを呼び出せるようになりました。
利用可能なツール
| ツール | 機能 |
|---|---|
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
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい — MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?