본문으로 건너뛰기

개발 도구에 연결하기

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

항목값
연결 주소https://mcp.devdive.ai/mcp
전송 방식Streamable HTTP
헤더Authorization: Bearer DDSK-…

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에 넣어요.

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

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

VS Code​

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

.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 서버를 새로 고침하세요.