# Cursor에 MCP 서버를 추가하는 방법

> Cursor에 MCP 서버를 추가하려면 프로젝트별 또는 전역 범위를 선택하고 Cursor의 구성 형식을 따르세요. 다른 클라이언트 설정을 그대로 복사하지 말고 서버가 표시되는지 확인하세요.

- URL: https://www.hemory.com/ko/blog/tool-guides/add-mcp-server-cursor/
- Language: Korean (ko)
- Author: Hemory Team
- Published: 2026-11-18
- Last updated: 2026-11-18
- Summary: 이 가이드는 Cursor에 MCP 서버를 추가하는 신중한 방법을 설명합니다. 프로젝트별 또는 전역 범위를 선택하고, 다른 클라이언트의 구문을 복사하는 대신 Cursor의 최신 구성 안내를 따르며, 서버가 목록에 표시되고 사용 가능한지 확인하세요. 정확한 경로와 필수 형식은 Cursor 문서를 확인하세요. 이 가이드는 Hemory 관련 엔드포인트, 도구 또는 권한을 단정하지 않습니다.
- Tags: MCP, Cursor, AI 도구, 구성

MCP 설정 안내는 클라이언트마다 서로 바꿔 쓸 수 없습니다. Claude Code나 VS Code용 서버 항목은 구성 위치, 범위 또는 구조가 다를 수 있으므로, 이를 수정 없이 Cursor에 복사하면 서버를 사용할 수 없게 될 수 있습니다.

안전한 방법은 서버를 특정 프로젝트에만 적용할지, Cursor 사용 전반에 적용할지 선택하고, 해당 범위에 대한 Cursor의 최신 MCP 구성 안내를 따른 뒤 Cursor에서 결과를 확인하는 것입니다. 정확한 파일 경로와 구성 형식은 Cursor 문서를 기준으로 해야 합니다. 다른 클라이언트의 예시가 유효하다고 가정하지 마세요.

## 1. 프로젝트별 구성 또는 전역 구성 선택하기

특정 저장소나 프로젝트에 서버가 필요하다면 프로젝트별 구성을 사용하세요. 그러면 설정이 모든 곳에 적용되는 대신 해당 작업에 연결됩니다. 여러 프로젝트에서 서버를 사용하려면 전역 구성을 사용하세요.

선택하기 전에 프로젝트 구성을 다른 기여자와 공유하게 될지 고려하세요. 프로젝트의 보안 관행에서 명시적으로 허용하지 않는 한, 자격 증명이나 기타 민감한 값을 공유 파일에 넣지 마세요.

## 2. Cursor의 구성 형식 따르기

먼저 서버 제공업체의 연결 안내를 확인한 다음, Cursor가 문서화한 형식과 위치를 사용하세요. 서버 연결 세부 정보는 재사용할 수 있지만, 그 주변의 구성 구조는 클라이언트마다 다를 수 있습니다. 특히 Claude Code나 VS Code의 최상위 키, 파일 경로 또는 프로젝트별·전역 구성 방식이 Cursor에도 그대로 적용된다고 가정하지 마세요.

정확한 위치와 필수 필드는 Cursor의 최신 문서나 MCP 설정에서 확인하세요. 클라이언트별 세부 사항은 Cursor의 최신 안내와 일치해야 하므로, 이 가이드에서는 구성 블록을 지정하지 않습니다.

서버에 자격 증명이나 환경 변수가 필요하다면 제공업체와 Cursor가 안내하는 방법을 사용하세요. 공유 프로젝트 파일에 비밀 정보를 넣거나 스크린샷, 소스 관리 또는 메시지로 노출하지 마세요.

## 3. Cursor가 서버를 인식하는지 확인하기

구성을 적용한 뒤 Cursor의 MCP 설정에서 서버와 연결 상태를 확인하세요. 서버가 표시되지 않거나 사용할 수 없다면 다음을 확인하세요.

1. 올바른 프로젝트별 또는 전역 위치를 사용했는지 다시 확인합니다.
2. 다른 클라이언트용 예시가 아니라 Cursor의 최신 안내와 구조 및 필수 필드를 비교합니다.
3. 서버 자체의 연결 세부 정보와 필요한 자격 증명이 입력되어 있는지 확인합니다.
4. Cursor 안내에서 해당 단계를 요구하는 경우 관련 Cursor 화면을 다시 열거나 새로고침한 다음 상태를 다시 확인합니다.

설정에 서버가 표시되면 등록 여부를 확인하는 데 도움이 됩니다. 하지만 그것만으로 모든 도구나 권한이 의도한 대로 작동한다고 볼 수는 없습니다. 서버와 클라이언트 문서를 참고해 실제로 필요한 기능을 확인하세요.

## Hemory가 제공하는 기능

Hemory는 [표준 MCP 서버 기능](/features/)을 설명하며, Cursor는 공개된 클라이언트 목록에 포함되어 있습니다. 이 목록만으로 특정 Cursor 설정이 독립적으로 검증되는 것은 아닙니다. Hemory의 최신 연결 안내와 Cursor의 구성 요건을 함께 따르세요. 다른 MCP 클라이언트의 예시를 근거로 Hemory 엔드포인트, 구성 블록, 도구 목록 또는 권한 범위를 추론하지 마세요.

## 자주 묻는 질문

### Cursor에서 프로젝트별 MCP 구성과 전역 MCP 구성 중 무엇을 사용해야 하나요?

서버가 하나의 프로젝트에 속한다면 프로젝트별 구성을 선택하고, 여러 프로젝트에서 사용하려면 전역 구성을 선택하세요. 민감한 값을 넣기 전에 프로젝트 구성을 공유하게 될지 고려하세요.

### Claude Code나 VS Code의 MCP 구성을 복사해도 되나요?

서버 연결 세부 정보를 참고하는 용도로만 사용하세요. 적용하기 전에 Cursor에 문서화된 경로, 범위 및 형식을 확인하세요. 클라이언트별 구성 구조가 서로 일치한다고 보장할 수 없습니다.

### Cursor에 서버가 표시되지 않으면 무엇을 확인해야 하나요?

Cursor의 최신 안내와 대조해 구성 위치와 형식을 확인한 다음, 서버에 필요한 연결 세부 정보와 자격 증명이 있는지 확인하세요. 문제의 원인을 좁히려면 Cursor에 표시된 상태와 서버 문서를 참고하세요.

신뢰할 수 있는 결과는 의도한 Cursor 범위에 서버가 등록되어 Cursor의 MCP 설정에 표시되는 것입니다. 정확한 경로와 구문은 Cursor의 최신 문서를 참고하고, 다른 클라이언트의 설정이나 권한이 적용된다고 가정하지 말고 필요한 기능을 확인하세요.

## Other language versions

- English (en): https://www.hemory.com/blog/tool-guides/add-mcp-server-cursor/
- Japanese (ja): https://www.hemory.com/ja/blog/tool-guides/add-mcp-server-cursor/
