Nagora

Nagora MCP サーバー

P2P マーケットプレイスの公式 MCP サーバーです。nagora.shop では、すべての決済が Nano（XNO）で行われます。

Claude Desktop、Claude Code、または独自のエージェント実行環境など、あらゆる MCP クライアントに、出品の検索、エスクローで保護された購入の実行、注文の追跡、署名済み領収書の取得に使えるツールを提供します。AI アシスタントが代わりに買い物をでき、エスクローがその間の安全を守ります。資金は注文ごとの Nano アカウントに保管され、配達が確認された後にのみ販売者へ送金されます。

ツール

ツール	認証	機能
search_listings	なし	販売中の出品を全文検索します
get_listing	なし	バリエーション、配送オプション、Nano 価格を含む出品の詳細を取得します
register_agent	なし	アカウント不要で、エージェントと API キーを一度の呼び出しで作成します。キーはローカルに保存されます
whoami	API キー	キーを検証し、支出上限と Webhook シークレットを確認します
create_purchase	API キー	注文を行い、エスクロー入金先アドレスと金額を返します
get_order	API キー	注文とエスクローのステータス、追跡情報、領収書 ID を確認します
confirm_delivery	API キー	商品の到着を確認し、販売者にエスクローを解放します
cancel_order	API キー	まだ入金されていない注文をキャンセルします
get_receipt	API キー	オンチェーン送金ブロックを含む、KMS 署名済み領収書を取得します

セットアップ

インストール不要の代替手段： Nagora は、同じツールをリモート MCP サーバーとしても提供しています。 claude mcp add --transport http nagora https://api.nagora.shop/mcp を実行すれば完了です。 ただし、ホスト型サーバーはキーをローカルに保存できないため、register_agent はキーを一度だけ返します。キーは apiKey ツール引数として渡すか、 --header "Authorization: Bearer nag_agt_..." で固定してください。このローカルパッケージなら、 代わりにキーを ~/.nagora/credentials.json に保存できます。

Claude Code

claude mcp add nagora -- npx -y @nagora/mcp

Claude Desktop

claude_desktop_config.json 内：

{
  "mcpServers": {
    "nagora": {
      "command": "npx",
      "args": ["-y", "@nagora/mcp"]
    }
  }
}

ソースから（npx の代わりに）

cd nagora-mcp
npm install
npm run build
claude mcp add nagora -- node /path/to/nagora-mcp/dist/index.js

エージェント自身に登録させる

これでセットアップは完了です。Nagora アカウントも、コピーするキーも必要ありません。アシスタントが初めて何かを購入する際、名前と返金用 Nano アドレスを指定して register_agent を呼び出します。API キーは一度だけ返され、~/.nagora/credentials.json に（モード 600 で）保存されます。以降、ほかのすべてのツールが自動的にこのキーを使用します。

自己登録したキーには、保守的なデフォルトの支出上限（現在は 1 回の取引につき 25 XNO、1 日につき 100 XNO）が設定され、サーバー側で適用されます。より高い上限、複数のキー、またはダッシュボードが必要な場合は、nagora.shop でアカウントを作成し、Settings → Agents からエージェントを管理してください。そこで作成したキーも、NAGORA_API_KEY を通じて同じように使用できます。

設定

変数	デフォルト	説明
NAGORA_API_KEY	未設定	オプションです。register_agent で保存した認証情報を上書きします
NAGORA_API_URL	https://api.nagora.shop	ローカル開発環境では http://localhost:5004 を指定します

購入の流れ

1. search_listings / get_listing：商品を見つけ、Nano の合計額を確認します。
2. create_purchase：注文を作成します。応答には depositAddress（Nano ネットワーク上の注文ごとのエスクロー口座）と amountNano が含まれます。
3. エスクローに入金する：エージェント自身の Nano ウォレットから、amountNano とまったく同じ額を depositAddress に送金します。このサーバーは意図的に秘密鍵を保持せず、資金を移動しません。xno-mcp などのウォレットツールと組み合わせるか、手動で入金してください。Nano の送金は手数料がかからず、1 秒未満で決済されます。
4. 資金が着金すると、注文は自動的に AwaitingShipment に移行します。販売者が商品を発送し、追跡情報を追加します。
5. get_order（または後述のウェブフック）で Shipped への移行を確認します。
6. 商品が届いたら confirm_delivery を実行します。エスクローから販売者へ、オンチェーンで資金が送金されます。
7. get_receipt：支払いブロックのハッシュを含む、取引全体について署名された独立検証可能な証明書を取得します。

販売者が発送しない場合は、エスクローの自動キャンセルタイマーによって購入者に返金されます。注文に問題がある場合は、ウェブサイトから異議申し立てを行ってください。担当者が確認します。

ウェブフック（任意）

get_order をポーリングする代わりに、エージェントに callbackUrl を登録します（Settings → Agents）。Nagora はすべてのウェブフックに HMAC-SHA256 で署名します。HMAC-SHA256("{X-Nagora-Timestamp}.{raw_body}", webhookSecret) を計算し、X-Nagora-Signature: sha256=<hex> と照合してください。webhookSecret は whoami から取得できます。

イベント：注文の進行に応じて、order.funded、order.shipped などが発生します。

安全性モデル

• サーバーはステートレスで、鍵を保持しません。Nano を送金することはできず、注文をリクエストするだけです。その注文に入金するかどうかは、ユーザーが決めます。
• API キーごとに、サーバー側で支出上限が適用されます。エージェントが制御不能になっても、発生するのは 429 エラーであり、ウォレットの資金が使われることはありません。
• エスクローにより、エージェントのミスから回復できます。未入金の注文はキャンセル可能で、入金済みの注文は配達を確認するまで保護されます。
• Settings → Agents からいつでもキーを無効にできます。無効化は 60 秒以内に反映されます。