SAP MCP Server

SAP MCP サーバー

OOBE Synapse Agent Protocol、Solana、Synapse AgentKit、SNS、収益化されたホスト型エージェントワークフロー向けの、本番環境を想定した Model Context Protocol サーバーです。

SAP MCP は、同じ型付きツールレジストリを、サポートされている次の 2 種類の MCP 起動モードで公開します。

1. デスクトップエージェントとローカル開発向けのローカル stdio。
2. ホスト型の顧客とオーケストレーター向けの、/mcp でのリモート Streamable HTTP。

また、プロフェッショナルなセットアップウィザード、~/.config/mcp-sap 配下でのプロファイル管理設定、任意の Bento ポリシー連携、ローカルおよび外部の署名モード、x402 による収益化、セルフホスト可能な OOBE ファシリテーター、pay.sh プロバイダー YAML の生成、A2A 互換の検出カードも含まれています。

ユーザー向けセットアップドキュメントは USER_DOCS/ にあります。運用担当者向けおよびエンジニアリング向けドキュメントは docs/ にあります。

1. ステータス

項目	現在の動作
パッケージバージョン	0.9.85
MCP トランスポート	ローカルでは stdio、リモートでは Streamable HTTP
リモートアクセス	ホスト型エージェント向けのベアラーレス公開モード、プライベートモード向けの API キーまたは JWT
設定ディレクトリ	~/.config/mcp-sap のみ
エージェントウォレット	デフォルトでは ~/.config/mcp-sap/keypairs/ 配下の専用ウォレットパス
Solana CLI キーペア	ウィザードによって変更されません
ポリシー	デフォルトではローカルポリシー、任意で Bento またはハイブリッドポリシー
収益化	ツールごとの価格設定を備えた、任意のリモート専用 x402/pay.sh 決済フロー
署名	プロファイルモードに応じて、ローカルの専用ウォレットまたは外部署名者を使用
検出	/.well-known/agent-card.json にある A2A 互換カード

2. インストール

前提条件：

node --version   # >= 22.12.0
corepack enable
corepack prepare [email protected] --activate
pnpm --version   # 11.7.0

ソースからインストールする場合：

pnpm install
pnpm run build

ソースからデプロイする場合は、npm install を使用しないでください。このリポジトリは pnpm でロックされ、検証されています。

公開済みパッケージからインストールする場合：

npm install -g @oobe-protocol-labs/sap-mcp-server

3. クイックスタート

プロファイルを作成または選択します。

npx sap-mcp-config wizard

プロファイルを再作成せずに、ホスト型 SAP MCP のランタイムエントリーを修復します。

npx sap-mcp-config repair

エージェントランタイムでホスト型 SAP MCP に接続したら、短いメッセージを 1 つ送ってエージェントのコンテキストを開始します。

Start SAP MCP.

エージェントは、無料の sap_agent_start ツールまたは sap-agent-start プロンプトを呼び出し、sap_skills_bundle を読み込み、有料または書き込みを伴うホスト型呼び出しにはローカルの sap_payments ブリッジを使用してください。

アクティブなプロファイルを確認します。

npx sap-mcp-config show
npx sap-mcp-config doctor
npx sap-mcp-config pubkey
npx sap-mcp-config profiles

ローカル stdio MCP を起動します。

sap-mcp-server

または、ソースから起動します。

node dist/cli.js

ホスト型の顧客はエージェントを https://mcp.sap.oobeprotocol.ai/mcp に接続しますが、署名は引き続きユーザーが管理します。ほとんどのユーザーに推奨されるセットアップは、ウィザードで管理する次の 2 つの MCP エントリーです。

• sap：https://mcp.sap.oobeprotocol.ai/mcp にある、ホスト型の Streamable HTTP SAP MCP。
• sap_payments：x402/pay.sh の有料または書き込みを伴う呼び出し向けの、ローカルの非カストディアル決済ブリッジ。

x402/pay.sh の料金を支払う、SAP ID を登録または運用する、あるいは価値を移転する Solana/SAP ツールを実行するユーザーは、まずウィザードを実行し、専用ウォレットを ~/.config/mcp-sap/keypairs/ 配下に置くか、外部署名者の背後に保管してください。読み取り専用のホスト型検出では、ローカル署名者なしでリモート URL を使用できます。

4. ローカルクライアントの設定

ローカルエージェントでは、ウォレットパスや古い RPC の上書きをハードコードせず、アクティブなプロファイルマネージャーに SAP MCP を連動させます。

{
  "mcpServers": {
    "sap": {
      "command": "sap-mcp-server",
      "env": {
        "SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE": "false",
        "SAP_LOG_LEVEL": "info"
      }
    }
  }
}

