MCP 문제 해결

MCP가 안 될 때는 대개 네 가지 중 하나입니다. 위에서부터 차례로 확인하세요.

flowchart TD
   A["MCP가 안 된다"] --> B{"uv --version
이 나오나?"}
   B -->|안 나옴| B1["uv 설치 · 터미널 새로 열기"]
   B -->|나옴| C{"코워커가
설치돼 있나?"}
   C -->|아니오| C1["플러그인(Plugins) 메뉴에서 설치"]
   C -->|예| D{"자격증명을
넣었나?"}
   D -->|아니오| D1["CONNECTORS.md 대로 발급"]
   D -->|예| E["증상별 표 확인"]

오류가 아닙니다. 자격증명이 아직 없다는 안내입니다. 답변에 어떤 값이 빠졌는지 함께 나오니, 그 값을 발급받아 넣으시면 됩니다.

이 상태에서도 코워커는 초안·점검표·원고를 만들어 드립니다.

MCP 서버가 뜨지 못한 것입니다. 대개 uv 문제입니다.

1. 새 터미널에서 uv --version 확인
2. 안 나오면 설치와 설정의 1단계 다시
3. 나오는데도 안 되면 Claude Cowork(또는 ChatGPT Work)를 완전히 종료 후 재시작

잠시 후 다시 하면 됩니다. 답변에 얼마나 기다려야 하는지 함께 나옵니다.

외부 서비스는 대부분 “한 시간에 몇 번” 또는 “하루에 몇 번” 같은 호출 한도를 둡니다. 짧은 시간에 같은 조회를 반복하면 걸리기 쉬우니, 한 번 받아 온 결과를 다시 쓰도록 요청을 묶어 주세요.

서비스마다 재설정 시각이 다릅니다. 해당 서비스의 개발자 콘솔에서 남은 양과 재설정 시각을 확인하실 수 있습니다.

MCP 서버는 실패하면 스스로 몇 번 다시 시도합니다. 그래서 상대 서버가 불안정할 때 평소보다 오래 걸릴 수 있습니다. 몇 분 기다려도 끝나지 않으면 상대 서비스 자체의 장애일 가능성이 큽니다 — 해당 서비스의 상태 페이지를 확인해 보세요.

올리려는 파일 경로를 확인하세요. 전체 경로로 알려 주시는 게 확실합니다.

무엇을 시도했고 어떤 메시지가 나왔는지 함께 이슈로 남겨 주세요.

Danger

자격증명 값 자체는 절대 붙여 넣지 마세요. 오류 메시지에 값이 섞여 있다면 그 부분은 지우고 올려 주세요. 우리 MCP 서버는 오류 본문을 잘라서 담지만, 완벽하지는 않습니다.