MCP 커넥터가 추가했는데 도구가 안 보이거나, 연결이 타임아웃되거나, "승인 필요"가 뜨는 경우가 있습니다. 대부분은 몇 가지 정해진 원인에서 비롯됩니다. 이 글은 증상별로 원인을 좁혀 해결하는 순서를 정리합니다. 모든 설명은 Anthropic 공식 커넥터 도움말 기준입니다. (기준 시점: 2026년 6월)
먼저 알아야 할 것: 원격 커넥터는 클라우드에서 접속
가장 많은 오해이자 가장 흔한 원인입니다. 커스텀(원격) MCP 커넥터는 내 기기가 아니라 Anthropic 클라우드 인프라에서 내 MCP 서버로 접속합니다. Claude 웹·Desktop·Cowork·모바일 모두 동일합니다. 즉 Desktop이나 Cowork가 내 컴퓨터에서 돌아가더라도, 서버 연결은 Anthropic 서버에서 시작됩니다. 따라서 서버가 공개 인터넷에서 닿아야 하며, 사내 방화벽·VPN·사설망 뒤에 있으면 연결이 실패합니다. 이 경우 방화벽에서 Anthropic IP 범위를 허용목록에 추가해야 합니다.
진단 순서
- 원격인가 로컬인가: URL로 추가하는 커스텀 커넥터(원격)인지, npx·pip로 설치하는 로컬 서버인지 구분합니다. 로컬 stdio 서버는 Claude Desktop·Claude Code에서 동작하며, 웹·모바일은 원격만 지원합니다.
- 공개 인터넷에서 닿는가: 원격이라면 서버 URL이 외부에서 접근 가능한지 확인합니다. 내 PC에서만 열리고 외부에서 막혀 있으면 Anthropic 클라우드가 닿지 못합니다.
- 인증을 통과했는가: 대부분의 커스텀 커넥터는 OAuth 로그인·권한 동의 과정을 거칩니다. 조직 환경이면 관리자 동의(admin consent)가 끝났는지 확인합니다.
- 채팅에서 켰는가: 커넥터를 계정에 추가해도 모든 대화에 자동 적용되지 않습니다. 채팅 입력창의 + 버튼 → 커넥터 추가 → 쓰려는 커넥터를 토글 ON 해야 도구가 나타납니다.
증상별 원인
- 연결 시도 후 타임아웃 → 서버가 공개 인터넷에서 닿지 않음(방화벽·VPN·사설망). Anthropic IP 허용목록 설정이 필요할 수 있습니다.
- "승인 필요(Need admin approval)" → 조직 관리자 동의가 끝나지 않음. 조직 커넥터 추가는 소유자(Owner)만 가능합니다.
- 커넥터는 추가됐는데 도구가 안 보임 → 해당 대화에서 커넥터 토글이 꺼져 있음. + 버튼에서 켭니다.
- Free 플랜에서 추가가 막힘 → 무료 사용자는 커스텀 커넥터 1개로 제한됩니다(이 기능은 베타).
- Claude Desktop에서 원격 서버가 안 잡힘 → 원격 서버는 설정의 커넥터 메뉴에서 추가해야 하며, 설정 파일(claude_desktop_config.json)로 직접 넣은 원격 서버는 연결되지 않습니다.
참고: Claude는 SSE 및 Streamable HTTP 기반 원격 서버, authless·OAuth 서버를 모두 지원합니다. 다만 SSE 지원은 향후 단계적으로 종료될 수 있다고 공식 문서가 안내합니다. 서버가 오래된 전송 방식만 쓴다면 이 점을 확인하세요.
연결 전 보안 확인
커스텀 커넥터는 Anthropic이 검증하지 않은 임의 서비스에 Claude를 연결할 수 있습니다. 연결하면 내 권한 범위 안에서 해당 서비스의 데이터를 읽고 수정할 권한을 Claude에 부여하는 셈이므로, 신뢰하는 서버만 연결하세요. 특히 외부 콘텐츠를 가져오는 서버는 프롬프트 인젝션 위험이 있습니다. OAuth 동의 화면에서 요청하는 권한 범위를 추가 전에 확인하는 습관이 안전합니다.
함께 보면 좋은 글
커넥터를 어디서 찾는지는 MCP 서버를 어디서 찾나, 연결 방법은 MCP 연결·사용법, 개념은 MCP란 무엇인가에서 다룹니다.
참고: 본 글은 Anthropic 공식 커넥터 도움말(2026년 6월 열람 기준)을 바탕으로 작성되었으며, 플랜 제약·지원 전송 방식·동작은 이후 변동될 수 있습니다. 본 사이트는 Anthropic 공식 사이트가 아닙니다.