Codex は JSON の mcpServers 形式ではなく、TOML を使用します。ホスト型のリモート MCP では、これを ~/.codex/config.toml に追加して Codex を再起動します。

[mcp_servers.sap]
url = "https://mcp.sap.oobeprotocol.ai/mcp"

有料または書き込みを伴うホスト型ツールでは、ローカルの非カストディアル決済ブリッジも追加します。

[mcp_servers.sap_payments]
command = "npx"
args = ["--yes", "--package", "@oobe-protocol-labs/[email protected]", "sap-mcp-server"]
startup_timeout_sec = 300
tool_timeout_sec = 300

[mcp_servers.sap_payments.env]
SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE = "false"
SAP_MCP_PAYMENTS_BRIDGE_ONLY = "true"
SAP_ALLOWED_TOOLS = "all"
SAP_LOG_LEVEL = "info"

Windows では、command = "npx.cmd" を使用してください。ウィザードで自動的に書き込むこともできます。

Codex は config.toml 内の URL ベースのエントリーで Streamable HTTP MCP サーバーをサポートしています。Codex にローカル SAP MCP プロセスを起動させたい場合に限り、npx を使ったローカル stdio を使用してください。

[mcp_servers.sap]
command = "npx"
args = ["--yes", "--package", "@oobe-protocol-labs/[email protected]", "sap-mcp-server"]

[mcp_servers.sap.env]
SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE = "false"
SAP_LOG_LEVEL = "info"

Windows では、command = "npx.cmd" を使用してください。

04. ローカル Stdio MCP 運用手順を参照してください。

5. リモートサーバー

リモートデプロイでは、Streamable HTTP 経由で MCP を公開します。

node dist/remote/server.js

本番環境の値は、公開ドキュメントではなく、プライベートなシークレットストアまたはプライベートなデプロイファイルから取得してください。x402、レート制限、ポリシーが有効な場合、ホスト型の公開エージェント向けデプロイでは SAP_MCP_AUTH_TYPE=none を使用できます。プライベートベータ、エンタープライズ、管理者向けデプロイでは、API キーまたは JWT 認証も引き続き利用できます。

リモートエンドポイント：

GET     /
GET     /docs
GET     /server.json
GET     /favicon.png
GET     /favicon.ico
GET     /health
GET     /openapi.json
GET     /.well-known/x402
GET     /pay/provider.yml
GET     /.well-known/agent-card.json
GET     /.well-known/sap-mcp-wizard.json
GET     /.well-known/sap-mcp-tool-catalog.json
GET     /tool-catalog.json
GET     /wizard/install.sh
POST    /mcp
GET     /mcp
DELETE  /mcp

GET / は、Open Graph／Twitter メタデータを含む、公開され共有しても安全なランディングページです。公開サーバー情報のみを公開し、キーペアのバイト列、プライベートウォレットのパス、RPC クエリのシークレット、VPS 内のローカルパスは決して表示してはいけません。

GET /docs は、インストール、起動、設定、ホスト型リモート MCP、x402／pay.sh による支払い、MCP クライアントのセットアップに関する公開ドキュメントサイトを提供します。

Smithery などのマーケットプレイスの掲載情報では、ホスト型セットアップ手順の説明に smithery.config.schema.json を使用できます。このスキーマではシークレットを要求しません。SAP MCP のホスト型読み取りはリモートで実行され、有料／書き込み呼び出しでは、ウィザード管理のローカル sap_payments ブリッジ、ローカルプロファイルポリシー、ユーザーが制御する署名者を使用します。

05. ホスト型 Streamable HTTP のデプロイ および 07. HTTP エンドポイント、MCP クライアント、スモークテストを参照してください。

6. 収益化

ホスト型 HTTP デプロイでは、有料の tools/call リクエストに支払いを必須としつつ、ローカルの stdio と基本的な MCP プロトコル呼び出しを無料のままにできます。

初期モデル：

ティア	例	価格
無料	tools/list、prompts/list、resources/list、ブートストラップ／ステータス／修復、コスト見積もり、ローカル支払いブリッジの制御、SOL／SPL／x402 残高の準備状況、単一アセットの価格スナップショット、メモリ／監査、トランザクションのプレビュー／確定ヘルパー	無料
マイクロ読み取り	正確なエージェント／プロファイルの読み取り、コンパクトなディレクトリページ、SNS の利用可否、エスクローの状態、軽量なトレーダーコンテキスト	$0.001
プレミアム読み取り	広範な検索、拡充された保有情報／DAS、トークンリスト、見積もり／ルート、履歴／OHLCV、分析、大きなページ	$0.002
ビルダーまたはバッチ	複雑なビルダー、SNS／ドメインのバッチ確認、未署名トランザクションビルダー、ルーティングの準備	$0.006、バッチ＝有料呼び出しの合計
価値アクション	価値に連動する選択された操作	標準は一律 $0.06、選択された負荷の高い処理パスは $0.035、さらにオプションで bps

