​
MCP란 무엇인가요?

Model Context Protocol (MCP)는 Cursor가 외부 도구와 데이터 소스에 연결할 수 있게 해줍니다.

​
MCP를 사용하는 이유는 무엇인가요?

MCP는 Cursor를 외부 시스템과 데이터에 연결합니다. 프로젝트 구조를 반복적으로 설명하는 대신, 도구와 직접 통합할 수 있습니다. stdout에 출력하거나 HTTP 엔드포인트를 제공할 수 있는 모든 언어로 MCP 서버를 작성할 수 있습니다 - Python, JavaScript, Go 등.

​
작동 방식

MCP 서버는 프로토콜을 통해 기능을 노출하여 Cursor를 외부 도구나 데이터 소스에 연결합니다. Cursor는 세 가지 전송 방법을 지원합니다:
전송 방식실행 환경배포사용자입력인증
stdio로컬Cursor가 관리단일 사용자셸 명령어수동
SSE로컬/원격서버로 배포다중 사용자SSE 엔드포인트 URLOAuth
Streamable HTTP로컬/원격서버로 배포다중 사용자HTTP 엔드포인트 URLOAuth

​
MCP 서버 설치

​
원클릭 설치

컬렉션에서 MCP 서버를 설치하고 OAuth로 인증하세요.

MCP 도구 둘러보기

사용 가능한 MCP 서버 둘러보기

Cursor에 추가 버튼

“Cursor에 추가” 버튼 만들기

​
mcp.json 사용

JSON 파일로 사용자 정의 MCP 서버를 구성하세요: 
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

​
구성 위치

프로젝트 구성

프로젝트별 도구를 위해 프로젝트에 .cursor/mcp.json을 생성하세요.

전역 구성

모든 곳에서 사용할 수 있는 도구를 위해 홈 디렉토리에 ~/.cursor/mcp.json을 생성하세요.

​
인증

MCP 서버는 인증을 위해 환경 변수를 사용합니다. 구성을 통해 API 키와 토큰을 전달하세요. Cursor는 필요한 서버에 대해 OAuth를 지원합니다.

​
채팅에서 MCP 사용하기

Composer Agent는 관련성이 있을 때 Available Tools 아래에 나열된 MCP 도구를 자동으로 사용합니다. 특정 도구를 이름으로 요청하거나 필요한 것을 설명하세요. 설정에서 도구를 활성화하거나 비활성화할 수 있습니다.

​
도구 토글하기

채팅 인터페이스에서 직접 MCP 도구를 활성화하거나 비활성화할 수 있습니다. 도구 목록에서 도구 이름을 클릭하여 토글하세요. 비활성화된 도구는 컨텍스트에 로드되지 않으며 Agent에서 사용할 수 없습니다.

​
도구 승인

Agent는 기본적으로 MCP 도구를 사용하기 전에 승인을 요청합니다. 도구 이름 옆의 화살표를 클릭하여 인수를 확인하세요.

​
자동 실행

Agent가 묻지 않고 MCP 도구를 사용하도록 자동 실행을 활성화하세요. 터미널 명령어처럼 작동합니다. Yolo 모드에 대한 자세한 내용은 여기를 참조하세요.

​
도구 응답

Cursor는 인수와 응답의 확장 가능한 보기와 함께 채팅에서 응답을 표시합니다:

​
컨텍스트로서의 이미지

MCP 서버는 스크린샷, 다이어그램 등의 이미지를 반환할 수 있습니다. base64로 인코딩된 문자열로 반환하세요: 
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ 가독성을 위해 전체 base64를 잘랐습니다

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
구현 세부사항은 이 예제 서버를 참조하세요. Cursor는 반환된 이미지를 채팅에 첨부합니다. 모델이 이미지를 지원하는 경우 이를 분석합니다.

​
보안 고려사항

MCP 서버를 설치할 때 다음과 같은 보안 관행을 고려하세요:
  • 소스 확인: 신뢰할 수 있는 개발자와 저장소에서만 MCP 서버를 설치하세요
  • 권한 검토: 서버가 액세스할 데이터와 API를 확인하세요
  • API 키 제한: 최소한의 필요 권한만 가진 제한된 API 키를 사용하세요
  • 코드 감사: 중요한 통합의 경우 서버의 소스 코드를 검토하세요
MCP 서버는 외부 서비스에 액세스하고 사용자를 대신하여 코드를 실행할 수 있다는 점을 기억하세요. 설치하기 전에 항상 서버가 무엇을 하는지 이해하세요.

​
실제 사용 예시

MCP의 실제 활용 사례를 보려면 Linear, Figma, 브라우저 도구를 개발 워크플로우에 통합하는 방법을 보여주는 웹 개발 가이드를 참조하세요.

​
FAQ