mcp-ap2

@codespar/mcp-ap2

非推奨：利用可能なエンドポイントはありません。 2026-09-27 に測定したところ、ap2.googleapis.com はすべてのパスに対して Google の汎用的な Error 404 (Not Found) ページを返し、AP2_SANDBOX=true で使用される sandbox.ap2.googleapis.com は TLS ハンドシェイクに失敗します。これは、そこで提供される証明書が *.googleapis.com を対象としており、追加のラベルには対応していないためです。AP2 はオープンな仕様であり、Google がホストする API ではありません。このサーバーのツールは、どのサービスにも接続できません。このパッケージは npm で非推奨となっており、参考用としてのみこのリポジトリに残されています。利用可能なエンドポイントがある場合は、AP2_BASE_URL を使ってサーバーの接続先を指定してください。このパッケージの提供を再開するには、プロバイダーが公開しているベース URL を記載して、mcp-dev-latam で issue を作成してください。

アルファ版リリース — npm の alpha dist-tag で公開されています。0.x.x-alpha の期間中は、バージョンを正確に指定してください。npm install <pkg>@alpha でインストールできます。

AP2（Google の Agent-to-Agent Payment Protocol）用 MCP サーバー — エージェントによる決済の認可、監査、信頼を実現します。

AP2 とは？

AP2（Agent-to-Agent Payment Protocol）は、エージェントによる決済における認可、監査、信頼のための Google のオープンなフレームワークです。重要な問いに答えます。誰がこの決済を承認したのか？どのような上限が適用されるのか？監査証跡の全容は？

仕様は ap2-protocol.org で公開されています。

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "ap2": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-ap2"],
      "env": {
        "AP2_API_KEY": "your-key",
        "AP2_AGENT_ID": "your-agent-id"
      }
    }
  }
}

Claude Code

claude mcp add ap2 -- npx @codespar/mcp-ap2

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "ap2": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-ap2"],
      "env": {
        "AP2_API_KEY": "your-key",
        "AP2_AGENT_ID": "your-agent-id"
      }
    }
  }
}

ツール（22）

ツール	目的
register_agent	AI エージェントを AP2 ネットワークの信頼できる支払者として登録します。
get_agent	エージェントの登録詳細、信頼ステータス、現在の支出状況を取得します
list_agents	登録済みエージェントを任意のフィルターで一覧表示します
revoke_agent	エージェントの支払い承認を取り消します。
authorize_payment	範囲を指定した上限付きで支払い承認をリクエストします。
get_authorization	ステータス、上限、有効期限を含む承認の詳細を取得します
list_authorizations	支払い承認を任意のフィルターで一覧表示します
execute_payment	承認済みの支払いを実行します。
get_audit_trail	取引の完全な監査証跡（すべての承認、承認処理、実行、決済など）を取得します。
list_audit_events	フィルターを指定して、すべての取引の監査イベントを一覧表示します
list_payment_methods	AP2 パートナーネットワークが提供する支払い方法を一覧表示します
get_transaction	承認、実行、決済のステータスを含む取引の詳細をすべて取得します
list_transactions	取引を任意のフィルターで一覧表示します
create_intent_mandate	AP2 インテントマンデート（取引を委任するユーザーの意図を表す検証可能なクレデンシャル）を作成します。
create_cart_mandate	AP2 カートマンデート（商品項目、合計金額、a..を拘束する、販売者が署名した変更不可のカートコミットメント）を作成します。
create_payment_mandate	AP2 支払いマンデート（カートマンデートに対する決済を承認する、最終的な検証可能なクレデンシャル）を作成します。
verify_credential	検証可能なクレデンシャル（インテント、カート、または支払いマンデート）を検証します。
create_presentation	1 つ以上のクレデンシャルをまとめた検証可能なプレゼンテーションを作成します（例：
verify_presentation	検証可能なプレゼンテーションと、保有者との紐付けやチャレンジノンスを含むすべての埋め込みクレデンシャルを検証します。
resolve_did	AP2 ユニバーサルリゾルバーを介して、分散型識別子（DID）をその DID ドキュメントに解決します。
create_receipt	決済済みの支払いの署名付きレシートを作成します。取引、マンデート、a..を結び付ける改ざん検知可能な記録です。
verify_receipt	レシートの署名、発行者、および元のマンデートまでの連鎖を検証します。

認証

サーバーはすべてのリクエストで、AP2_API_KEY を Authorization: Bearer ヘッダーとして、AP2_AGENT_ID を X-Agent-Id ヘッダーとして送信します（src/index.ts:69-73）。

これらの認証情報を発行するポータルはありません。この README が以前リンクしていた開発者ポータル developers.google.com/ap2 は HTTP 404 を返し、リンク先の ap2-spec リポジトリも同様です。公開されている仕様は ap2-protocol.org にあります。

環境変数

変数	必須	説明
AP2_API_KEY	はい	Authorization: Bearer として送信されます
AP2_AGENT_ID	はい	X-Agent-Id ヘッダーとして送信されます
AP2_SANDBOX	いいえ	true にすると BASE_URL が https://sandbox.ap2.googleapis.com/v1 に切り替わりますが、TLS エラーになります

ユースケース

• 承認済みエージェントによる購入 — エージェントが支出承認をリクエストし、上限付きの承認を受けてから支払いを実行します
• マルチエージェントコマース — エージェント A がエージェント B に対し、範囲を指定した上限付きで代理支払いを行う権限を付与します
• コンプライアンスと監査 — すべての承認、承認処理、実行、決済の完全な監査証跡
• 異なる決済レール間の支払い — AP2 はカード決済、銀行振込、ウォレット、x402 マイクロペイメントをつなぎます

ロードマップ

v0.2（予定）

• create_policy — 再利用可能な承認ポリシーを定義します
• delegate_authority — エージェント間での承認委任を可能にします
• get_spend_report — 支出分析とレポートを取得します
• OAuth 2.0 認証フロー

v0.3（予定）

• リアルタイムの承認イベントに対応する Webhook サポート
• 自動 FX による複数通貨対応
• 支払い方法として x402 と統合

貢献をご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

• AP2 仕様
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントの支払いに対するガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT