# 개발자와 AI 에이전트를 위한 블록체인 RPC 및 문서 MCP

> https://blockvectra.com/ko/agents/

개발자와 AI 에이전트는 키 없이 문서를 탐색하고, HTTP를 통해 자격 증명을 생성한 후 인증을 거쳐 지원되는 RPC 또는 Data API 엔드포인트를 호출할 수 있습니다.

키가 필요 없는 공개 엔드포인트: API 키 없이 https://api.blockvectra.com/v1/<chain>/public 에서 지원되는 체인을 호출할 수 있습니다. <chain>은 eth_mainnet과 같은 체인 이름으로 바꾸십시오. IP별 제한과 지원 체인 목록은 GET /v1/chains에서 확인할 수 있습니다.

## 빠른 답변

- 키가 필요 없습니다. POST https://api.blockvectra.com/v1/<chain>/public는 계정이나 API 키 없이 29개 체인에서 동작하며, IP당 초당 3건의 요청을 처리합니다(버스트 20, 배치는 최대 10건). ([출처: GET /v1/chains](https://api.blockvectra.com/v1/chains))
- 지갑 가입은 네 번의 HTTP 호출이면 됩니다. 챌린지를 요청하고, Ethereum 지갑으로 서명(EIP-191)하고, 로그인(첫 로그인 시 계정이 생성됩니다)한 다음, POST /keys로 API 키를 생성합니다. ([출처: 프로그래밍 방식 가입 가이드](https://docs.blockvectra.com/ko/guides/programmatic-signup/))
- 명령어 하나로 문서 MCP 서버를 추가할 수 있으며 키는 필요 없습니다: claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp ([출처: AI 에이전트 가이드](https://docs.blockvectra.com/ko/guides/ai-agents/))
- 가입하면 카드 없이 30,000,000 CU를 무료로 받습니다. 무료 플랜은 30일 주기로 운영되며, 모든 키가 공유하는 초당 25회 호출을 제공합니다. eth_call은 15 CU(1,000,000건당 $1.50)입니다. ([출처: GET /v1/plans](https://console-api.blockvectra.com/v1/plans))
- 사람과 같은 규칙: 키 생성과 해지, 잔액 조회, 온체인 충전은 모두 콘솔 전용이 아닌 HTTP 호출입니다. MCP 서버는 키를 생성하거나 해지하지 않습니다. ([출처: 프로그래밍 방식 가입 가이드](https://docs.blockvectra.com/ko/guides/programmatic-signup/))

## 어떤 것을 써야 하나요?

| 원하는 것 | 사용할 것 | 첫 단계 |
| --- | --- | --- |
| 계정 없이 지금 바로 체인 데이터 읽기 | 키가 필요 없는 공개 엔드포인트 | eth_chainId JSON-RPC 본문으로 https://api.blockvectra.com/v1/<chain>/public에 POST합니다. 허용되는 메서드는 [GET /v1/chains](https://api.blockvectra.com/v1/chains)에 있습니다. |
| AI 어시스턴트가 문서, 체인, 상태, 요금을 읽고 읽기 전용 RPC를 호출하도록 하기 | 문서 MCP 서버 | 아래 MCP 섹션의 한 줄 명령어를 실행합니다. [AI 에이전트 가이드](https://docs.blockvectra.com/ko/guides/ai-agents/)를 참고하세요. |
| 공개 목록 밖의 메서드, Data API 또는 키 자체의 제한 사용하기 | HTTP 가입 및 API 키 | POST /auth/siwe/challenge, 서명, 로그인 후 POST /keys. 단계는 [프로그래밍 방식 가입 가이드](https://docs.blockvectra.com/ko/guides/programmatic-signup/)에 있습니다. |
| 폴링 대신 주소에 활동이 있을 때 알림 받기 | Webhook 주소 푸시 | [Webhook 푸시 가이드](https://docs.blockvectra.com/ko/guides/webhook-push/)에서 최대 1,000,000개 주소의 구독을 만듭니다. |

## 키가 필요 없는 문서 MCP

문서 MCP 서버는 API 키가 필요 없으며 문서, 체인, 실시간 상태, 요금 및 사용량 추정에 관한 질문에 답변합니다.

### 문서 전용 MCP

search_docs · read_doc

```bash
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docs
```

[문서 전용 MCP →](https://docs.blockvectra.com/en/guides/mcp-server/#docs-only-remote-http)

명령어 하나, API 키 불필요:

```bash
claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp
```

다른 클라이언트:

- [Cursor에 설치](cursor://anysphere.cursor-deeplink/mcp/install?name=blockvectra&config=eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9)
- [Cline 설정](https://docs.cline.bot/mcp/mcp-overview#manual-config)

Cline에서 MCP Servers → Configure → Configure MCP Servers를 열고 API 키가 필요 없는 다음 설정을 추가하세요:

```json
{
  "mcpServers": {
    "blockvectra": {
      "type": "streamableHttp",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}
```

[문서의 AI 에이전트 가이드 보기 →](https://docs.blockvectra.com/ko/guides/ai-agents/)

키 없이 공개 RPC 호출 시도

```
지원되는 체인을 나열하고 공개 메서드에서 eth_chainId를 허용하는 체인을 선택하세요. 해당 체인과 메서드에 get_method_info를 사용한 다음 API 키 없이 rpc_call로 eth_chainId를 호출하세요. 반환된 체인 ID를 선택한 체인의 공개된 chain_id와 숫자로 비교하고 결과와 적용되는 공개 접근 한도를 보고하세요. ID가 없거나 유효하지 않거나 다르면 성공을 주장하지 말고 중단하여 보고하세요.
```

키가 필요한 메서드나 Data API를 사용하려면 [HTTP로 가입하고 키를 생성](https://docs.blockvectra.com/ko/guides/programmatic-signup/)한 다음 [Data API 가이드](https://docs.blockvectra.com/ko/api/data/)를 따르세요. 잔액을 추가하려면 [온체인으로 충전](https://docs.blockvectra.com/ko/guides/agent-topup/)하세요.

## 연동 가이드

- [MCP 서버](https://docs.blockvectra.com/ko/guides/mcp-server/) 도구 목록, 키 요구 사항, 클라이언트 설정.
- [LangChain](https://docs.blockvectra.com/ko/guides/langchain/) LangChain 에이전트에 RPC 도구 또는 MCP 서버를 연결합니다.
- [ElizaOS](https://docs.blockvectra.com/ko/guides/elizaos/) EVM 플러그인이 BlockVectra 엔드포인트를 가리키게 합니다.
- [Coinbase AgentKit](https://docs.blockvectra.com/ko/guides/coinbase-agentkit/) AgentKit에서 BlockVectra RPC URL을 사용합니다.
- [주식 토큰 활동](https://docs.blockvectra.com/ko/guides/stocks/) Data API에서 주식 토큰의 일별 전송 활동을 읽습니다.

## 사람과 동일한 권한

HTTP를 통해 에이전트는 키를 생성(POST /keys)하고 해지(POST /keys/{key_id}/revoke)하며, 잔액을 조회(GET /v1/account)하고 온체인으로 충전할 수 있습니다. 한도와 요금은 콘솔을 쓰는 사람과 같습니다.

MCP 서버는 문서, 체인, 상태, 요금을 읽고, 읽기 전용 RPC를 호출하고(rpc_call), 서명된 트랜잭션을 브로드캐스트하며(send_raw_transaction), 클라이언트에 키를 설정하면 계정 잔액과 입금 주소도 읽을 수 있습니다. 키를 생성하거나 해지하는 도구는 없으므로 이는 HTTP로 처리하세요.

## 에이전트가 읽을 수 있는 요금 정보

GET /v1/plans는 각 메서드의 CU 가중치를 JSON으로 반환하므로 첫 호출 전에 비용을 예측할 수 있습니다.

- [GET /v1/plans 열기 →](https://console-api.blockvectra.com/v1/plans)
- [USDC / USDT / USDG로 결제 →](https://blockvectra.com/ko/pricing/#pay-with-usdt)

### 무료 플랜

30,000,000 CU 가입 크레딧이 포함됩니다. 첫 과금 대상 사용 시점부터 30일 주기가 시작되며, 기간 종료 시 최대 30,000,000 CU까지 자동으로 다시 채워집니다(누적되지 않음). 모든 키는 평균 초당 25회 호출을 공유하며, 일시적 버스트가 허용됩니다. 각 키는 기본 100 CU/s 제한(버스트 400 CU)을 유지합니다.

약 2,000,000회의 eth_call

신용카드 불필요 — GitHub, Google 또는 지갑으로 즉시 가입할 수 있습니다.

[무료 플랜 및 요금 보기 →](https://blockvectra.com/ko/pricing/#free)

## 기계 판독 가능한 진입점

계정 없이도 탐색 가능한 기계 판독 가능한 파일 및 카탈로그:

- [메인 사이트 llms.txt](https://blockvectra.com/llms.txt)
- [문서 llms.txt](https://docs.blockvectra.com/llms.txt)
- [모든 문서 페이지의 Markdown 사본](https://docs.blockvectra.com/md/ko/quickstart.md)
- [OpenAPI 3.1 — JSON-RPC](https://docs.blockvectra.com/openapi/json-rpc.yaml)
- [OpenAPI 3.1 — Data API](https://docs.blockvectra.com/openapi/data.yaml)
- [RFC 9727 API 카탈로그](https://blockvectra.com/.well-known/api-catalog)
- [오류 레퍼런스](https://docs.blockvectra.com/ko/errors/)

## 복사하여 사용할 수 있는 예제

```bash
export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST https://api.blockvectra.com/v1/robinhood_mainnet \
  -H "content-type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
```

## API 키가 아직 없으신가요?

Ethereum 지갑이 있는 경우: 브라우저 없이 프로그래밍 방식 가입 가이드에 따라 가입하고 키를 생성하세요. 지갑이 없는 경우: 사용자에게 https://console.blockvectra.com에서 로그인하여 키를 생성하고 환경 변수 BLOCKVECTRA_API_KEY로 설정하도록 요청하세요. 사용자에게 키를 채팅창에 붙여넣도록 요청하지 마세요.

- [프로그래밍 방식 가입 가이드 보기 →](https://docs.blockvectra.com/ko/guides/programmatic-signup/)
- [콘솔 로그인](https://console.blockvectra.com/login/?next=%2Fkeys%2F)

## 자주 묻는 질문

### 가입 없이 블록체인 RPC를 호출할 수 있나요?

네. POST https://api.blockvectra.com/v1/<chain>/public는 계정이나 API 키 없이 29개 체인에서 동작하며, 체인별로 허용되는 메서드와 IP당 제한은 [GET /v1/chains](https://api.blockvectra.com/v1/chains)에 있습니다. 이 목록 밖의 메서드와 Data API에는 API 키가 필요합니다.

### MCP 서버가 트랜잭션을 보낼 수 있나요?

브로드캐스트는 할 수 있지만 서명은 하지 못합니다. MCP 서버는 개인 키를 보관하지 않습니다. send_raw_transaction은 다른 곳에서 서명한 트랜잭션을, 공개 메서드에 eth_sendRawTransaction이 포함된 체인에서는 키가 필요 없는 엔드포인트를 통해, 또는 사용자의 API 키로 제출합니다. 키를 생성하거나 해지하는 도구는 없습니다.

[AI 에이전트 가이드에서 MCP 도구 보기 →](https://docs.blockvectra.com/ko/guides/ai-agents/)

### 시작하기 전에 결제해야 하나요?

아니요. 첫 지갑 로그인 시 카드나 입금 없이 무료 크레딧 30,000,000 CU가 지급되며, 키가 필요 없는 엔드포인트는 계정조차 필요하지 않습니다. eth_call은 15 CU(1,000,000건당 $1.50)이고, 모든 요금은 [GET /v1/plans](https://console-api.blockvectra.com/v1/plans)에 있습니다. 더 필요하면 [온체인으로 충전](https://docs.blockvectra.com/ko/guides/agent-topup/)할 수 있습니다.

### AI 에이전트는 브라우저 없이 API 키를 어떻게 받나요?

네 번의 HTTP 호출로 받습니다. POST /auth/siwe/challenge, 반환된 메시지를 Ethereum 지갑으로 서명(EIP-191), POST /auth/siwe/login(첫 로그인 시 계정이 생성됩니다), 그리고 POST /keys입니다. 키는 한 번만 반환되므로 BLOCKVECTRA_API_KEY에 저장하세요.

[프로그래밍 방식 가입 가이드 따라하기 →](https://docs.blockvectra.com/ko/guides/programmatic-signup/)

### AI 에이전트가 BlockVectra를 직접 사용할 수 있나요?

네, 가능합니다. 에이전트는 사람과 동일한 공개 JSON-RPC 및 Data API를 동일한 문서와 요금으로 사용합니다. 문서 MCP 서버와 기계 판독 가능한 파일은 키가 필요하지 않습니다.

[연결 방법 보기 →](https://docs.blockvectra.com/ko/guides/ai-agents/)
