StableOps Agent Payments MCP サーバー

中文文档

エージェントが StableOps Agent Payments を設定・実行できるようにする stdio Model Context Protocol (MCP) サーバーです。秘密鍵、シードフレーズ、KMS 認証情報、承認権限はユーザーが管理したままにできます。

インストールと実行

Node.js 20 以降が必要です。

セットアップ時には管理キーのみを指定します。

STABLEOPS_API_KEY=sk_sandbox_... \
STABLEOPS_AP_ENABLE_MANAGEMENT_WRITES=true \
STABLEOPS_AGENT_KEY_OUTPUT_FILE=/protected/absolute/path/stableops-agent-key \
npx -y -p @stableops/agent-payments-mcp-server@0.2.0 stableops-agent-payments-mcp

管理モードはデフォルトで読み取り専用です。変更を伴うツールは STABLEOPS_AP_ENABLE_MANAGEMENT_WRITES=true の場合にのみ登録されます。管理プロセスはオープンワールドの探索や支払い実行を公開しません。一度限りの Agent Key シークレットはモデルに返されません。サーバーは発行前に 0600 の宛先を予約し、ストレージに失敗した場合は新しく発行したキーを自動的に失効させます。

ウォレットペアリングツールは、ユーザーが署名する必要がある正確なメッセージのみを返します。秘密鍵、シードフレーズ、KMS 認証情報を受け入れるツールはありません。ユーザーは自分のウォレットで署名し、署名のみを返します。

日常のランタイム使用では、管理キーを削除し、制限付き Agent Key とユーザー操作のサイナーサイドカーを使用します。

STABLEOPS_AGENT_KEY=ak_sandbox_... \
STABLEOPS_SIDECAR_URL=http://127.0.0.1:8789 \
STABLEOPS_SIDECAR_TOKEN=... \
npx -y -p @stableops/agent-payments-mcp-server@0.2.0 stableops-agent-payments-mcp

管理モードとランタイムモードは相互排他的です。STABLEOPS_API_KEY と STABLEOPS_AGENT_KEY の両方が設定されている場合、サーバーは起動を拒否します。ランタイムモードでは、探索、予算、プレビュー、制御付き購入、支払い調整ツールのみが公開され、ポリシーを変更したり、自身の支払いを承認することはできません。

Related MCP server: BotWallet MCP Server

セキュリティモデル

• サーバーはウォレットの秘密鍵、シードフレーズ、KMS 認証情報を受け入れたり保存したりしません。

• ーザーはサーバー外でウォレット所有権の証明に署名する必要があります。

• ランタイムの支払いは、ユーザーが操作する制約付きサイナーサイドカーのみを呼び出すことができ、任意の署名ンドポイントを呼び出すことはできません。

• 不明な発信元、不明な受信者、しきい値を超える支払いには、StableOps での人間による承認が必要です。

• 新しい購入には毎回安定した idempotency_key が必要です。不確実な決済は元の意図と照合する必要があります。

• すべての購入は、正確な URL、最大見積もり、監査コンテキストにバインドされた preview_token を使用する必要があります。購入ツールは代替 URL を受け入れません。

• プレビュートークンはプロセスローカルです。MCP 再起動後は、元の正確な URL を再度プレビューし、新しいトークンで再開します。API はインテントに保存された完全な URL ハッシュを検証します。

• 256 KiB を超える応答は、短期間有効な MCP リソースとして利用できます。すべてのインライン要約は、信頼できない外部コンテンツとしてマークされます。

ドキュメント

完全なガイドは https://stableops.dev/en/docs/agent-payments/quickstart を参照してください。

ライセンス

Apache-2.0