consentgate-mcp

consentgate-mcp

あらゆるMCP対応エージェント（Claude Desktop、Claude Code、Cursor、カスタムエージェントなど）が、ConsentGateを通じて、人間の同意ポリシーに基づき、自身のアクションを制御できるModel Context Protocolサーバーです。

エージェントはアクションを実行する前に確認します。主導権はあなたにあります。重要度の高いアクションでは、Telegramに届く明示的な承認／拒否のタップがあるまで処理を保留できます。

ツール

ツール	ブロックする？	内容
check_action	いいえ	アクションをあなたの同意ルールに照らして評価します。allow、deny、またはask（該当するルールなし）を返します。機密性の高いアクションや取り消せないアクションの前に使用してください。
request_approval	はい（≤120s）	Telegramに承認／拒否のプロンプトを送信し、あなたがタップするかタイムアウトするまで処理をブロックします。人間が明示的に承認した場合にのみallowを返し、それ以外（拒否、タイムアウト、利用不可）はすべてdenyになります。

どちらのツールもフェイルクローズです。明示的なallow以外は、すべて「続行しない」ことを意味します。

前提条件

1. ConsentGateアカウントとAPIキー → **https://consentgate.fyi/dashboard/keys**（`cg_…`）。
2. request_approval（対話型の承認）には、ProプランとTelegramアカウントの連携が必要です（Dashboard → Telegram → Connect）。check_actionはすべてのプランで利用できます。

設定

環境変数：

変数	必須	デフォルト	備考
CONSENTGATE_API_KEY	✅	—	あなたのcg_…キーです。
CONSENTGATE_BASE_URL	—	https://consentgate.fyi	セルフホストインスタンスの場合に上書きします。

Claude Desktop

claude_desktop_config.jsonに追加します（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "consentgate": {
      "command": "npx",
      "args": ["-y", "consentgate-mcp"],
      "env": { "CONSENTGATE_API_KEY": "cg_your_key_here" }
    }
  }
}

Claude Code

claude mcp add consentgate --env CONSENTGATE_API_KEY=cg_your_key_here -- npx -y consentgate-mcp

汎用MCPクライアント

環境にCONSENTGATE_API_KEYを設定し、npx -y consentgate-mcp（stdioトランスポート）を実行します。

ソースから実行

npmにパッケージが公開されるまでは、クライアントの接続先にnpx consentgate-mcpではなく、ビルド済みファイル（node /abs/path/to/mcp/dist/index.js）を指定してください。

cd mcp
npm install        # also builds via the `prepare` script
npm run build      # -> dist/index.js
CONSENTGATE_API_KEY=cg_… npm run smoke   # lists tools + a live check_action

エージェントでの使い方

適切なエージェントポリシーの例：

メッセージの送信、金銭の使用、データの削除、公開投稿、外部状態の変更を伴うアクションを実行する前に、check_actionを呼び出してください。結果がallowなら続行します。denyなら停止します。askの場合（またはアクションの重要度が高い場合）は、request_approvalを呼び出し、明示的にallowが返された場合にのみ続行します。

例（request_approval）：

{
  "action": "transfer_funds",
  "category": "spending",
  "metadata": { "amount": "$500", "to": "Acme Corp" },
  "wait_seconds": 90
}
// -> blocks; you tap Approve in Telegram -> { "decision": "allow", "resolved_by": "human" }

ライセンス

MIT