첫 MCP 서버를 Claude Code 또는 Cursor에 연결하는 방법

AI 코딩 어시스턴트와 시간을 좀 보냈다면, 그것이 코드는 아름답게 작성하지만 당신의 데이터베이스, 이슈 트래커, 디자인 파일에 무엇이 있는지는 전혀 모르는 순간에 부딪혔을 것입니다. 결국 채팅에 컨텍스트를 복사-붙여넣기 하는 일을 반복하게 됩니다. Model Context Protocol(MCP)은 그 복사-붙여넣기 루프를 없애기 위해 존재합니다. 이 가이드는 MCP가 무엇인지 설명하고 첫 서버 연결을 안내합니다.

MCP가 실제로 무엇인가

MCP는 AI 도구를 외부 데이터 및 서비스에 연결하기 위한 Anthropic이 도입한 개방형 표준입니다. 흔한 비유는 MCP가 **"AI를 위한 USB-C 포트"**라는 것입니다: 모든 도구가 자체 커스텀 통합을 발명하는 대신, AI 에이전트가 하나의 보편적 프로토콜을 사용해 MCP 호환 서버라면 어디에든 꽂을 수 있습니다.

큰 실용적 이점은 이식성입니다. Cursor와 Claude Code가 모두 같은 프로토콜을 말하기 때문에, 한쪽에서 설정한 서버는 대체로 다른 쪽에서도 작동합니다 — 그리고 WWDC 2026 기준으로 Apple의 Xcode 27조차 MCP 플러그인 지원을 추가했습니다. 한 번 배우고, 어디서나 재사용하세요.

MCP 서버는 도구(AI가 취할 수 있는 행동)와 리소스(읽을 수 있는 데이터)를 노출하는 작은 프로그램일 뿐입니다. GitHub, PostgreSQL, Slack, Google Drive, Puppeteer 등 많은 것을 위한 미리 만들어진 서버가 있습니다.

만나게 될 두 종류의 서버

초보자로서 알아둘 만한 두 가지 전송 방식이 있습니다:

• 로컬(stdio) 서버는 당신 자신의 머신에서 프로세스로 실행됩니다 — 파일시스템이나 로컬 데이터베이스 같은 것에 좋습니다. npx나 python 같은 명령으로 시작합니다.
• 원격(HTTP/SSE) 서버는 벤더가 URL에 호스팅하며, 종종 OAuth 로그인 뒤에 있습니다 — 예를 들어 Notion, Asana, Sentry.

Claude Code에서 서버 연결하기

Claude Code는 단일 claude mcp add 명령을 사용합니다. 원격 서버는 URL을 가리키게 하세요:

claude mcp add --transport http notion https://mcp.notion.com/mcp

로컬 서버는 -- 뒤의 모든 것이 Claude가 그것을 시작하기 위해 실행하는 명령입니다:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server

-- 구분자가 중요합니다: 그것은 Claude Code에게 자체 플래그가 어디서 끝나고 서버의 실행 명령이 어디서 시작되는지 알려줍니다. 그런 다음 claude mcp list로 연결된 것을 나열해 핸드셰이크가 성공했는지 확인할 수 있습니다.

Claude Code는 또한 누가 서버를 볼 수 있는지 결정하는 스코프를 지원합니다. local 스코프는 이 머신의 당신에게만 한정하고, project 스코프는 설정을 팀 전체가 git에 커밋할 수 있는 공유 .mcp.json 파일에 기록하며, user 스코프는 당신의 모든 프로젝트에서 사용할 수 있게 합니다. 팀원도 필요로 하는 것이라면, 대개 project 스코프가 올바른 선택입니다.

Cursor에서 서버 연결하기

Cursor는 UI를 통해 동일한 기능을 노출합니다. Cursor Settings를 열고, Features > MCP로 가서 **"+ Add New MCP Server"**를 클릭한 다음, 실행 명령(로컬 서버용)이나 URL(원격용)을 붙여넣으세요. 내부적으로 Cursor는 이것을 JSON 설정에 저장하므로, 직접 손으로 편집할 수도 있습니다. 멋진 2026년 개선점: Cursor의 에이전트는 이제 모든 서버의 도구를 프롬프트에 욱여넣는 대신 도구 설명을 요청 시에 로드하므로, 여러 서버를 연결해도 빠르게 유지됩니다.

구체적인 첫 프로젝트

5분짜리 성공을 원한다면, GitHub MCP 서버를 연결하고 어시스턴트가 전에는 결코 답할 수 없었던 것을 물어보세요:

"이 저장소에서 가장 최근에 닫힌 이슈 세 개를 보고 무엇이 바뀌었는지 요약해 주세요."

MCP 없이는 어시스턴트가 추측하거나 이슈를 붙여넣어 달라고 했을 것입니다. 서버가 연결되면, GitHub 도구를 직접 호출하고, 실제 이슈를 읽고, 라이브 데이터로 답합니다. 그것이 한 예시로 본 MCP의 핵심입니다: 모델이 영리한 텍스트 상자이기를 그만두고 당신이 실제로 일하는 시스템에 손을 뻗을 수 있는 에이전트가 되기 시작합니다.

마구 쓰기 전 안전 주의사항

MCP는 AI에게 실제 시스템에 대한 실제 접근을 줍니다. 그러니 새 서버를 다른 의존성처럼 다루세요. 공식이거나 잘 검토된 서버를 선호하고, 연결하기 전에 서버가 어떤 도구를 노출하는지 읽고, API 키를 필요한 최소 권한으로 한정하고, 데이터를 쓰거나 지울 수 있는 서버는 조심하세요. 읽기 전용 사용 사례 — 데이터베이스 스키마 조회, 이슈 읽기, 문서 검색 — 로 시작하고, 설정을 신뢰하게 되면 쓰기 동작으로 졸업하세요.

복사-붙여넣기 루프가 사라지고 나면, 되돌아가기 어렵습니다. 당신의 워크플로에서 실제 짜증을 해결하는 서버 하나로 시작하고, 거기서부터 키워 나가세요.