whollycrypto.
日本語

AI 連携 · MCP

AI アシスタントを接続しよう。

自分の Wholly Crypto で支払い検索、残高確認、請求書作成ができます。

自分のサーバー、1 つの MCP URL。

加盟店版に同梱： 5.0.0+。追加のデーモン、Node.js 実行環境、ホスト型リレーは不要です。環境に設定した API ドメインを使います。例： https://api.example.com/mcp.

  1. 開く 設定 → API アクセス。専用の認証情報を作成し、アシスタントに必要なプロジェクトを割り当てます。まず読み取り専用から始めてください。
  2. 確認先： AI 接続 · MCPで MCP を有効にします。認証情報を選び、次を選択します： 読み取り専用 を選んで保存します。
  3. 表示された URL をアシスタントのリモート HTTP/MCP 設定に追加します。
  4. OAuth では加盟店コンソールにログインします。クライアント名、戻り先、認証情報の権限を確認して承認してください。既存の Basic Auth と TOTP も適用されます。
{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

例のドメインは置き換えてください。設定形式はクライアントにより異なります。ローカルコマンドや旧 SSE URL ではなく、Streamable HTTP を選んでください。

支払いについて聞いてみよう。

  • 「ストアの最新の未払い請求書を見せて。」
  • 「このストアで受け付ける資産は？」
  • 「ウォレット残高と配信に失敗した Webhook を確認して。」
  • 「注文 1042 に 25 EUR の請求書を作って。」 請求書作成の権限が必要です。

8 つの読み取りツールで、プロジェクト、ストア、決済方法、ウォレット、請求書、配信履歴、キャッシュされた換算を扱えます。任意の 9 つ目のツールは既存 API のルールに従って請求書を作成します。

結果にはプロジェクトとストアの ID が含まれ、金額は十進数の文字列のままです。キャッシュ済みのレートと残高は鮮度情報を保持します。換算額は保証された請求書見積もりではありません。

アシスタントのアクセス範囲を選ぼう。

MCP は更新後も含め初期状態ではオフです。既存の API キーが自動でアクセス権を得ることはありません。アシスタントは承認したプロジェクトだけを参照でき、IP 制限と認証情報の REST レート制限も MCP に適用されます。

請求書を作るには読み書き可能な認証情報と次を選びます： 読み取り + 請求書作成。OAuth クライアントが要求する項目： mcp:invoice:create。さらにチェックする項目： 請求書作成も許可 を承認時に選択します。

同じものを再利用します： idempotency_key と請求書の本文を、タイムアウト後も同じまま再送してください。新しいキーは新しい請求書を作ります。通常のスプレッド、許容差、支払い、クレジットのルールも適用されます。

キーのエクスポートや送金ツールはありません。 MCPでは復元フレーズの表示、送金、スイープ、返金、通知の再送、アカウント・ドメイン・請求設定の変更はできません。

OAuth、Bearerキー、接続の取り消し

OAuthアクセストークンの有効期間は15分です。更新トークンはローテーションされ、接続は最大30日間有効です。古い更新トークンの再利用で接続は取り消されます。戻り先URLは登録済みのHTTPSまたはループバックだけです。

使用 接続済みクライアント → 取り消す でアクセスを解除します。MCPを無効にするとOAuth接続も取り消されます。認証情報のローテーション、MCPポリシー、正規APIドメインの変更後は再接続が必要です。

カスタムヘッダーに対応するクライアントは、MCPを許可したAPIキーを次で使えます： Authorization: Bearer …。そのキーは別途REST権限も持つため、MCP専用アクセスにはOAuthがおすすめです。秘密情報をチャット、URL、ソースコードに貼り付けないでください。

知っているクライアントだけを許可してください。表示名は検証されていません。AIプロバイダーは許可した情報を受け取ります。請求書ツールが返す顧客データも含まれます。

接続に失敗したら。

  • 404: MCPを有効にし、コンソールや決済用ではなくAPIホストを使ってください。
  • 401: OAuthで再接続するか、Bearer認証情報が有効か確認してください。
  • 403: 認証情報の権限、許可したプロジェクト、オリジン、接続元IP制限を確認してください。
  • GETで405： 正常な応答です。このステートレスなエンドポイントはPOSTと有限のJSON応答を使い、独立したSSEストリームはありません。
  • 429: 次の時間まで待ってください： Retry-After。MCPとRESTは認証情報のリクエスト枠を共有します。
  • 請求書を作れない： すべての書き込み権限、プロジェクト・ストアの状態、決済の準備、クレジットアカウントの検証を確認してください。

Cloudflareのキャッシュと対話型チャレンジを、次のパスでは無効にしてください： /mcp, /mcp/oauth/* とOAuth検出パス。IP許可リストにはアシスタントサービスが公開している送信元アドレスを含めます。

対応するプロトコル改訂： 2025-11-25, 2025-06-18 と 2025-03-26。クライアントはいずれかに対応する必要があります。次を確認してください： API リファレンス には全ツール、エンドポイント、エラー形式を載せています。

請求書ごとに決済方法を選ぶ。

使用 invoice.payment_methods と chain_slug: "ethereum" と asset_tickers: ["USDC", "USDT"]。slugとティッカーはストアの決済方法、または次で確認できます： list_payment_methods.

Merchant 5.4.0以降は無効・未許可の選択肢を無視します。一致がなければストアの標準設定を使います。チェーンだけの指定は有効な許可済み資産をすべて含みます。同じティッカーが複数ある場合は正確な asset_idsが必要です。準備状態とレートの確認は行われ、チェーン別のエラーを返します。Lightningは別扱いで、空の選択配列は無効です。 リクエスト形式 →