MCP 経由で Tabby を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Tabby をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Tabby + Cursor

Tabby の後払い（BNPL、UAE、サウジアラビア、クウェート）に対応します。キャプチャと返金を含む決済、チェックアウトセッション、顧客の異議申し立て、Webhook を照会できます。キャプチャ、返金、クローズも含まれますが、インストール時はオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

TABBY_API_URL, TABBY_SECRET_KEY

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

セットアップは約 2 分です。Tabby の加盟店アカウントと、そのシークレット API キーが必要です。

1. Tabby Merchant Dashboard（UAE は merchant.tabby.ai、サウジアラビアは merchant.tabby.sa）にサインインするか、Tabby のパートナーマネージャーに API キーを依頼します。
2. シークレットキーを TABBY_SECRET_KEY にコピーします。テスト決済には sk_test_...、本番決済には sk_... を使います。公開キー（pk_...）はここでは使えません。
3. TABBY_API_URL には加盟店の地域の API を設定します。UAE（とクウェート）は https://api.tabby.ai、サウジアラビアは https://api.tabby.sa です。Tabby はすべての呼び出しが加盟店の地域に送られることを求めます。テストと本番は同じアドレスで、どちらになるかはキーで決まります。
4. コネクタをインストールし、tabby_search_payments を実行します。最新の決済が一覧表示され、キーが確認できます。

決済 ID と注文番号: 決済 ID は Tabby が割り当てる UUID で、自社の注文番号は決済の order.reference_id です。注文番号から決済を探すとき、AI は tabby_search_payments で注文日の決済を一覧にし（created_from / created_to）、order.reference_id を照合します。

読み取れるデータ: 新しい順の決済（ステータス、金額と通貨、購入者（名前、メール、電話）、注文の参照番号と商品、キャプチャと返金）、配送先住所、税、送料、割引、金額と日付付きのすべてのキャプチャと返金を含む 1 件の決済の全情報、顧客のチェックアウトが完了しなかったときのチェックアウトセッション、理由、コメント、添付ファイル、対象商品、自動承認までの残り日数を含む顧客の異議申し立て、そして加盟店コードに登録された Webhook（ヘッダーの値は返されません）です。

決済ステータス: AUTHORIZED は顧客が承認済みでまだ何もキャプチャされていない状態、CLOSED は全額キャプチャ済みまたはクローズ済み、REJECTED と EXPIRED はお金が動いていないことを意味します。ステータスで絞り込まない場合、検索は AUTHORIZED と CLOSED の決済だけを返します。

インストール時はオフ: tabby_create_capture（注文の発送時に AUTHORIZED の決済を全額または一部キャプチャ）、tabby_create_refund（CLOSED の決済を返金。お金はすぐに顧客に戻り、取り消せません）、tabby_close_payment（キャンセルされた注文や一部キャプチャの後に、未キャプチャ分を解放）です。お金が動くため、管理者が意図的にオンにします。オンにした後も、AI は決済、金額、通貨を示してあなたの同意を待ち、再試行が二重に実行されないよう reference_id を渡します。

金額と時刻: 金額は小数 2 桁（AED、SAR）または 3 桁（KWD）までの文字列です。日付と時刻は UTC の ISO 8601 です。

制限: 決済の検索は 1 回の呼び出しで最大 20 件を返し、AI は offset で次のページを取得します。異議申し立ての一覧は最新の 100 件を返し、トークンでページを進めます。

よくあるエラー: 401 はシークレットキーが間違っているか、公開キーを使っていることを意味します。本文が空の 400 はキーがない場合にも返ります。存在する決済で 403 や 404 が返る場合は、たいてい TABBY_API_URL の地域が間違っています。返金で 409 が返る場合は、決済がまだ返金できない状態（CLOSED でない）か、金額が大きすぎます。

このコネクタは、チェックアウトセッションの作成、決済の更新、Webhook の登録、異議申し立てへの回答は行いません。これらは Tabby Merchant Dashboard で行ってください。

ステップ 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" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Tabby のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「昨日作成された Tabby の決済のうち、まだ AUTHORIZED でキャプチャされていないものはどれですか？」
• 「注文番号 100245 の Tabby 決済を探して、キャプチャと返金を見せてください。」
• 「未解決の異議申し立てと、それぞれ自動承認までの残り日数を一覧にしてください。」
• 「Tabby のチェックアウトが完了しなかったとお客様が言っています。このチェックアウトセッションを確認して、何が起きたか教えてください。」
• 「注文 100245 の Tabby 決済で 120 AED を返金してください。先に決済と金額を見せてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続