Cursor, Windsurf, Gemini에 MCP 서버를 연결하는 방법

모든 AI 코딩 에디터가 이제 MCP (Model Context Protocol)를 지원합니다. 하지만 에디터마다 설정 파일 위치, 필드 이름, 주의 사항이 모두 다릅니다. 여기 주요 3대 에디터에 원격 MCP 서버를 연결하기 위한 치트 시트(Cheat sheet)가 있습니다.

Cursor

설정 위치 (Config location): ~/.cursor/mcp.json (전역/global) 또는 .cursor/mcp.json (프로젝트별/per-project)

원격 서버 (Streamable HTTP):

{
  "mcpServers": {
    "nucleus": {
...

로컬 서버 (stdio):

{
  "mcpServers": {
    "nucleus": {
...

주의 사항 (Gotcha): 설정을 편집한 후에는 반드시 Cursor를 완전히 종료했다가 다시 시작해야 합니다. MCP 서버는 시작 시에만 로드됩니다.

UI 경로: Settings → Tools & MCP → Add new MCP server

Windsurf

설정 위치 (Config location): ~/.codeium/windsurf/mcp_config.json (전역만 지원 — 프로젝트별 지원 안 함)

원격 서버 (Streamable HTTP):

{
  "mcpServers": {
    "nucleus": {
...

로컬 서버 (stdio):

{
  "mcpServers": {
    "nucleus": {
...

주의 사항 #1: Windsurf는 url 대신 serverUrl을 사용합니다. Cursor 설정을 그대로 복사하면 오류 메시지 없이 연결이 되지 않는 등 조용히 실패합니다.

주의 사항 #2: 경로는 .windsurf/가 아니라 .codeium/windsurf/입니다.

주의 사항 #3: Windsurf는 설정 필드에서 변수 보간 (Variable interpolation)인 ${env:VAR_NAME} 및 ${file:/path}를 지원합니다.

UI 경로: Plugins icon → Manage plugins → View raw config

Google Gemini / Antigravity

설정 위치 (Config location): ~/.gemini/config/mcp_config.json

원격 서버 (Streamable HTTP):

{
  "mcpServers": {
    "nucleus": {
...

로컬 서버 (stdio):

{
  "mcpServers": {
    "nucleus": {
...

주의 사항: Gemini Enterprise는 Streamable HTTP만 허용합니다 (더 이상 사용되지 않는 SSE 아님). Antigravity MCP Store는 폐쇄형 큐레이션 목록으로, 공개 제출은 불가능합니다. 사용자는 원시 설정 파일 (raw config file)을 통해 커스텀 서버를 구성합니다.

UI 경로: Antigravity → ... 메뉴 → MCP Store → Manage MCP Servers → View raw config

비교 표

Editor	Config path	Remote field	Per-project?
Cursor	~/.cursor/mcp.json	url	Yes (.cursor/mcp.json)
...

모두를 당황하게 만드는 지점

만약 MCP 서버가 Cursor에서는 작동하지만 Windsurf에서는 작동하지 않는다면, 필드 이름(field name)을 확인하세요. Cursor는 url을 사용하고, Windsurf는 serverUrl을 사용합니다. JSON 구조는 동일하지만 키(key)가 다릅니다. 에러 메시지 없이 조용히 실패(Silent failure)합니다.

만약 Windsurf에서는 작동하지만 Antigravity에서는 작동하지 않는다면, 전송 방식(transport)을 확인하세요. Antigravity는 지원이 중단된(deprecated) SSE를 거부하며, Streamable HTTP만 허용합니다.

전체 가이드

• Cursor에 연결하기
• Windsurf에 연결하기
• Gemini에 연결하기

Nucleus 구축 중 — AI 코딩 에이전트를 위한 지속성 메모리(persistent memory). GitHub에서 오픈 소스로 공개되어 있습니다. 설치: pip install nucleus-mcp && nucleus-init --scan.