Cursor에 MCP 서버 설치하는 방법 (mcp.json 가이드)

~/.cursor/mcp.json 또는 프로젝트의 .cursor/mcp.json으로 Cursor에 로컬·원격 MCP 서버를 추가하는 방법과 예시.

Cursor가 MCP 설정을 읽는 위치

Cursor는 모든 프로젝트에서 쓸 서버는 ~/.cursor/mcp.json에서, 특정 프로젝트에서만 쓸 서버는 해당 폴더의 .cursor/mcp.json에서 읽습니다. Cursor의 Customize 페이지에서도 서버를 설치하고 관리할 수 있으며, Cursor Marketplace에서 원클릭으로 설치할 수도 있습니다.

로컬(stdio) 서버 추가

형식은 Claude Desktop과 같은 mcpServers 객체입니다.

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

원격 서버 추가

호스팅된 서버는 명령 대신 URL을 입력합니다.

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

사용하기

파일을 저장하고 Customize 페이지에 서버와 도구가 표시되는지 확인한 다음, 채팅에서 Agent에게 사용을 요청하세요.

원클릭 설치

많은 README에 “Add to Cursor” 버튼이 있어 누르면 설정이 자동으로 채워집니다.