전체 문서 탐색

VS Code를 Narwhal MCP에 연결

안전한 Bearer 토큰 자리 표시자를 사용해 Narwhal의 Visual Studio Code 원격 MCP 서버 항목을 구성합니다.

Visual Studio Code에서 원격 HTTP MCP 서버를 설정하는 파일: .vscode/mcp.json. 입력 변수를 사용해 워크스페이스 파일에 저장하지 않고 API 키를 안전하게 요청하세요.

VS Code 구성

다음을 여세요: MCP: Open Workspace Folder MCP Configuration —명령 팔레트에서 실행한 후 다음을 추가하세요:

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "NARWHAL_API_KEY",
      "description": "Narwhal API Bearer key",
      "password": true
    }
  ],
  "servers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:NARWHAL_API_KEY}"
      }
    }
  }
}

VS Code에서 다음 키의 입력을 요청하면 NARWHAL_API_KEY, 입력 프롬프트를 통해 키를 입력하세요. 파일 자체에는 자격 증명을 넣지 마세요. 자세한 내용은 VS Code MCP 서버 가이드 에서 현재 클라이언트 동작을 확인하세요.

연결 확인

클라이언트의 MCP 서버 목록을 열고 다음 서버를 확인하세요: narwhal 서버가 연결되어 있는지 확인하세요. 명령 팔레트에서 다음을 실행하세요: MCP: List Servers.

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

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

키를 비공개로 유지

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

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