커서 MCP가 연결되지 않는 가장 흔한 문제는 도구 자체가 아니라 구성과 전송의 불일치입니다. 공식 커서 MCP 문서는 MCP를 'stdio', 'SSE', 'Streamable HTTP' 세 가지 유형으로 나누며, 이들은 로컬, 원격, 인증, 입력 형식에 대해 서로 다른 요구사항을 가집니다. 공식 문서: 커서 MCP.
가장 오류가 잦은 영역들을 살펴보겠습니다
로컬 MCP를 사용한다면, 'mcp.json'의 명령어는 커서가 접근할 수 있는 환경에서 실행될 수 있어야 합니다; 원격 MCP를 사용할 경우, URL, 인증 헤더, 엔드포인트가 일관되어야 합니다. 많은 사람들이 '이미 설정된 것 같다'고 느끼며 실제로 서비스를 설정했지만, 커서가 올바른 전송이나 토큰을 받지 못했습니다.
그 관계자는 또 무엇을 상기시켰나요?
커서 노트에는 MCP가 실행 가능한 명령어로 'stdout'으로 출력하거나 HTTP 엔드포인트를 노출해야 한다고 언급되어 있습니다. 즉, 서버 측의 쓰기, 로그 출력, 인증 작업이 잘못될 수 없습니다. 작은 디테일 하나가 잘못되었고, 커서는 아마도 그것을 쓸모 있는 도구로 취급하지 않을 것입니다.
문제 해결 순서
- 커서가 'mcp.json'을 읽는지 확인하세요.
- 올바른 전송 방법을 선택하는지 꼭 확인하세요.
- 인증 토큰, 환경 변수, 엔드포인트를 확인하세요.
- 원격 서비스라면 먼저 터미널에서 최소 요청으로 통과 가능한지 확인하세요.
많은 MCP가 연결되어 있지 않아, 본질적으로 "서버가 실행 중"이고 "커서가 실제로 연결되고 있다"는 바로 한 단계 차이입니다. 이 단계를 채우면 보통 문제가 사라집니다.
