본문으로 건너뛰기

Quicknode MCP

업데이트 날짜:
2026년 6월 3일

개요​

Quicknode MCP 서버는 사용자의 Quicknode 계정을 ChatGPT, Codex, Claude Code, Claude Desktop, Cursor, VS Code 등 MCP와 호환되는 AI 어시스턴트에 연결해 줍니다. 연결이 완료되면 대시보드를 직접 탐색하거나 API 스크립트를 작성할 필요 없이 자연어 명령을 통해 엔드포인트를 생성 및 관리하고, 사용량을 모니터링하며, 보안 설정을 구성하고, 청구 내역을 확인할 수 있습니다.

이 서버는 다음 위치에서 원격으로 호스팅되고 있습니다. https://mcp.quicknode.com/mcp 그리고 OAuth를 통해 인증합니다. 이 서비스는 Quicknode의 관리자 API, 자연어 명령을 API 작업으로 변환합니다. 이 어시스턴트는 사용자의 요청을 해석하고, 적절한 도구를 선택한 뒤, 확인을 받은 후 이를 실행합니다.


요약
  • Quicknode는 Anthropic MCP 디렉토리의 공식 커넥터입니다. Claude에서 직접 추가하거나 ‘사용자 지정 > 커 넥터’에서 찾아보실 수 있습니다.
  • Quicknode는 또한 다음 플랫폼에서 기본적으로 지원됩니다. ChatGPT 그리고 코덱스 — 에서 직접 설치하려면 ChatGPT 앱 목록 또는 다음을 통해 /플러그인 Codex에서
  • 그 외의 모든 클라이언트(Cursor, VS Code, Windsurf, Zed)는 다음 경로를 지정하여 연결합니다. https://mcp.quicknode.com/mcp 그리고 OAuth를 통해 인증하기
  • CI/CD 및 비대화형 환경의 경우, OAuth 단계를 건너뛰고 API 키를 직접 전달하십시오. — “API 키 사용” 참조
  • 대시보드나 API 스크립트 없이 자연어만으로 엔드포인트를 관리하고, 사용량을 모니터링하며, 보안 규칙을 구성하고, 청구 내역을 확인할 수 있습니다.

요구 사항​


  • Quicknode 계정
  • MCP와 호환되는 AI 어시스턴트(ChatGPT, Codex, Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed 또는 이와 유사한 도구)

구성​

아래에 나와 있는 해당 클라이언트용 지침에 따라 Quicknode MCP 서버를 어시스턴트에 추가하세요.


클로드 웹​

Quicknode는 Anthropic MCP 디렉토리에 등재된 공식 커넥터입니다. Claude에서 이를 연결하려면:


  1. Quicknode 커넥터 페이지를 방문하거나, 브라우저에서 Claude를 실행한 후 ‘사용자 지정 > 커넥터 ’로 이동하여 디렉토리에서 Quicknode를 찾아보세요.
  2. ‘연결’을 클릭하세요
  3. 브라우저 창이 열리면, Quicknode 계정으로 로그인하고 역할(관리자 또는 열람자)을 선택한 뒤, 접근 권한을 승인해 주세요.

클로드 데스크톱​

Claude Desktop 앱에 Quicknode MCP 서버를 추가하려면:


  1. ‘사용자 지정’ > ‘커넥터’로 이동합니다.
  2. 디렉토리에서 Quicknode를 찾아 ‘연결’을 클릭하세요
  3. 브라우저 창이 열리면, Quicknode 계정으로 로그인하고 역할(관리자 또는 열람자)을 선택한 뒤, 접근 권한을 승인해 주세요.

클로드 코드​

Claude Code에 Quicknode MCP 서버를 추가하려면 터미널에서 다음 명령어를 실행하세요:


  1. 서버 추가:
클로드 맥피 추가 --transport http quicknode https://mcp.quicknode.com/mcp

  1. Claude Code를 실행하고 다음을 입력하세요. /mcp 열리는 브라우저 창에서 서버에 대한 인증을 수행하려면
