MCP config 생성기
클라이언트와 사용할 서버를 선택하세요. 해당 클라이언트가 요구하는 형식의 config와 지원되는 CLI 명령을 생성하고, 실행할 수 없는 항목은 경고합니다.
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
},
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"playwright": {
"type": "stdio",
"command": "npx",
"args": [
"@playwright/mcp@latest"
]
}
}
}
또는 명령줄에서 추가
claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --transport http --scope project context7 https://mcp.context7.com/mcp
claude mcp add --scope project playwright -- npx @playwright/mcp@latest
출력 작동 방식
호스팅 또는 로컬
호스팅 서버는 클라이언트가 Streamable HTTP로 연결하는 URL입니다. 공급업체가 서버를 운영하므로 설치할 것이 없습니다. 로컬 서버는 npx, uvx 또는 docker를 통해 하위 프로세스로 시작되며, 사용자의 컴퓨터에 부여된 접근 권한으로 실행됩니다. 서버가 두 방식을 모두 제공하면 생성기는 먼저 호스팅을 선택하며, 원하는 경우 전환할 수 있습니다.
비밀 키는 파일에 저장되지 않습니다
생성기는 실제 키를 파일에 기록하지 않습니다. 각 클라이언트의 참조 구문을 사용합니다. Claude Code에서는 ${VAR}, Cursor와 Windsurf에서는 ${env:VAR}, VS Code에서는 입력 프롬프트, Gemini CLI에서는 $VAR, Codex에서는 env_vars, Continue에서는 ${{ secrets.VAR }}를 사용합니다. 그 외 클라이언트에는 직접 입력할 수 있도록 <VAR> 자리표시자가 표시됩니다.
처음 사용할 때 OAuth로 로그인
여기에 있는 대부분의 호스팅 서버는 OAuth로 로그인합니다. 클라이언트가 처음 연결할 때 브라우저를 열거나 로그인 단계를 실행합니다. Claude Code에서는 /mcp, codex mcp login, devin mcp login 또는 openclaw mcp login을 실행하세요. Slack, Asana, HubSpot은 사전 등록된 클라이언트만 허용하므로 사용 중인 클라이언트가 지원되는지 확인하세요.
수정 후 다시 불러오기
Claude Desktop은 시작할 때 설정 파일을 읽으므로, 변경한 뒤 종료했다가 다시 여세요. macOS의 로그는 ~/Library/Logs/Claude에 있습니다. 다른 클라이언트에서 새 서버가 표시되지 않으면 클라이언트를 재시작하거나 창을 다시 불러오세요. OpenClaw에서는 openclaw mcp doctor <name> --probe를 실행해 서버 하나를 테스트할 수 있습니다.
설정 관련 질문
Cursor와 Claude Code에서 mcp.json은 어디에 두나요?
Cursor는 프로젝트의 .cursor/mcp.json 또는 모든 프로젝트에 적용되는 ~/.cursor/mcp.json을 읽습니다. Claude Code는 프로젝트 범위 설정으로 저장소 루트의 .mcp.json을 읽고, 로컬 및 사용자 범위 설정은 ~/.claude.json에 저장합니다. VS Code는 .vscode/mcp.json을 사용하고, Codex는 JSON 대신 ~/.codex/config.toml을 사용합니다.
claude_desktop_config.json에서 원격 서버를 불러오지 못하는 이유는 무엇인가요?
Claude Desktop은 이 파일에서 로컬 서버만 불러옵니다. 원격 서버는 Settings > Connectors에서 맞춤 커넥터로 추가해야 합니다. 이 화면에서 URL을 입력하고 로그인하세요. 생성기는 이런 이유로 해당 URL을 별도로 표시합니다.
커밋하는 .mcp.json에 API 키를 넣지 않으려면 어떻게 해야 하나요?
키를 직접 붙여 넣는 대신 환경 변수를 참조하세요. Claude Code는 ${VAR}와 ${VAR:-default}를 확장하고, Cursor는 ${env:NAME}을 확장하며, VS Code에서는 inputs 항목을 통해 비밀 값을 입력하도록 요청할 수 있습니다. 클라이언트를 시작하기 전에 셸이나 시크릿 관리자에서 변수를 설정하세요.
하나의 MCP 설정을 여러 클라이언트에서 재사용할 수 있나요?
수정 없이 그대로 재사용할 수는 없습니다. 대부분의 클라이언트는 최상위 키로 mcpServers를 사용하지만, .vscode/mcp.json은 servers, Zed는 context_servers, Codex는 mcp_servers 테이블을 사용합니다. 일부 클라이언트는 다른 클라이언트의 설정 파일을 가져옵니다. VS Code는 Claude Desktop, Cursor, Windsurf의 설정을 검색하고, Continue는 mcp.json을 직접 가져올 수 있으며, JetBrains AI Assistant에는 Claude에서 가져오기 옵션이 있습니다.
Windows의 Claude Desktop에서 npx가 실패하는 이유는 무엇인가요?
MCP 서버 README에서는 Windows에서 cmd를 통해 npx를 실행합니다. command는 cmd로, 인수에는 /c, npx, 패키지를 지정합니다. Claude Desktop과 Windows를 선택하면 생성기가 이 래퍼를 자동으로 적용합니다.
호스팅 버전과 로컬 버전 중 어떤 서버를 사용해야 하나요?
호스팅 버전은 런타임을 설치할 필요가 없고, OAuth를 사용하므로 디스크에 장기 토큰을 저장하지 않아도 됩니다. 서버가 로컬 파일이나 자격 증명에 접근해야 하거나 Filesystem, Playwright, AWS API 서버처럼 호스팅 endpoint가 없는 경우에는 로컬 버전이 적합합니다.