MCP 서버 설정

사전 요구 사항

• Node.js 22.0.0 이상 —— 로컬에서 MCP 서버 프로세스를 실행하기 위해 필요

MCP 서버 추가

Model Context Protocol 을 지원하는 AI 애플리케이션에 DevBridge MCP 서버 구성을 추가합니다. 지원되는 애플리케이션 예시：

• Claude Code
• Cursor
• Claude Desktop
• Windsurf
• VS Code

서버 구성

{
  "mcpServers": {
    "devbridge": {
      "command": "npx",
      "args": ["devbridge-mcp@latest"]
    }
  }
}

첫 실행 시 발생하는 일： npx devbridge-mcp@latest 가 처음 실행될 때 Chrome 이 로컬 MCP 서버와 통신할 수 있도록 네이티브 메시징 호스트 manifest 가 자동으로 설치됩니다. 이는 일회성 설정이며 이후 실행은 즉시 시작됩니다.

도구별 설정 방법

Claude Code

1. 프로젝트 루트에서 .mcp.json 을 생성 또는 편집
2. 위의 서버 구성을 추가
3. 해당 프로젝트에서 Claude Code 재시작 —— DevBridge 가 MCP 도구 목록에 표시됩니다
4. 프로젝트의 .claude/settings.local.json 에 다음을 추가하여 모든 DevBridge 도구를 사전 승인합니다：

{
  "permissions": {
    "allow": ["mcp__devbridge__*"]
  }
}

이 단계가 필요한 이유： Claude Code 는 각 MCP 도구에 명시적 승인이 필요합니다. 이 설정이 없으면 각 도구를 처음 사용할 때 승인 대화상자가 표시됩니다. 비대화형 환경（CI、헤드리스 세션）에서는 미승인 도구가 "user rejected" 로 자동 거부되며 어떤 팝업도 나타나지 않습니다. mcp__devbridge__* 와일드카드로 18 개의 DevBridge 도구를 한 번에 승인할 수 있습니다.

자세한 내용은 Claude Code 의 MCP 문서 를 참조하세요.

Cursor

1. Cursor 의 전체 설정 열기
2. Tools 탭으로 이동
3. New MCP server 클릭
4. 위의 서버 구성을 추가
5. devbridge 서버 옆의 새로고침 버튼을 클릭하여 구성 재로드

도구 승인： Cursor 는 각 MCP 도구를 처음 사용할 때 승인 팝업을 표시합니다. Allow 를 클릭하여 승인하세요.

자세한 내용은 Cursor 의 MCP 문서 를 참조하세요.

Claude Desktop

위의 서버 구성을 claude_desktop_config.json 에 추가한 다음 Claude Desktop 을 재시작합니다.

참고： Claude Desktop 에는 MCP 서버가 두 번 시작되는 알려진 문제 가 있습니다. 시작 시 일시적으로 오류 표시가 나타날 수 있지만 DevBridge 는 정상적으로 작동합니다.

자세한 내용은 Claude 의 MCP 빠른 시작 을 참조하세요.

Windsurf

Windsurf 의 MCP 설정에서 위의 서버 구성을 추가합니다.

자세한 내용은 Windsurf 의 MCP 문서 를 참조하세요.

VS Code

VS Code 는 GitHub Copilot 의 agent 모드를 통해 MCP 를 지원합니다. 작업 공간의 .vscode/mcp.json 에 다음을 추가하세요 (최상위 키는 mcpServers 가 아닌 servers 임에 유의)：

{
  "servers": {
    "devbridge": {
      "command": "npx",
      "args": ["devbridge-mcp@latest"]
    }
  }
}

도구 승인： VS Code 는 각 MCP 도구를 처음 사용할 때 승인 알림을 표시합니다. Allow 를 클릭하여 승인하세요.

자세한 내용은 VS Code 의 MCP 문서 를 참조하세요.

→ 다음：빠른 시작