Clicks Protocol MCPサーバー
✓ 検証済みBaseネットワーク上での決済ルーティング、レシート検証、およびトランザクション検査をAIエージェントで実行可能にします。
別名 clicks-protocol/clicks-protocol, @clicks-protocol/mcp-server
- スター
- 2
- ツール
- 5
- ダウンロード数(30日間)
- 232
- 最新バージョン
- 1.0.3
- 最終コミット
- 2026年7月21日
- ライセンス
- MIT
Clicks Protocol MCPとは
Baseネットワーク上での決済ルーティング、レシート検証、およびトランザクション検査をAIエージェントで実行可能にします。 5個のツールを提供しており、clicks_verify_receipt, clicks_get_settlement_status, clicks_reconcile_settlementなどがあります。
プロジェクトのREADMEから生成された概要
Clicks Protocol MCP server について
このMCP serverを使用すると、AIエージェントによるBaseネットワーク上の決済管理およびトランザクション検査が可能になります。Receipt V2の整合性検証や、ウィットネスおよびリトライポリシーを含む決済ステータスの検査に特化したツールを提供します。開発者は、Baseのエビデンスを読み取り、サーバーが自動的にトランザクションを送信したりリトライしたりするリスクを負うことなく、フェイルクローズ状態を提案することで決済の照合を行うことができます。
ユーザーは、環境変数 CLICKS_RECEIPT_LEDGER_PATH を設定することで、ローカルの追記専用レジャーを構成し、receipt trail検査を有効にできます。読み取り専用のReceipt V2ツールは、秘密鍵を必要とせず、完全なレシートJSONオブジェクトを直接受け取ることで機能しますが、書き込みツールには CLICKS_PRIVATE_KEY が必要です。この要件があるため、セキュリティ境界を維持するために、書き込み権限を持つインスタンスを公開環境や信頼できないクライアントから隔離して運用することが重要です。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Clicks Protocol MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにClicks Protocol MCPをインストール
$ claude mcp add --env 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' mcp-server -- npx -y @clicks-protocol/mcp-serverCursorにClicks Protocol MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}VS CodeにClicks Protocol MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}VS Code CLIにClicks Protocol MCPをインストール
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@clicks-protocol/mcp-server"],"env":{"CLICKS_PRIVATE_KEY":"<YOUR_CLICKS_PRIVATE_KEY>"}}'Claude DesktopにClicks Protocol MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}CodexにClicks Protocol MCPをインストール
$ codex mcp add mcp-server --env 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' -- npx -y @clicks-protocol/mcp-serverCodex config.tomlにClicks Protocol MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@clicks-protocol/mcp-server"] [mcp_servers.mcp-server.env] CLICKS_PRIVATE_KEY = "<YOUR_CLICKS_PRIVATE_KEY>"
Gemini CLIにClicks Protocol MCPをインストール
$ gemini mcp add -s user -e 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' mcp-server npx -- -y @clicks-protocol/mcp-serverGemini settings.jsonにClicks Protocol MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}Clicks Protocol MCPツール 5
READMEから検出clicks_verify_receiptclicks_get_settlement_statusclicks_reconcile_settlementclicks_replay_policyclicks_get_receipt_trail
| clicks_verify_receipt | — | |
| clicks_get_settlement_status | — | |
| clicks_reconcile_settlement | — | |
| clicks_replay_policy | — | |
| clicks_get_receipt_trail | — |
設定
CLICKS_PRIVATE_KEYシークレットPrivate key for write operations (register, deposit, withdraw). Not needed for read-only tools.
CLICKS_RPC_URLBase RPC URL. Defaults to https://mainnet.base.org
| 名前 | 説明 | 種類 |
|---|---|---|
| CLICKS_PRIVATE_KEY | Private key for write operations (register, deposit, withdraw). Not needed for read-only tools. | シークレット |
| CLICKS_RPC_URL | Base RPC URL. Defaults to https://mainnet.base.org |
自動チェック
実行日 2026年11月15日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能clicks-protocol/clicks-protocol is public and reachablegithub.com/clicks-protocol/clicks-protocol ↗合格
- パッケージがこのリポジトリをソースとして指定@clicks-protocol/mcp-server names clicks-protocol/clicks-protocol as sourcenpmjs.com/package/@clicks-protocol/mcp-server ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-07-21github.com/clicks-protocol/clicks-protocol ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @clicks-protocol/mcp-server合格
- パッケージおよびその依存関係に重大な勧告なし108 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない5 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るClicks Protocol MCP Server
MCP tools for agent-commerce settlement routing and inspection on Base.
Receipt V2 read tools
clicks_verify_receipt: verifies deterministic Receipt V2 integrity.clicks_get_settlement_status: reads state, witnesses and retry policy.clicks_reconcile_settlement: reads Base evidence and proposes a fail-closed state. It never submits or retries a transaction.clicks_replay_policy: compares an exact policy definition with the policy hash bound to a receipt.clicks_get_receipt_trail: reads matching versions from a configured local append-only ledger.
Set CLICKS_RECEIPT_LEDGER_PATH to use receipt-trail inspection. The other Receipt V2 tools accept a complete receipt JSON object directly and do not require a private key.
Safety boundary
Receipt hash validity proves object integrity only. It does not prove delivery or commercial intent. Missing RPC data is treated as unknown, not as proof that no transaction was submitted. Only the SDK state failed_before_transfer, established with independent evidence, can permit a bounded retry.
Write tools still require CLICKS_PRIVATE_KEY. Keep write-enabled MCP servers isolated from public or untrusted clients.
Clicks Protocol MCPのよくある質問
Clicks Protocol MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' mcp-server -- npx -y @clicks-protocol/mcp-serverを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Clicks Protocol MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Clicks Protocol MCPが提供するツールは
5個のツールを提供しており、clicks_verify_receipt, clicks_get_settlement_status, clicks_reconcile_settlement, clicks_replay_policy, clicks_get_receipt_trailなどがあります。
すべてのツールに秘密鍵が必要ですか?
いいえ、Receipt V2ツールは完全なレシートJSONオブジェクトを直接受け取るため、秘密鍵は必要ありません。
receipt-trail検査 way はどのように使用できますか?
環境変数 CLICKS_RECEIPT_LEDGER_PATH を設定することで、receipt-trail検査を有効にできます。
レシートハッシュの安全性に関する境界は何ですか?
レシートハッシュはオブジェクトの整合性を証明するのみであり、配送や商取引の意図を保証するものではありません。
書き込みツールには認証が必要ですか?
はい、書き込みツールには CLICKS_PRIVATE_KEY が必要です。信頼できないクライアントから隔離して運用してください。