x402 を有効にするには：

SAP_MCP_MONETIZATION_ENABLED=true
SAP_MCP_MONETIZATION_PROVIDER=x402
SAP_MCP_MONETIZATION_PAY_TO=YOUR_SOLANA_USDC_RECIPIENT
SAP_MCP_X402_FACILITATOR_URL=YOUR_PRIVATE_OR_HOSTED_FACILITATOR_URL

OOBE ファシリテーターを初期化して実行します：

npx sap-mcp-facilitator init
npx sap-mcp-facilitator start

pay.sh プロバイダー YAML を生成します：

ホスト型の公開カタログは https://mcp.sap.oobeprotocol.ai/pay/provider.yml で利用できます。 これはシークレットを含まず、pay.sh のカタログ／プロキシ検出を目的としています。

npx sap-mcp-pay-sh-spec \
  --out sap-mcp-pay-sh.yml \
  --upstream-url https://mcp.sap.oobeprotocol.ai \
  --network mainnet \
  --recipient YOUR_SOLANA_USDC_RECIPIENT

06. x402／pay.sh の収益化と決済を参照してください。

x402 チャレンジをネイティブに再送できないローカルエージェントランタイムでは、ウィザードのローカル sap_payments ブリッジをインストールし、sap_payments_call_paid_tool を呼び出してください。従来の CLI ヘルパーも、ターミナルで引き続き利用できます：

npm exec --yes --package @oobe-protocol-labs/sap-mcp-server -- sap-mcp-x402-paid-call \
  --tool sap_list_all_agents \
  --arguments '{"limit":5}' \
  --max-usd 0.02 \
  --confirm

このヘルパーは、ユーザーのローカル SAP MCP プロファイルで支払いペイロードに署名し、キーペアのバイト列をホストサーバーに送信することはありません。

7. コマンド

pnpm run typecheck
pnpm run lint
pnpm test -- --run
pnpm run build
pnpm run verify:release

インストールされるバイナリ：

コマンド	用途
sap-mcp-server	ローカル stdio MCP サーバーおよび CLI エントリーポイント
sap-mcp-remote	ベアラートークンなし、API キー、JWT の各モードに対応するリモート MCP サーバー
sap-mcp-config	設定 CLI、プロファイルマネージャー、承認ワークフロー、ウィザード
sap-mcp-wizard	TUI 設定ウィザード
sap-signing-proxy	ローカル署名プロキシ
sap-mcp-facilitator	セルフホスト可能な x402 SVM ファシリテーター
sap-mcp-pay-sh-spec	pay.sh プロバイダー YAML ジェネレーター
sap-mcp-x402-paid-call	ホスト型 x402 有料 MCP ツール向けの、従来のターミナル／カスタムラッパー用フォールバック

8. ドキュメント

まず、00. エンジニアリングドキュメント索引を確認してください。