설치 범위

기본적으로 위의 명령어는 서버를 로컬 범위(현재 프로젝트에만 해당)에 설치합니다. Claude Code는 다음 세 가지 범위를 지원합니다:

  • 로컬 (기본값) — 현재 프로젝트에서 본인만 사용할 수 있습니다.
  • 프로젝트 (--scope 프로젝트) — 다음을 통해 팀원들과 공유했습니다. .mcp.json 프로젝트 루트 디렉터리에 있는 파일
  • 사용자 (--scope user) — 모든 프로젝트에서 이용 가능합니다

사용자 계정에 전역적으로 설치하려면 다음을 추가하십시오. --scope user flag:

클로드 맥피 추가 --transport http --scope 사용자 quicknode https://mcp.quicknode.com/mcp

인증 및 역할​

처음 연결하면 Quicknode 계정으로 로그인할 수 있는 브라우저 창이 열립니다. 여러 개의 Quicknode 계정을 보유하고 있는 경우, 연결할 계정을 선택해야 합니다. 그런 다음 MCP 서버가 사용자를 대신하여 수행할 수 있는 작업을 결정하는 API 키 역할을 선택하게 됩니다:


  • 관리자 — 전체 읽기 및 쓰기 권한. 이 권한을 통해 AI 어시스턴트가 엔드포인트를 생성 및 삭제하고, 보안 규칙을 수정하며, 속도 제한을 업데이트하고, 모든 계정 리소스를 관리할 수 있습니다.
  • Viewer — 읽기 전용 액세스 권한. 어시스턴트는 엔드포인트 목록을 확인하고, 메트릭, 로그, 사용량 및 청구 데이터를 볼 수 있지만, 리소스를 생성, 수정 또는 삭제할 수는 없습니다.

이 프로세스는 내부적으로 사용자가 선택한 역할에 대한 범위가 지정된 API 키를 생성합니다. 사용자가 직접 키를 생성하거나 관리할 필요는 없습니다.


적합한 역할 선택하기

인프라를 확인하기만 하면 되는 경우 ‘Viewer’ 역할을 선택하세요. 어시스턴트가 변경 사항을 적용해야 할 때만 ‘Admin’을 사용하세요. 나중에 역할을 변경해야 할 경우, 클라이언트에서 해당 서버를 제거한 후 다시 추가하고, 인증 절차를 다시 거쳐 다른 역할로 재인증하세요.

API 키 사용​

브라우저 기반 로그인이 불가능한 비대화형 환경(예: CI/CD 파이프라인, 원격 VM 또는 자동화 에이전트)에서 실행 중인 경우, API 키를 베어러 토큰으로 전달하여 OAuth 흐름을 건너뛸 수 있습니다. MCP 서버는 승인 헤더를 확인하고 해당 요청을 이미 인증된 것으로 간주합니다.

Quicknode 대시보드의 ‘계정’(아바타 아이콘) > ‘API 키’에서 API 키를 생성하세요. 키에 할당하는 역할(관리자 또는 열람자)에 따라 MCP 서버의 권한이 결정되며, 이는 OAuth 흐름 중에 역할을 선택하는 것과 동일합니다.


클로드 코드​

다음 방법을 사용하여 API 키를 베어러 토큰으로 전달하십시오. --헤더 flag:

클로드 맥피 추가 quicknode --transport http https://mcp.quicknode.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

클로드 데스크톱​

다음 내용을 추가하세요. --헤더 ~에 대한 플래그 mcp-remote 귀하의 claude_desktop_config.json:

