주 콘텐츠로 건너뛰기
MCP 서버

모든 MCP 클라이언트를 위한 에이전트 지갑 도구.

공식 Blockchain0x MCP server는 MCP를 인식하는 에이전트에게 지갑 조회, Base에서 USDC 전송, 인보이스 정산 기능을 제공합니다. hosted endpoint에 연결하거나 한 번의 명령으로 로컬에서 실행하세요.

https://mcp.blockchain0x.com/mcp
무엇인가

하나의 서버. 다섯 가지 도구. 모든 MCP 클라이언트.

Model Context Protocol은 AI 클라이언트 - Claude Desktop, Cursor, Cline 및 기타 도구 - 가 외부 도구를 호출하는 표준 방식입니다. Blockchain0x MCP server는 이 표준을 통해 에이전트 지갑을 노출하므로, 어떤 MCP 클라이언트라도 별도의 커스텀 통합 없이 자금을 이동할 수 있습니다.

이 서버는 Blockchain0x API 위에 얹힌 얇은 무상태 프록시입니다. 자금이나 데이터베이스를 보관하지 않으며, 사용자가 제공한 키를 사용해 각 도구 호출을 API로 전달합니다. 또한 각 agent의 spend permission이 여전히 도구가 수행할 수 있는 범위를 제한합니다.

도구

agent가 호출할 수 있는 항목입니다.

get_wallet

한 에이전트의 지갑을 읽습니다: 주소, Base의 USDC 잔액, 메타데이터.

list_wallets

작업공간의 에이전트 지갑을 나열하세요.

get_transaction

거래를 id로 조회하고 온체인 상태를 확인하세요.

send_payment

Base의 에이전트 지갑에서 지출 권한 범위 내에서 USDC를 전송하세요.

settle_payment_request

대시보드에서 생성한 결제 요청을 온체인 증명과 함께 정산하세요.

사용 방법

연결하는 두 가지 방법.

1. 호스팅됨 (Streamable HTTP)

MCP 클라이언트를 hosted endpoint로 연결하고 API key를 Bearer header로 전달하세요. 설치할 것은 없습니다.

MCP 클라이언트 설정 (호스티드)
{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

2. 로컬 (stdio, via npx)

npx @blockchain0x/mcp로 서버를 직접 실행하세요. 키는 사용자 환경에 유지되며 기기를 벗어나지 않습니다.

MCP 클라이언트 설정 (STDIO)
{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["@blockchain0x/mcp"],
      "env": { "BLOCKCHAIN0X_API_KEY": "sk_live_..." }
    }
  }
}

Base Sepolia에서 sk_test_ 키로 시작한 다음 sk_live_로 전환하세요. 전체 설정은 the docs에 있으며, 여러분의 MCP 도구에 가격을 매기려면 MCP integration recipe를 참고하세요.

보안

spend permission은 여전히 적용됩니다.

  • 이 서버는 사용자 자금이나 키를 절대 보관하지 않으며, 각 호출을 Blockchain0x API로 전달합니다.
  • send_payment는 정산되기 전에 agent의 거래당 한도와 기간별 허용 한도와 비교 검증되며, 다른 API 호출과 동일하게 처리됩니다.
  • 지갑과 거래만 읽어야 하는 agent에는 read-only key(no pay scope)를 사용하세요.
  • stdio에서는 키가 로컬 환경에 그대로 유지됩니다. hosted에서는 TLS를 통해 Bearer header로 전송되며 저장되지 않습니다.
자주 묻는 질문

MCP 서버에 대한 세 가지 질문.

MCP 서버는 어디에서 실행되며, 제 키를 볼 수 있나요?

실행하는 두 가지 방법이 있습니다. Hosted: MCP 클라이언트를 Streamable HTTP 엔드포인트에 연결하고 각 요청마다 API 키를 Bearer 헤더로 전송합니다. 서버는 Blockchain0x API로 호출을 전달하는 무상태 프록시입니다. Local (stdio): 자신의 머신에서 npx @blockchain0x/mcp를 실행하면 키가 사용자의 환경에만 유지되며, 기기를 벗어나지 않습니다. 키를 호스팅된 엔드포인트로 보내고 싶지 않다면 stdio를 선택하세요.

어떤 API 키를 사용해야 하나요?

sk_test_ 키는 Base Sepolia(testnet)에서 실행되므로 실제 자금을 이동하지 않고도 도구를 연결할 수 있습니다. mainnet에서는 sk_live_ 키로 전환하세요. 키의 scope가 도구가 할 수 있는 일을 결정합니다 - 읽기 전용 키는 get_wallet, list_wallets, get_transaction을 호출할 수 있지만 send_payment는 호출할 수 없습니다.

이것이 requirePayment helper와 같은 것인가요?

아니요. 이 페이지는 Blockchain0x MCP server에 관한 것으로, MCP 클라이언트에 에이전트 지갑 도구(지갑 조회, USDC 전송, 인보이스 정산)를 제공합니다. requirePayment는 @blockchain0x/mcp에 있는 별도의 helper로, x402 402 challenge를 반환하여 여러분의 MCP 도구 자체에 가격을 부여할 때 사용합니다. 자세한 내용은 MCP integration recipe를 참고하세요.

MCP 클라이언트에 지갑을 부여하세요.

에이전트 지갑을 만들고, 키를 발급받은 다음, 클라이언트를 서버에 연결하세요. 시작은 무료입니다.