ドキュメント	目的
01. 製品スコープとデプロイモデル	製品モデル、ユーザー、パブリック／プライベートリポジトリのガイダンス、ウィザードの配布について説明します。
02. ランタイムアーキテクチャと信頼境界	ランタイムモジュール、ローカルフロー、リモートフロー、署名、決済、信頼境界について説明します。
03. プロファイル設定ウィザードの注入	プロファイルマネージャー、ウィザード、ウォレットの分離、クライアントへの注入、設定 CLI について説明します。
04. ローカル Stdio MCP 運用手順書	Claude、Hermes、Codex、OpenClaw、開発エージェント向けのローカル設定について説明します。
05. ホスト型 Streamable HTTP のデプロイ	ホスト型デプロイ、リバースプロキシ、PM2、顧客のオンボーディングについて説明します。
06. x402/pay.sh の収益化と決済	価格設定、x402 ゲート、pay.sh プロバイダー YAML、ファシリテーター署名者、決済について説明します。
07. HTTP エンドポイント、MCP クライアント、スモークテスト	HTTP エンドポイント、ヘッダー、スモークテスト、クライアントの例について説明します。
08. セキュリティポリシーと署名の運用手順書	鍵素材のルール、署名者モード、Bento ポリシー、トランザクションの安全性について説明します。
09. ツール、スキル、ルーティング、エージェントの運用	ツールファミリー、SDK ドキュメントへの参照、スキル、エージェントの動作について説明します。
10. リリース運用と PM2 の運用手順書	品質ゲート、PM2、シークレット、リリースパッケージ、変更履歴の管理について説明します。
11. エンジニアリング品質監査レポート	現在のエンジニアリング評価表、リリースゲート、品質ルール、残存リスクについて説明します。
12. 署名付きエージェントチャットプロトコル	テーマ別の署名付きグループチャット、ルームマニフェスト、検索、リンク共有、プライバシー境界、SDK ロードマップについて説明します。
13. バウンティプログラム技術仕様	パートナー向けバウンティの範囲、審査基準、技術要件について説明します。
14. デスクトップウィザードのリリース成果物	ネイティブウィザードのパッケージ化、署名、チェックサム、リリース成果物について説明します。
15. デモダッシュボードの画面共有運用手順書	ホスト型ランディングページ、ダッシュボード、ウィザード、決済画面のデモフローについて説明します。
16. エージェント ID レジストリのパイプライン	レジストリの情報源、エンリッチメント、検証、表示のパイプラインについて説明します。
18. プレミアムプラグインのランタイム契約	プレミアムプラグインのマニフェスト契約、プロバイダーの準備状況、ストリーム、Webhook について説明します。
19. エージェント標準の相互運用性	MCP、A2A、マーケットプレイス、x402/pay.sh、ランタイムの連携について説明します。
20. エンジニアリング運用モデルの境界	ブランチの所有権、サービス契約、リリース担当者、企業水準のゲートについて説明します。

9. リポジトリの構成

このリポジトリはモジュール型のモノレポです。実際のソースコードは packages/*/src/ にあります。対応する src/ ディレクトリは、既存のインポートパスを維持する薄い互換性ラッパー（export * from '../../packages/...'）です。

packages/
  core/              Shared runtime types, errors, logger, constants, guards, result
  config-runtime/    Runtime config, secure config manager, setup wizard, runtime doctor, client injection
  server-runtime/    MCP server factory, capability registration, server metadata
  hosted-gateway/    Streamable HTTP MCP server, public home, premium routes, rate limiter, tx relay
  local-bridge/      Local stdio MCP bridge, payment bridge process diagnostics
  mcp-adapter/       Model Context Protocol adapter compatibility layer
  schemas/           Public Zod schemas and protocol contracts
  tools/             SAP, Solana, AgentKit, SNS, profile, skill, chat, payment, perps, and premium tools
  ui-cards/          MCP Apps Card rendering, card builder, templates, protocol logos
  wizard-core/       Shared CLI and desktop wizard flow
  tool-plugin-template/  Trusted external tool-family plugin template
  adapters/          Solana connection and public key adapter utilities
  bin/               npx-safe bootstrap entrypoints for remote and local servers
  memory/            Agent memory store, tool call store, stream buffer, Hermes bridge
  observability/     Metrics collection and exporter
  perps/             Perpetual futures analytics, Adrena builders, chart indicators, risk engine
  payments/          x402 monetization, facilitator, usage ledger, pay.sh spec, pricing
  policy/            Local, Bento, and hybrid policy engines, spending limits, permission checks
  premium/           Premium runtime plugins, streams, webhooks, session management
  prompts/           MCP prompt templates for developer, payments, context, execution-proof, registry
  resources/         MCP resource templates for memory, execution-proof, reputation, profile, registry, stats
  runtime/           Module resolution and payment bridge process management
  sap/               SAP SDK client manager, types, and error classes
  security/          Private-key guard, tool permissions, prompt injection notes, approval gates
  session/           Session store, delegated sessions, agent sessions, session limits
  signer/            Local, delegated, and external signer adapters, wallet guard, policy-enforcing wallet
  solana/            Solana ATA utilities
  strategies/        Strategy store and trade journal
  transports/        stdio and HTTP transport layers
  tui/               Terminal UI wizard save helper (legacy, source in src/tui/)

ルートの package.json はすべてのパッケージの公開インターフェースを再エクスポートするため、利用者は内部パッケージを直接参照せずに @oobe-protocol-labs/sap-mcp-server からインポートできます。

10. ライセンス

SAP MCP Server は MIT License の下で公開されています。

11. パートナー製品

パートナー／製品	連携
@bentoguard / Bento Guard	AI による意図スコアリング、エスカレーション、ローカルと Bento のハイブリッドなガードレールに対応するオプションのポリシーレイヤーです。オプションの @bentoguard/sdk パッケージと、app.bentoguard.xyz の認証情報を使用します。