처음 Cursor에서 MCP를 붙여보면 생각보다 빨리 막힙니다. 설정 파일은 찾았는데 서버가 안 뜨고, 서버는 떴는데 Cursor에서 호출이 안 되고, 호출은 되는데 권한 문제로 실패하는 식이죠.
이 글은 Cursor MCP 설정을 처음부터 끝까지 한 번에 정리한 실무 버전입니다. 도구 이름만 바꿔도 재사용할 수 있게 순서를 잡아드릴게요. 핵심은 “설정 파일 작성 → 서버 단독 실행 확인 → Cursor 연결 확인 → 권한/오류 점검” 네 단계입니다.
Table of Contents
Cursor MCP 설정 방법, 실무에서 덜 막히는 연결 순서
| 1) MCP를 붙이기 전에, 먼저 무엇을 연결할지 좁혀야 합니다
MCP는 “Cursor가 외부 도구를 안전하게 호출하도록 중계하는 규칙”이라고 생각하면 편합니다. 문제는 처음부터 욕심내서 여러 서버를 동시에 붙이면, 어디서 깨졌는지 추적이 어렵다는 점입니다.
처음에는 한 개만 붙이세요. 예를 들어 파일 탐색/문서 조회/이슈 트래커 중 오늘 바로 써야 할 것 하나만 먼저 연결하면 디버깅 시간이 크게 줄어듭니다.
| 시작 기준(추천)
1) 오늘 반복 작업이 있는 도구를 하나 고른다.
2) 해당 도구 MCP 서버를 단독으로 실행해본다.
3) Cursor 연결은 마지막에 한다.많은 분이 3번부터 시작해서 막힙니다. 반드시 2번(서버 단독 실행 확인)을 먼저 하세요.
| 2) 설정 파일은 “정확한 위치 + 절대 경로”가 핵심입니다
Cursor MCP 설정에서 가장 자주 나는 실수는 경로입니다. 상대 경로로 적어두면, 실행 컨텍스트가 바뀌는 순간 바로 깨집니다. 그래서 실무에서는 초기 세팅 때 절대 경로로 고정하는 편이 안전합니다.
{
"mcpServers": {
"my-tool": {
"command": "/usr/local/bin/node",
"args": ["/ABS/PATH/server.js"],
"env": {
"API_KEY": "..."
}
}
}
}포인트는 세 가지입니다. command 경로, args 경로, env 키 이름. 이 중 하나라도 틀리면 Cursor 쪽에서는 애매한 연결 실패처럼 보일 수 있습니다.
| 3) Cursor에서 안 될 때는, 서버 로그부터 분리해서 보세요
“Cursor에서 호출이 안 된다”는 증상은 원인이 여러 개라서, Cursor 화면만 보면 답이 안 나오는 경우가 많습니다. 그래서 서버를 단독으로 띄워 로그를 먼저 봐야 합니다.
# 예시
node /ABS/PATH/server.js
# 또는
python /ABS/PATH/server.py여기서 바로 에러가 나면 Cursor 문제가 아니라 서버 실행 문제입니다. 반대로 단독 실행은 정상인데 Cursor에서만 실패하면, 설정 파일/권한/환경변수 전달 문제일 확률이 큽니다.
| 실제로 자주 보는 오류 패턴
- command not found: 실행 파일 경로 오타
- permission denied: 실행 권한/접근 권한 부족
- unauthorized: API 키 이름 또는 값 불일치
- timeout: 서버는 떴지만 응답 규격/속도 문제이 네 가지를 먼저 지우면, 대부분 10~20분 안에 연결됩니다.
| 4) 보안은 “편하게 쓴다”보다 “안 새게 쓴다”가 우선입니다
MCP는 외부 도구와 연결되는 만큼, 키 관리가 중요합니다. 테스트 단계에서는 편의상 파일에 직접 넣고 싶어지지만, 운영으로 갈수록 위험합니다.
권장 순서는 다음과 같습니다. 로컬 테스트에서는 최소 권한 키를 쓰고, 팀 공유 환경에서는 키를 설정 파일에 하드코딩하지 않고 환경변수 또는 시크릿 스토어로 옮깁니다. 그리고 로그에 키/토큰이 남지 않도록 마스킹 규칙을 둡니다.
| 5) 팀에서 재사용하려면 “점검 체크리스트”를 같이 남겨야 합니다
나만 되게 설정해두면 다음 주에 다시 막힙니다. 팀에서 반복해서 쓸 거라면, 최소 체크리스트를 리포지토리에 남기세요.
[Cursor MCP 점검표]
- 설정 파일 위치 확인
- command/args 절대 경로 확인
- 서버 단독 실행 성공 여부
- 필수 env 전달 확인
- 권한/타임아웃 로그 확인
- 실제 Cursor 호출 테스트 완료이 체크리스트 하나만 있어도 신규 합류자가 훨씬 빨리 세팅을 끝냅니다.
| 같이 보면 좋은 글
클로드 코드 설치 방법: 맥/윈도우에서 처음 세팅할 때 막히는 부분 정리
커서 AI 사용법, 자동완성·수정 요청을 실무에 맞게 쓰는 흐름
정리하면, Cursor MCP 설정은 복잡해서 어려운 게 아니라 순서가 엉키면 어려워집니다. 서버 단독 실행 확인을 먼저 하고, 그 다음 Cursor 연결로 넘어가면 실패 확률이 확실히 줄어듭니다. 처음 세팅은 천천히, 대신 체크리스트는 확실하게 남겨두는 걸 추천합니다.