Claude를 Narwhal MCP에 연결

Bearer 키로 Claude Code를 Narwhal의 원격 MCP 엔드포인트에 연결하고 현재 사용자 지정 커넥터 제한을 이해하세요.

Claude Code는 원격 HTTP MCP 서버를 지원하고 정적 Bearer 헤더를 보낼 수 있습니다. 아래 명령은 Claude가 로컬 서버 구성을 작성하는 동안 토큰을 환경 변수에 보관합니다.

Claude Code

연결 시 Claude Code가 해석할 수 있도록 변수 자리 표시자를 따옴표로 묶어 이 명령을 실행하세요:

터미널

claude mcp add --transport http narwhal https://api.narwhalapi.com/mcp \
  --header 'Authorization: Bearer ${NARWHAL_API_KEY}'

이 명령이 구성하는 호스팅된 Streamable HTTP 엔드포인트: https://api.narwhalapi.com/mcp. Claude Code를 실행하는 환경에 NARWHAL_API_KEY를 설정하고 키를 비공개로 유지하세요.

Claude의 사용자 지정 원격 커넥터 흐름은 서버 URL과 선택적 OAuth 설정을 받습니다. Narwhal은 현재 Bearer API 키로 인증하고 OAuth 흐름을 제공하지 않으므로 URL만 추가해도 Narwhal에 인증되지 않습니다.

위 명령으로 Claude Code를 사용하거나 다음 헤더를 제공할 수 있는 Cursor 또는 VS Code 같은 클라이언트를 사용하세요: Authorization 헤더입니다.

Anthropic의 원격 커넥터 요청은 Anthropic 클라우드 인프라에서 시작되므로 엔드포인트에 공개적으로 접근할 수 있어야 합니다. 자세한 내용은 Claude MCP 문서 에서 현재 클라이언트 동작을 확인하세요.

클라이언트의 MCP 서버 목록을 열고 다음 서버를 확인하세요: narwhal 서버가 연결되어 있는지 확인하세요. 명령줄에서 확인하려면 다음을 실행하세요: claude mcp get narwhal.

그런 다음 클라이언트에 사용 가능한 Narwhal 도구를 나열하도록 요청하세요. 도구 검색은 데이터 할당량을 소비하지 않습니다. 성공한 각 tools/call 호출은 요청 1회를 소비합니다.

다음을 사용하세요: 기본 MCP 가이드 —공개 도구 목록, 인수, 응답 형식 및 할당량 규칙을 확인하세요.