Pink Agentic AI Payments

Pink Agentic AI Payments MCP サーバー：支出ルールの範囲内で、Claude、ChatGPT、Cursor がベンダーや請求書の支払いを行えます

pink-agentic-payments-mcp は、PinkWallet による Pink Agentic AI Payments の MCP サーバーです。Claude、ChatGPT、Cursor、VS Code、Windsurf、その他の MCP クライアントで動作する AI エージェントが、ベンダーへの請求書の支払いや API クレジットのチャージなどの支払いをリクエストできます。Pink は、支払い認証情報を発行する前に、その支払いが会社の支出ルール（エージェントごとの予算、1 回あたりの支払い上限、支払い先の許可リスト、しきい値を超えた場合の人間による承認）に適合するかを確認します。エージェントが常時利用可能なカードやキーを保持することはありません。

すべての支払いリクエストには、次の 3 つのいずれかの応答が返されます。allowed（1 回限りの認証情報付き）、pending_human（先に人間に確認）、blocked（理由付き）。

サンドボックスプレビュー：テスト用資金のみです。キーの取得に登録は不要です。

Claude や ChatGPT は MCP 経由で請求書を支払えますか？

はい。設定した制限の範囲内で支払えます。Pink を MCP サーバーとして接続すると、エージェントは 7 つの支払いツール（以下に記載）を利用できるようになります。「Acme の請求書に 1,200 ドル支払って」と頼むと、エージェントは pink.check_policy または pink.request_payment を呼び出します。請求書がルールに適合する場合、Pink は支払いを行います。承認が必要な場合は人間に確認し、支払いを拒否する場合は理由を伝えます。セットアップガイド：Claude · ChatGPT（開発者モード） · Cursor · Claude Code · 操作ガイド：AI エージェントが請求書を支払える MCP サーバー。

このパッケージの仕組み

このパッケージは、任意の MCP クライアントを Pink のリモート Streamable HTTP MCP サーバー（https://agentic-sandbox.pinkwallet.com/mcp）に接続する、ローカルの stdio MCP サーバーです。tools/list と tools/call（および、リモートサーバーで提供されている場合はリソース／プロンプト）を透過的に転送するため、ローカルサーバーには Pink のリモートサーバーが現在公開しているツールが常に反映されます。ハードコードされた内容はありません。リモート MCP に対応したクライアントは、この URL に直接接続することもできます。

クイックスタート

1. 無料のサンドボックスエージェントキーを取得する

登録は不要です。次のいずれかを実行します。

npx -y pink-agentic-payments-mcp --create-sandbox

サンドボックスのワークスペースが作成され、そのまま貼り付けられるクライアント設定が出力されます。または、自分で作成することもできます。

curl -s -X POST https://agentic-sandbox.pinkwallet.com/v1/sandbox/workspaces

レスポンスから任意の agents[].key を取得してください。

2. MCP クライアントに追加する

Claude Desktop（claude_desktop_config.json）、Cursor、Windsurf、その他の多くの stdio ベースの MCP クライアント：

{
  "mcpServers": {
    "pink": {
      "command": "npx",
      "args": ["-y", "pink-agentic-payments-mcp"],
      "env": { "PINK_AGENT_API_KEY": "pk_sandbox_agent_..." }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "pink": {
      "command": "npx",
      "args": ["-y", "pink-agentic-payments-mcp"],
      "env": { "PINK_AGENT_API_KEY": "${input:pink_agent_key}" }
    }
  }
}

環境変数：

• PINK_AGENT_API_KEY（必須）— サンドボックスのワークスペースから取得したエージェントキーです。
• PINK_MCP_URL（任意）— 既定値は https://agentic-sandbox.pinkwallet.com/mcp です。

ツール

これらはリモートサーバーの tools/list レスポンスから取得されます（実行結果の全文は TEST-OUTPUT.txt を参照してください）。

ツール	機能
pink.get_budget	このエージェントが引き続き使える金額を確認します。月間予算の残額、本日の支出額、1 回あたりの支払い上限、バルトの残高、会社の 1 日あたりの上限を確認できます。
pink.list_payees	この会社が承認したサプライヤー、プラットフォーム、請負業者を一覧表示します。それ以外の相手への支払いは停止され、人間に確認を求めます。
pink.list_rules	評価順に、このエージェントに適用されるポリシールールを表示します。最初に一致したルールにより、許可、確認、ブロックのいずれかが決まります。
pink.check_policy	ドライランを実行します。ルールと完全な判定トレースとともに、would_allow／would_ask／would_block を返します。資金の使用や保留は行われません。
pink.request_payment	実際の支払いリクエストを行います。1 回限りの認証情報を伴う allowed、人間への確認中に hold_id を伴う pending_human、または理由付きの blocked を返します。
pink.get_credential	保留中のリクエストを確認します。人間が承認すると、認証情報が返されます。
pink.report_receipt	支払い完了後に領収書を登録し、照合できるようにします。

テスト方法

このリポジトリの TEST-OUTPUT.txt には、稼働中のサンドボックスワークスペースに対して実行した、実際の3回分の完全な未編集出力が含まれています（テスト用資金のみ）。

1. ビルド済みサーバー（dist/bin.js）を、MCP SDK テストクライアントから標準入出力経由で実行しました。tools/list に加え、実際に allowed（サンドボックス認証情報が発行された場合）、blocked（月間予算超過の場合）、pending_human（新しい支払先の承認が必要な場合）の判定が返された pink.request_payment の呼び出しを行いました。
2. 公式 MCP Inspector CLI（npx @modelcontextprotocol/inspector --cli）を、同じビルド済みサーバーに対してヘッドレスで実行しました。
3. パッケージ化した tarball（npm pack の後に、クリーンなディレクトリで npx -y ./pink-agentic-payments-mcp-0.1.0.tgz を実行）から、同じ標準入出力テストを再度実行し、npx でのインストールが最初から最後まで正常に動作することを確認しました。

リンク

• ドキュメントハブ：pinkwallet.com/agentic/developers
• MCP 接続ガイド：pinkwallet.com/agentic/developers/connect-via-mcp
• JS/TS クライアント：pink-agentic-payments

ステータス

サンドボックスプレビュー（テスト用資金のみ）。npm で pink-agentic-payments-mcp として公開されています。npx -y pink-agentic-payments-mcp を実行するだけで利用でき、クローンやビルドの手順は不要です。

ライセンス

MIT