Grip MCP

Claude(또는 모든 MCP 호환 에이전트)에게 Base 기반의 비수탁형 USDC 지갑을 제공하세요. 모든 결제는 인간의 승인을 거쳐야 합니다.

소개

@grip-foundation/grip-mcp는 Model Context Protocol 서버로, MCP를 지원하는 모든 클라이언트(Claude Desktop, Claude Code, Continue 등)에 네 가지 도구를 제공합니다:

에이전트는 사용자의 승인 없이 자금을 이동하지 않습니다. 흐름은 다음과 같습니다: 에이전트가 결제 준비 → 사용자가 채팅에서 확인 → 에이전트가 정산. 프로그래밍 방식의 자동 승인은 없습니다.

Related MCP server: clawpay-mcp

설치

옵션 1 — npx 사용 (첫 배포 이후)

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows) 파일에 다음을 추가하세요:

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

옵션 2 — 로컬 클론

git clone https://github.com/grip-foundation/grip-mcp.git
cd grip-mcp
pnpm install
pnpm run build

그 후 Claude Desktop이 빌드된 파일을 가리키도록 설정하세요:

{
 "mcpServers": {
 "grip": {
 "command": "node",
 "args": ["/absolute/path/to/grip-mcp/dist/server/index.js"]
 }
 }
}

설정 파일을 수정한 후 Claude Desktop을 재시작하세요.

첫 실행

서버가 처음 시작될 때 새로운 EOA 개인 키를 생성하여 ~/.grip-mcp/agent-key(모드 0600)에 저장합니다. 이 키가 스마트 계정을 제어합니다.

Claude에게 다음과 같이 물어보세요:

내 Grip 지갑 보여줘

Claude가 grip_wallet을 호출하여 스마트 계정 주소, 잔액, 한도를 알려줄 것입니다. 해당 주소로 Base 네트워크의 USDC를 보내 자금을 충전하세요.

결제하기

자금이 충전되면 Claude에게 다음과 같이 요청하세요:

0xba14744FfD57FA7d03b20D4c8BeDAaC301E865d1 주소로 5 USDC 보내줘

Claude는 다음 과정을 수행합니다:

1. grip_create_payment를 호출하여 오프체인에서 결제를 준비합니다.

2. 세부 정보(금액, 수신자, 메모)를 보여주고 확인을 요청합니다.

3. 사용자의 답변을 기다립니다.

4. "승인"이라고 답하면 → grip_settle_payment(token, "approve")를 호출하여 Base에서 실행합니다.

5. "아니오"라고 답하면 → grip_settle_payment(token, "reject")를 호출하여 온체인 동작을 수행하지 않습니다.

정산 시 트랜잭션 해시와 Basescan 링크가 반환됩니다.

설정

보안 모델

• 비수탁형. Grip Foundation은 사용자의 키, USDC, 결제 기록을 보관하지 않습니다. 모든 것은 사용자의 기기에서 실행됩니다.

• 관리형 페이마스터, 가입 불필요. 가스비는 Grip의 호스팅 프록시를 통해 라우팅되는 Pimlico 페이마스터를 사용하여 USDC로 지불됩니다. 별도의 Pimlico 계정은 필요하지 않습니다.

• 인간의 개입은 모델이 아닌 프로토콜에 의해 강제됩니다. grip_create_payment는 준비만 수행합니다. grip_settle_payment는 별도의 도구 호출입니다. 대부분의 MCP 클라이언트(Claude Desktop 포함)는 도구 호출을 실행하기 전에 인간의 확인을 요구하므로, 이것이 두 번째 보안 계층 역할을 합니다.

• 한도는 서버 측에서 강제됩니다. 모델이 일일 한도나 건당 한도를 초과하는 결제를 시도하더라도 서버에서 거부합니다.

아키텍처

Claude Desktop
 │ MCP (stdio)
 ▼
grip-mcp (this server)
 │ @grip-labs/sdk
 ▼
Grip-managed paymaster proxy → Pimlico bundler → Base mainnet
 ▲
 Coinbase Smart Wallet
 (your smart account)

스마트 계정은 Base의 Coinbase Smart Wallet(ERC-4337)입니다. 새 지갑에서의 첫 결제는 계정을 배포하고 USDC 상환을 위해 페이마스터를 승인하는 일회성 부트스트랩 UserOp를 실행하며, 이후의 UserOp는 USDC로 지불됩니다.

알려진 문제

첫 결제 시 재시도가 필요할 수 있습니다. @grip-labs/sdk@0.4 버전에서는 부트스트랩 UserOp(배포 + 페이마스터 승인)와 실제 전송 UserOp가 두 개의 별도 작업으로 제출됩니다. 부트스트랩이 Pimlico 번들러에서 정산된 후 viem의 내부 getFactoryArgs()가 공용 RPC에서 오래된 getCode를 읽어오는 짧은 경쟁 상태(race window)가 존재합니다. 이 경우 viem이 두 번째 UserOp에 initCode를 포함하게 되어 번들러가 AA10 sender already constructed 오류로 거부합니다.

첫 결제가 해당 오류로 실패하면 에이전트에게 다시 시도해달라고 요청하세요. 온체인 상태가 전파된 후에는 재시도가 성공합니다. 동일한 지갑에서의 이후 결제는 정상적으로 작동하며, 부트스트랩은 지갑당 최대 한 번만 실행됩니다.

@grip-labs/sdk@0.5에서 부트스트랩과 첫 전송을 executeBatch를 사용하여 단일 스폰서 UserOp로 통합하는 수정 사항이 배포될 예정입니다. 이를 통해 경쟁 상태를 원천적으로 제거하고 첫 결제 시 가스비를 약 30% 절감할 수 있습니다. grip-mcp는 0.1.1 버전에서 이를 반영할 예정입니다.

라이선스

MIT

제작

Grip Foundation · AI 에이전트를 위한 개방형 신원 및 결제 레일.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• grip_create_paymentA
• grip_list_paymentsA
• grip_settle_paymentA
• grip_walletA