Cursor를 Narwhal MCP에 연결

안전한 Bearer 토큰 자리 표시자를 사용해 Narwhal의 호스팅 Streamable HTTP MCP 서버에 맞게 Cursor를 구성합니다.

Cursor에서 호스팅된 HTTP MCP 서버를 설정하는 파일: .cursor/mcp.json. 아래 구성은 Narwhal Bearer 키의 변수 자리 표시자를 사용합니다.

Cursor 구성

생성하거나 열 파일: .cursor/mcp.json —프로젝트 또는 사용자 설정에 이 파일을 생성하거나 연 후 다음을 추가하세요:

.cursor/mcp.json

{
  "mcpServers": {
    "narwhal": {
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NARWHAL_API_KEY}"
      }
    }
  }
}

Cursor를 실행하는 클라이언트에서 변수를 사용할 수 있는지 확인하세요. 파일을 저장한 후 MCP 서버를 재시작하거나 다시 로드하세요. 자세한 내용은 Cursor MCP 구성 가이드 에서 현재 클라이언트 동작을 확인하세요.

연결 확인

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

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

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

키를 비공개로 유지

자리 표시자에는 Cursor 또는 VS Code의 안전한 변수/입력 저장소를 사용하세요. 실제 키를 mcp.json에 포함해 커밋하거나, 프롬프트에 붙여 넣거나, URL에 넣거나, 브라우저 코드에 노출하지 마세요.

모든 요청에는 Authorization: Bearer 헤더가 필요합니다. 자세한 내용은 인증 가이드 에서 키 저장 및 교체 방법을 확인하세요.