{
  "mcpServers": {
    "quicknode": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.quicknode.com/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

사용 가능한 도구​

MCP 서버는 Admin API를 통해 다음과 같은 도구를 제공합니다. 읽기 전용으로 표시된 도구는 관리자(Admin) 및 열람자(Viewer) 역할 모두에서 사용할 수 있습니다. 그 외의 모든 도구는 관리자(Admin) 역할이 필요합니다.

엔드포인트 관리​

지원되는 모든 체인 및 네트워크에서 Quicknode 엔드포인트를 생성, 조회, 업데이트 및 삭제할 수 있습니다.

도구설명접근
엔드포인트 목록계정에 있는 모든 엔드포인트 나열하기읽기 전용
get-endpoint특정 엔드포인트에 대한 세부 정보 확인하기읽기 전용
엔드포인트 생성지정된 체인과 네트워크에 새로운 엔드포인트를 생성합니다.관리자
엔드포인트 삭제엔드포인트 삭제관리자
get-endpoint-metrics엔드포인트의 성능 지표 가져오기읽기 전용
엔드포인트 로그 목록엔드포인트의 최근 로그 가져오기읽기 전용
get-endpoint-log-details특정 로그 항목에 대한 자세한 정보를 확인하세요읽기 전용

요청 제한​

메서드 수준 및 엔드포인트 수준의 요청 제한을 구성합니다.

도구설명접근
업데이트 엔드포인트 속도 제한엔드포인트에 대한 전체 속도 제한(RPS, RPM, RPD) 설정관리자
목록-엔드포인트-메서드-요율 제한메서드별 요청 제한 사항 나열읽기 전용
엔드포인트 메서드 요청 제한 설정특정 RPC 메서드에 대한 요청 제한 설정하기관리자
업데이트 엔드포인트 메서드 속도 제한기존 메서드의 속도 제한 업데이트관리자
endpoint 메서드 속도 제한 삭제메서드 속도 제한 해제관리자

보안​

엔드포인트에 대한 인증 및 접근 제어 설정을 관리합니다. 이 보안 규칙 생성 그리고 보안 규칙 삭제 이 도구들은 IP 허용 목록, JWT 유효성 검사, 리퍼러 제한, 도메인 마스크, 인증 토큰 등 다양한 규칙 유형을 지원합니다.

도구설명접근
목록-엔드포인트-보안현재 보안 설정 및 규칙 확인하기읽기 전용
엔드포인트 보안 옵션 업데이트보안 기능(CORS, HSTS, IP 필터링 등) 활성화 또는 비활성화관리자
보안 규칙 생성보안 규칙 추가 (IP, JWT, 리퍼러, 도메인 마스크 또는 토큰)관리자
보안 규칙 삭제보안 규칙 제거관리자

이용 및 요금​

RPC 사용량을 모니터링하고 청구 내역을 확인하십시오.

도구설명접근
get-rpc-usageRPC 사용량을 조회하고, 선택에 따라 엔드포인트, 메서드 또는 체인별로 세부 내역을 확인합니다.읽기 전용
청구 정보 조회청구서 또는 결제 내역 확인하기읽기 전용

사슬​

사용 가능한 체인과 네트워크를 조회합니다.

도구설명접근
목록 체인지원되는 모든 체인과 해당 체인의 사용 가능한 네트워크를 나열하세요.읽기 전용

MCP 리소스​

도구 외에도 Quicknode MCP 서버는 사용자의 엔드포인트를 다음과 같이 노출합니다. MCP 자료. 리소스를 사용하면 AI 비서가 별도의 도구를 먼저 호출할 필요 없이 문맥 내에서 엔드포인트 세부 정보를 직접 참조할 수 있습니다. MCP 리소스를 지원하는 클라이언트에서는 다음을 입력할 수 있습니다. @quicknode 엔드포인트를 찾아보고 대화에 첨부하려면 (예: quicknode://endpoints/<endpoint-id>).

이는 어시스턴트가 특정 체인을 대상으로 하는 코드를 작성하거나 요청을 디버깅하는 등 작업을 수행하는 동안 사용자의 엔드포인트 구성을 즉시 활용할 수 있도록 하고 싶을 때 유용합니다.

예시 프롬프트​

도구 이름을 직접 언급할 필요는 없습니다. AI 어시스턴트가 자연어를 적절한 도구에 매핑해 줍니다. 몇 가지 예시는 다음과 같습니다:

엔드포인트 관리:

  • "새로운 Base 메인넷 엔드포인트 생성"
  • "내 모든 엔드포인트와 각 엔드포인트의 현재 상태를 보여주세요"

모니터링 및 디버깅:

  • "지난 1시간 동안의 제 Arbitrum 엔드포인트 로그를 확인해 주세요"
  • "지난 일주일 동안 제 이더리움 엔드포인트의 성능 지표를 보여주세요"

보안:

  • "이더리움 메인넷 엔드포인트에 JWT 인증 추가하기"
  • "모든 엔드포인트의 보안 설정을 검토하십시오"

이용 및 요금:

  • "이번 달 체인별 RPC 사용 내역을 보여주세요"
  • "이번 달에 크레딧을 가장 많이 사용하는 엔드포인트는 어디인가요?"

속도 제한:

  • "내 Polygon 엔드포인트에 초당 100건의 요청으로 요청 제한을 설정합니다"
  • "eth_call에 메서드별 속도 제한 추가"

팁
  • 간단하게 시작해 보세요. “내 엔드포인트는 무엇인가요?” 또는 “이번 달 사용량을 보여주세요”라고 물어보며 사용 가능한 도구에 익숙해져 보세요.
  • 구체적으로 설명하세요 — 엔드포인트가 여러 개인 경우, 어시스턴트가 올바른 엔드포인트를 빠르게 찾을 수 있도록 체인이나 이름을 명시해 주세요.

작동 원리​

MCP 서버는 다음 위치에서 원격으로 호스팅되고 있습니다. https://mcp.quicknode.com/mcp 또한 인증에는 OAuth 2.1을 사용합니다. AI 어시스턴트가 Quicknode 인프라와 관련된 요청을 수신하면, 해당 MCP 도구를 호출하며, 이 도구는 Quicknode Admin API에 인증된 요청을 보냅니다. 어시스턴트는 응답 형식을 처리하여 결과를 자연어로 표시합니다.

쓰기 작업(엔드포인트 생성, 보안 설정 수정, 리소스 삭제)의 경우, 어시스턴트가 해당 작업을 실행하기 전에 관리자(Admin) 역할이 필요하며 사용자의 명시적인 확인이 필요합니다. 뷰어 ( Viewer ) 역할로 연결한 경우, 어시스턴트는 읽기 전용 작업만 수행할 수 있습니다.


팁

Quicknode MCP는 계정 수준의 인프라를 관리합니다. AI 코딩 에이전트가 코드를 작성할 때 Quicknode의 API 및 제품에 대한 정확한 지식을 갖추도록 하려면 ‘블록체인 스킬(Blockchain Skills)’ 을 참조하세요. AI에 최적화된 문서 검색 기능을 이용하려면 ‘LLM에 최적화된 문서(LLM-Optimized Docs)’를 참조하세요.

자료​

Claude의 Quicknode 커넥터
Anthropic MCP 디렉터리에서 Quicknode를 직접 추가하세요
→
설정 안내서
AI와 MCP를 활용하여 블록체인 인프라를 관리하세요
→
ChatGPT의 Quicknode
ChatGPT 앱 카탈로그에서 Quicknode 앱을 직접 설치하세요
→
관리자 API 문서
Quicknode 관리자 API 참조
→
EVM MCP 서버
EVM MCP 서버 사용 안내서
→
솔라나 MCP 서버
솔라나 MCP 서버 사용 안내서
→

여러분의 피드백을 ❤️ 환영합니다!​

이 문서에 대한 의견이나 질문이 있으시면 언제든지 알려주세요. 여러분의 의견을 기다리고 있습니다!

최종 업데이트 ~에
이 문서 공유하기