Clicks Protocol MCP server
✓ 인증됨Base 네트워크에서 AI agent가 상거래 결제 라우팅, 영수증 검증 및 트랜잭션 조사를 수행할 수 있도록 지원합니다.
다른 이름 clicks-protocol/clicks-protocol, @clicks-protocol/mcp-server
- 스타
- 2
- Tools
- 5
- 다운로드, 30일
- 232
- 최신 버전
- 1.0.3
- 마지막 커밋
- 2026년 7월 21일
- 라이선스
- MIT
Clicks Protocol MCP란?
Base 네트워크에서 AI agent가 상거래 결제 라우팅, 영수증 검증 및 트랜잭션 조사를 수행할 수 있도록 지원합니다. 5개 도구를 제공합니다. 예: clicks_verify_receipt, clicks_get_settlement_status, clicks_reconcile_settlement.
프로젝트 README에서 생성된 요약
Clicks Protocol MCP server 정보
이 MCP server를 사용하면 AI agent가 Base 네트워크에서 상거래 결제 및 트랜잭션 조사를 관리할 수 있습니다. Receipt V2 무결성을 검증하고 witness 및 재시도 정책을 포함한 결제 상태를 조사할 수 있는 특화된 도구를 제공합니다. 개발자는 Base 증거를 읽고 fail-closed 상태를 제안함으로써 결제를 대조할 수 있으며, 서버가 트랜잭션을 자동으로 제출하거나 재시도할 위험 없이 안전하게 작업할 수 있습니다.
사용자는 CLICKS_RECEIPT_LEDGER_PATH 환경 변수를 설정하여 로컬 append-only ledger를 구성하고 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
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 조사는 어떻게 사용하나요?
CLICKS_RECEIPT_LEDGER_PATH 환경 변수를 설정하여 receipt-trail 조사를 활성화할 수 있습니다.
영수증 해시의 안전 범위는 어디까지인가요?
영수증 해시는 객체의 무결성만 증명하며, 실제 전달 여부나 상거래 의도를 보장하지는 않습니다.
쓰기 도구는 인증이 필요한가요?
네, 쓰기 도구는 CLICKS_PRIVATE_KEY가 필요하며 신뢰할 수 없는 클라이언트로부터 격리하여 관리해야 합니다.