clawvault-mcp-server

clawvault-mcp-server

ClawVault 向けの MCP（Model Context Protocol）サーバー — AI エージェントの決済セキュリティレイヤーです。

インストール

npm install -g clawvault-mcp-server

または、npx を使って直接実行できます（インストール不要です）。

npx clawvault-mcp-server

Claude Desktop での使用方法

Claude Desktop の設定に追加します。

Mac： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "clawvault": {
      "command": "npx",
      "args": ["clawvault-mcp-server"],
      "env": {
        "CLAWVAULT_API_KEY": "cv_live_your_api_key_here"
      }
    }
  }
}

保存後、Claude Desktop を再起動してください。

API キーの取得方法

1. clawvault.cc にアクセスして、アカウントを登録します
2. Agents ページに移動します
3. 新しいエージェントを作成するか、既存のものを使用します
4. API キーをコピーします（形式：cv_live_...）

利用可能なツール

接続すると、Claude は次のツールを使用できます。

request_payment

ClawVault 経由で決済をリクエストします。決済はセキュリティルールに照らして評価されます。

Amount: "10.00"
Token: "USDC"
Recipient: "0x..."
Chain: "base"
Reason: "API credits" (optional)

check_limits

決済を実行する前に、許可されるかどうかを確認します。自動承認されるか、手動承認が必要かを返します。

get_payment_status

ID を指定して、保留中の決済のステータスを確認します。

list_transactions

ページネーションを使用して、最近の決済トランザクションを一覧表示します。

get_vault

ウォレットアドレス、残高、現在の支出上限など、Vault のステータスを取得します。

freeze_agent

エージェントを緊急凍結して、そのエージェントからの決済リクエストをすべてブロックします。

動作の仕組み

1. Claude に何かの支払いを依頼します
2. Claude が request_payment ツールを使用します
3. ClawVault がルールを確認します。
   • ルールの範囲内 → 自動承認され、決済が実行されます
   • ルールの範囲外 → 保留になり、Telegram またはダッシュボードに通知が届きます
4. Telegram またはウェブダッシュボードから承認または拒否します
5. Claude が結果を受け取ります

環境変数

変数	必須	デフォルト	説明
CLAWVAULT_API_KEY	はい	-	ClawVault API キー
CLAWVAULT_API_URL	いいえ	https://api.clawvault.cc	API のベース URL

その他の AI エージェントでの使用

Claude Desktop を使用していませんか？スキルのドキュメントを読み込めば、どの AI エージェントでも ClawVault を使用できます。

https://api.clawvault.cc/skill

エージェントに ClawVault API の使用方法を説明するプレーンテキストが返されます。

開発

# Clone the repo
git clone https://github.com/clawvault/mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally
CLAWVAULT_API_KEY=cv_live_xxx npm start

リンク

• ウェブサイト：clawvault.cc
• ドキュメント：clawvault.cc/docs
• API：api.clawvault.cc
• スキルのドキュメント：api.clawvault.cc/skill

ライセンス

MIT