개발 도구에 연결하기

설정 파일이나 명령으로 MCP 서버를 등록하는 개발 도구는 연결 주소 + API 키 헤더로 연결해요. API 키를 먼저 준비하세요.

Claude Code

claude mcp add --transport http --scope user devdive https://mcp.devdive.ai/mcp \
  --header "Authorization: Bearer $DEVDIVE_API_KEY"

--scope user로 등록하면 모든 프로젝트에서 쓸 수 있어요. 등록한 뒤 Claude Code에서 /mcp를 열면 devdive가 연결됨으로 보여요.

Cursor

~/.cursor/mcp.json(모든 프로젝트) 또는 프로젝트의 .cursor/mcp.json에 넣어요.

{
  "mcpServers": {
    "devdive": {
      "url": "https://mcp.devdive.ai/mcp",
      "headers": { "Authorization": "Bearer DDSK-여기에-키" }
    }
  }
}

프로젝트의 .cursor/mcp.json에 키를 넣었다면 그 파일은 커밋하지 마세요.

VS Code

프로젝트의 .vscode/mcp.json에 넣어요. 키는 파일에 쓰지 않고 처음 연결할 때 한 번 물어보게 했어요.

{
  "inputs": [
    { "type": "promptString", "id": "devdive-key", "description": "데브다이브 API 키", "password": true }
  ],
  "servers": {
    "devdive": {
      "type": "http",
      "url": "https://mcp.devdive.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:devdive-key}" }
    }
  }
}

그 밖의 도구

원격 MCP 서버(Streamable HTTP)와 헤더 설정을 지원하는 도구라면 위 표의 세 값으로 연결할 수 있어요.

연결이 안 될 때

• 401: 키가 틀렸거나 Bearer 뒤에 공백·줄바꿈이 섞였어요. 키 앞뒤를 다시 확인하세요.
• 503: 데브다이브 로그인 서버가 잠시 답하지 않아요. 조금 뒤에 다시 연결하세요.
• 도구 목록이 비어 있으면 도구를 다시 시작하거나 MCP 서버를 새로 고침하세요.