[cursor docs] MCP (Model Context Protocol)

개요

Model Context Protocol(MCP)은 Cursor의 AI 에이전트가 외부 도구 및 데이터 소스와 표준화된 방식으로 연동할 수 있도록 해주는 오픈 프로토콜입니다. 이 글에서는 MCP의 개념, 주요 활용 사례, 아키텍처, 설정 방법, 실무에서의 팁을 단계별로 설명합니다.

MCP란?

MCP는 Cursor의 플러그인 시스템으로, 다양한 외부 시스템(데이터베이스, Notion, GitHub, Stripe 등)과 표준화된 인터페이스를 통해 연결할 수 있게 해줍니다. MCP 서버는 어떤 언어로든 구현할 수 있으며, Cursor와 통신해 AI의 기능을 확장합니다.

주요 활용 사례

데이터베이스: Cursor가 직접 쿼리하여 스키마나 데이터를 자동으로 활용
Notion: 노션의 데이터를 읽어와 기능 구현에 활용
GitHub: PR 생성, 브랜치 관리, 코드 검색 등 자동화
Memory: 작업 중 정보 기억 및 불러오기
Stripe: 고객 관리, 구독 관리 등 외부 서비스 연동

아키텍처 및 동작 방식

MCP 서버: 외부 도구/데이터와 Cursor 사이의 중개자 역할을 하는 경량 서버
Transport 방식:
- stdio: 로컬에서 실행, Cursor가 직접 프로세스를 관리하며 표준 입출력으로 통신
- SSE: 네트워크를 통한 원격/로컬 실행, 여러 머신에서 공유 가능

서버 예시 설정

{
"mcpServers": {
  "server-name": {
    "command": "npx",
    "args": ["-y", "mcp-server"],
    "env": {
      "API_KEY": "value"
    }
  }
}
}

환경 변수로 인증 정보(API 키 등) 전달 가능

MCP 서버 설정 방법

프로젝트별 설정: 프로젝트 루트에 .cursor/mcp.json 파일 생성
글로벌 설정: 홈 디렉토리(~/.cursor/mcp.json)에 생성해 모든 프로젝트에서 사용

MCP 사용 방법

MCP 도구는 MCP 설정 페이지의 Available Tools에 자동으로 노출
프롬프트에서 도구 이름이나 설명으로 직접 호출 가능
도구 사용 시 승인 요청이 뜨며, 자동 실행(자동 승인)도 설정 가능
도구 실행 결과는 채팅에 바로 표시됨
이미지 반환 도구는 base64 인코딩으로 이미지를 반환하면 채팅에 자동 첨부됨

한계 및 주의사항

MCP 도구가 40개를 초과하면 처음 40개만 Agent에 노출
원격 개발 환경(SSH 등)에서는 MCP 서버가 정상 동작하지 않을 수 있음
MCP의 리소스 기능은 아직 Cursor에서 지원되지 않음(향후 지원 예정)

실무 활용 팁

자주 쓰는 외부 도구는 글로벌 MCP 설정에 등록해 모든 프로젝트에서 활용하세요.
민감한 인증 정보는 환경 변수로 안전하게 관리하세요.
이미지 반환 도구는 base64 포맷을 활용해 시각적 결과도 AI가 활용할 수 있게 하세요.

참고 자료

Cursor 공식 문서: Model Context Protocol

저작자표시 (새창열림)

개요