Claude 커넥터가 작동하지 않나요? 두 가지 오류 설명

Claude는 커스텀 커넥터가 실패할 때 두 가지 주요 오류를 보여줘요. 하나는 "Couldn't reach the MCP server"("MCP 서버에 연결할 수 없음")이고, 다른 하나는 "Authorization with the MCP server failed"("MCP 서버 인증 실패")예요. 대부분의 원인은 서버 쪽에 있으므로, 사용자가 할 일은 짧아요. URL이 서비스가 준 그대로인지, 요금제나 관리자 설정이 커스텀 커넥터를 허용하는지 확인하세요. 커넥터를 지운 뒤 다시 추가하세요. 그다음 ofid_로 시작하는 참조 ID를 복사해서 서버를 운영하는 사람에게 보내세요.

핵심 요약

연결 실패 대부분은 두 메시지로 나타나요. "Unexpected error while invoking tool"은 커넥터는 연결되어 있지만 도구 호출 한 번이 실패했다는 뜻이에요.
Anthropic의 문제 해결 페이지는 "Couldn't reach"가 "항상 네트워크 실패는 아니라고" 하며, 이 페이지는 사용자가 아니라 서버 개발자를 위해 쓰였다고 밝혀요.
무료 요금제에서는 커스텀 커넥터를 하나 추가할 수 있어요. Team 요금제에서는 소유자와 기본 소유자만 추가할 수 있어요.
커스텀 커넥터의 설정을 바꾸려면 지운 뒤 다시 추가해야 해요. 편집 버튼은 없어요.
다른 호스트로 리디렉션되는 서버 URL은 가는 길에 인증 헤더를 잃고, 그러면 Claude는 인증 오류를 표시해요. 올바른 URL은 서버 소유자만 알려 줄 수 있고, 그 URL로 커넥터를 다시 추가해야 할 수도 있어요.
오류에 나오는 ofid_ ID는 시간이 지나면 만료돼요. 실패 직후에 복사하세요.

사용자에서 Claude를 거쳐 서버까지 가는 경로와 오류 지점 — 연결 경로와 두 오류가 나타나는 위치: A는 "Couldn't reach", B는 "Authorization failed"예요. 이 대응은 단순화한 것이라, 일부 원인에서는 다른 메시지가 나와요. 도식: Remembite.

Claude 커넥터의 두 오류는 무엇을 뜻하나요?

커스텀 커넥터는 Model Context Protocol(MCP)을 써서 URL로 Claude에 추가하는 서비스예요. Claude는 사용자의 노트북에서 이를 호출하지 않아요. Anthropic의 문제 해결 페이지는 claude.ai의 커넥터가 "Anthropic 인프라에서 실행되고 공용 인터넷을 거쳐 서버에 닿는다"고 설명해요(우리 번역). 많은 실패가 이 사실에서 나와요. 서버는 사용자만이 아니라 사용자 네트워크 밖에서도 닿을 수 있어야 해요.

같은 페이지는 메시지와 그 범위를 나열해요. "Couldn't reach the MCP server"는 "Claude가 연결 핸드셰이크를 끝내지 못할 때" 나타난다고 설명하고, "Despite the wording, it isn't always a network failure."(우리 번역: 문구와 달리 항상 네트워크 실패는 아니에요)라고 덧붙여요. "Authorization with the MCP server failed"는 "보통 OAuth 흐름이 시작된 뒤에" 나타나는 오류라고 설명해요. OAuth는 커넥터가 쓰는 로그인 표준이에요.

메시지	나타나는 때	보통 고칠 수 있는 사람	출처
Couldn't reach the MCP server	Claude가 연결 핸드셰이크를 끝내지 못함	서버 개발자(DNS, 방화벽, 로그인 검색). 사용자는 붙여 넣은 URL을 확인할 수 있어요.	Troubleshoot your connector
Authorization with the MCP server failed	로그인 흐름은 시작했지만 끝나지 않거나, URL이 다른 호스트로 리디렉션됨	서버 개발자(로그인 설정, 리디렉션). 사용자는 다시 로그인하거나 커넥터를 다시 추가할 수 있어요.	Troubleshoot your connector
Unexpected error while invoking tool	커넥터는 연결된 것으로 보이지만 도구 호출이 실패함	서버 개발자. 이 오류에는 `ofid_` ID가 없어요.	Troubleshoot your connector

이 페이지는 독자를 분명히 밝혀요: "This page is for the developer of the MCP server."(우리 번역: 이 페이지는 MCP 서버 개발자를 위한 것이에요). 또 각 메시지가 "여러 원인을 포함하며, 그 원인은 개발자 쪽에 있다"고 말해요(우리 번역). 그래서 아래에는 사용자가 확인할 짧은 목록이 나오고, 그다음에 개발자 쪽 원인의 긴 목록이 나와요. 이 페이지는 claude.com/docs/connectors/building/troubleshooting에 있어요.

사용자가 직접 확인할 수 있는 것은 무엇인가요?

아래 다섯 단계는 Anthropic의 도움말, 테스트, 문제 해결 페이지를 따라요. 개발자 도구는 필요 없어요.

요금제와 역할. Anthropic 도움말 페이지는 커스텀 커넥터가 "Free, Pro, Max, Team, Enterprise 요금제 사용자"에게 제공되며, "Free 사용자는 커스텀 커넥터를 하나로 제한된다"고, 그리고 "Team 요금제에서는 소유자와 기본 소유자만 추가할 수 있다"고 설명해요(우리 번역). Enterprise에서는 이 페이지가 Libraries 접근 관리를 포함한 커스텀 역할을 가진 사람도 함께 나열해요. Team 요금제에서 소유자가 아니라면, 소유자에게 추가를 부탁하세요.
서비스가 준 그대로의 URL. 경로까지 포함해서 전부 붙여 넣으세요. 서비스 페이지에 두 번째 주소가 있다면, 예를 들어 앞에 www.가 붙은 주소라면, 서비스가 쓰라고 한 주소를 쓰세요. 다른 호스트로 리디렉션되는 URL은 인증 오류의 알려진 원인이에요(아래 계산 예시를 보세요).
지운 뒤 다시 추가하세요. 도움말 페이지는 이렇게 말해요: "If you're hoping to edit a custom connector, you'll need to remove it first, then re-add it using the updated details."(우리 번역: 커스텀 커넥터를 수정하려면 먼저 지우고, 새 정보로 다시 추가하세요). 웹과 데스크톱에서 개별 Pro 및 Max 사용자는 "Customize"(사용자 정의) > "Connectors"(커넥터)에서 찾을 수 있어요. Team과 Enterprise 소유자는 "Organization settings"(조직 설정) > "Connectors"(커넥터)를 써요.
Claude가 요청하면 다시 로그인하세요. Anthropic의 테스트 페이지는 정상 커넥터가 "Your connectors" 아래 "Connected"(연결됨)로 나온다고 설명해요. 대신 "Connect"(연결)나 "Reconnect"(다시 연결)가 나오면 "sign-in didn't finish"(로그인이 끝나지 않음)를 뜻해요(우리 번역). 로그인 단계를 끝낸 뒤 상태를 다시 확인하세요.
ofid_ ID를 복사하세요. 이 ID는 오류 메시지와 페이지 주소에 있어요. 탭을 닫기 전에 복사하세요.

커넥터가 실패할 때 직접 할 수 있는 다섯 가지 확인 — 다섯 가지 확인을 순서대로 보여줘요. 모두 Anthropic의 도움말 및 테스트 페이지에서 가져왔어요. 도식: Remembite.

이 페이지들 어디에서도 브라우저 보호 기능, 방화벽, 로그인 단계를 끄라고 하지 않아요. 어떤 단계가 그것을 요구한다면 멈추고 서비스 제공자에게 물어보세요.

서버 개발자만 고칠 수 있는 것은 무엇인가요?

다섯 가지 확인으로 해결되지 않으면, 원인은 보통 서버 설정에 있어요. 사용자가 이것을 고칠 필요는 없지만, 무엇을 요청할지 알 수 있어요. 아래 표는 Anthropic의 문제 해결 페이지를 쉬운 말로 옮긴 것이에요.

원인	Claude가 하는 일	개발자 확인
호스트 이름이 사설 주소로 풀림	Anthropic에서 요청이 나가기 전에 연결을 거부해요. 서버 로그에는 아무것도 남지 않아요.	네트워크 밖에서 호스트 이름을 조회하세요. 모든 주소는 전 세계에서 라우팅 가능해야 해요.
방화벽이나 봇 규칙이 Anthropic을 막음	요청이 애플리케이션에 닿기 전에 멈춰요.	엣지 로그에서 403 또는 429 응답을 찾으세요. Anthropic이 공개한 IP 범위를 허용하세요.
URL이 다른 호스트로 리디렉션됨	리디렉션에서 로그인 헤더를 버려요. 대상은 401로 응답해요. Claude는 인증 오류를 표시해요.	URL을 요청해 리디렉션 대상을 읽으세요. 그 URL을 등록하세요.
로그인 검색 데이터가 없음	인증 서버를 찾지 못해요. 엔드포인트 자체는 응답해도 "Couldn't reach"가 나올 수 있어요.	공개 네트워크에서 검색 문서를 요청하세요. 200을 반환해야 해요.
클라이언트를 등록할 방법이 없음	클라이언트 신원을 얻지 못해 로그인을 시작할 수 없어요.	동적 클라이언트 등록, 클라이언트 ID 메타데이터 문서 또는 사전 등록 자격 증명을 제공하세요.
S256을 쓰는 PKCE를 지원하지 않음	토큰 엔드포인트에서 흐름이 실패해요.	S256을 지원하고 인증 서버 메타데이터에 알리세요.
토큰 엔드포인트가 10초를 넘게 걸림	응답을 최대 10초 기다리다 실패해요. 토큰이 나중에 발급되어도 마찬가지예요.	토큰 핸들러와 그 앞의 프록시 시간을 측정하세요.

같은 페이지는 인증 오류의 원인도 더 나열해요. 예를 들어 발급자 불일치, 대상(audience) 불일치, 토큰 갱신 실패가 있어요. 이 페이지의 진단 체크리스트는 Claude가 각 단계를 만나는 순서대로 진행돼요. 그중 하나는 리디렉션 헤더를 바로 요청하는 것이에요:

curl -sI https://your-server.example.com/your-mcp-path

응답이 다른 호스트를 가리키는 3xx라면 "그 대상이 등록해야 할 URL"이에요(우리 번역). 문제 해결 페이지는 Anthropic의 외부 요청이 공개된 범위에서 나온다고 말하며, 그 범위는 IP 주소 페이지에 있어요. MCP 인증 명세는 MCP 서버가 RFC 9728에 정의된 OAuth 2.0 Protected Resource Metadata를 "MUST implement"(반드시 구현해야 함)한다고 해요(우리 번역). 위 표의 "검색" 행이 바로 이 메타데이터를 가리켜요.

ofid_ 참조 ID는 무엇이고, 누가 받나요?

claude.ai에서 연결이나 로그인이 실패하면, Anthropic 페이지는 "오류 메시지와 페이지 URL에 ofid_로 시작하는 참조 ID가 포함된다"고 설명해요(우리 번역). 이 ID는 "Anthropic이 실패를 자기 쪽에서 추적할 수 있게 하고, 시간이 지나면 만료되므로 실패 직후 빨리 보고하라"고 해요(우리 번역).

보고 경로는 anthropics/claude-ai-mcp 이슈 트래커예요. 여기에 ID, 서버 URL, 시도 중 서버 로그에 나온 내용을 적으면 돼요. 이 페이지는 로그를 제공할 수 있는 개발자를 대상으로 해요. 사용자는 로그를 볼 수 없어요. 그래서 권장 순서는 이래요. ID, 정확한 메시지, 시간을 먼저 서비스 제공자에게 보내세요. 제공자가 자기 쪽에서 아무것도 찾지 못하면 제공자가 이슈를 올려요. 직접 올린다면, 이 트래커는 로그인 없이 읽을 수 있으니 개인 정보와 토큰은 빼세요.

도구 호출 실패는 달라요. Anthropic은 이 오류에 대해 "there is no ofid_ reference ID"(ofid_ 참조 ID가 없음)라고 밝혀요(우리 번역). 이 오류 보고에는 도구 이름과 실패 시각(UTC)을 적으세요.

예시: www로 리디렉션되는 URL

계산 예시(가설): 서비스가 https://example.com/mcp를 추가하라고 했다고 가정해요. 여기의 내용은 실제 서버 출력이 아니에요. 한 가지 오류를 메시지에서 원인까지 따라갈 뿐이에요.

메시지: URL을 추가하고 Connect를 누르면 Claude가 "Authorization with the MCP server failed"를 표시해요. 개발자의 MCP Inspector나 Claude Code에서는 잘 작동해요.

원인: 서버가 301로 응답하며 클라이언트를 https://www.example.com/mcp로 보내요. Anthropic 페이지가 나머지를 설명해요. Claude는 리디렉션을 따라가며 로그인 헤더를 버리고, 대상이 401로 응답하면서 인증 오류가 나와요. 로컬 클라이언트는 리디렉션에서 "빠르게 실패"하지만, claude.ai는 그렇지 않아서 실패가 나중에 인증 오류로 나타나요(우리 번역).

확인: curl -sI https://example.com/mcp가 3xx 상태와 www. 호스트를 가리키는 Location 헤더를 반환해요.

해결: 개발자가 최종 URL을 확인해요. 사용자는 커넥터를 지운 뒤 https://www.example.com/mcp로 다시 추가해요.

Anthropic 페이지는 리디렉션을 인증 오류의 원인으로 나열해요. 그러므로 3단계 확인은 소유자에게 실행을 부탁할 가치가 있어요.

이것은 흔한 제보, 즉 커넥터가 MCP Inspector나 Claude Code에서는 작동하지만 claude.ai에서는 작동하지 않는다는 문제를 설명해 줘요. 페이지는 두 번째 이유도 알려요. "the CLI and curl connect from your machine, while claude.ai connects from Anthropic's servers."(우리 번역: CLI와 curl은 사용자의 컴퓨터에서 연결하고, claude.ai는 Anthropic 서버에서 연결해요). 호스트 이름이 회사 네트워크 안팎에서 다르게 풀리면, claude.ai는 사설 주소를 받아 "Couldn't reach"를 표시할 수 있어요.

오류 메시지에서 누가 고치는지까지 가는 판단 도식 — 메시지에서 첫 번째 조치까지 가는 흐름이에요. 두 경로 모두 `ofid_` ID를 서버 소유자에게 보내며 끝나요. 도식: Remembite.

커스텀 커넥터를 연결하기 전에 무엇을 알아야 하나요?

커스텀 커넥터는 소유자가 URL을 공개한 어떤 서비스든 될 수 있어요. Anthropic 도움말 페이지는 커스텀 커넥터가 Anthropic이 검토하지 않은 임의의 서비스에 Claude를 연결한다고 설명해요. 또 이렇게 경고해요: "Malicious MCP servers may include hidden instructions that try to make Claude perform unintended actions."(우리 번역: 악성 MCP 서버는 Claude가 의도하지 않은 행동을 하도록 숨겨진 지시를 넣을 수 있어요)

이 페이지는 두 가지 습관을 권해요. 허용하기 전에 각 도구 승인 요청을 검토하세요. "Review Claude's tool approval requests carefully"(우리 번역: Claude의 도구 승인 요청을 신중히 검토하세요). "Allow always"(항상 허용)는 신뢰하는 서버와 도구에만 선택하세요. 서비스를 누가 운영하고 그것이 사용자의 데이터로 무엇을 할 수 있는지 알 때만 커넥터를 추가하세요. 페이지는 Get started with custom connectors using remote MCP에 있어요.

Remembite 커넥터라면 어떻게 하나요?

Remembite 커넥터 URL은 https://remembite.com/mcp예요. iPhone 앱을 포함해 Claude에서 작동해요. Remembite는 ChatGPT(beta, 개발자 모드 경유)에서도 작동해요: ChatGPT 해결 방법. 보이는 증상에 맞는 가이드부터 시작하세요:

연결되었지만 Claude에 Remembite 도구가 없음: Remembite 커넥터에 도구가 보이지 않을 때.
Claude가 다시 연결하거나 승인하라고 요청함: Claude가 Remembite를 다시 연결하라고 할 때.
처음 설정, 단계별로: Remembite를 Claude에 연결하기.
이 페이지들을 본 뒤에도 해결되지 않음: Remembite 지원. 정확한 메시지와 ofid_ ID를 함께 보내세요.

AI가 계산하고, Remembite는 기록을 보관해요. 커넥터가 둘을 잇는 연결고리이므로, 식사 기록 과정을 보려면 Claude로 식사 기록하기를 읽으세요. 각 부분이 어떻게 맞물리는지는 Remembite 작동 방식을 보세요. MCP 서버가 무엇인지는 영양 MCP 서버 가이드를 보세요.

이 페이지가 다루지 않는 것은 무엇인가요?

Anthropic의 페이지는 바뀌어요. 여기의 모든 인용문은 2026-10-18에 읽은 내용이에요. 메뉴 이름이나 한도가 여러분이 읽을 때 다르다면, Anthropic 페이지가 우선해요.
우리는 이 오류를 재현하지 않았어요. 원인은 Anthropic 페이지와 MCP 명세에서 가져왔고, 우리 자체 테스트에서 나온 것이 아니에요.
이 페이지는 커스텀 커넥터를 다뤄요. Anthropic 디렉터리의 커넥터는 별도의 경우예요.
특정 서버에 대해서는 주장하지 않아요. 어떤 서비스가 잘 운영되는지, 계속 가동되는지도 포함해요.
사용자 확인 목록은 일부러 짧아요. Anthropic 페이지가 뒷받침하는 단계만 담았어요.

자주 묻는 질문

Claude 커스텀 커넥터가 작동하지 않는 이유는 무엇인가요?

Claude는 Anthropic의 인프라에서 서버에 접속해요. 그래서 서버 쪽의 사설 주소, 방화벽 규칙, 리디렉션, 로그인 설정 문제 중 어느 것이든 연결을 막을 수 있어요. 요금제, 정확한 URL, 로그인이 끝났는지 확인한 뒤 커넥터를 다시 추가하고, ofid_ ID를 서버 소유자에게 보내세요.

Claude Code나 MCP Inspector에서는 되는데 Claude에서는 안 되는 이유는 무엇인가요?

Anthropic은 로컬 도구가 사용자의 컴퓨터에서 연결하고, claude.ai는 Anthropic 서버에서 연결한다고 말해요. 사용자 네트워크 밖에서 다르게 풀리는 호스트 이름이나 다른 호스트로 리디렉션되는 URL은 claude.ai에서만 드러나요.

오류의 ofid_ ID는 무엇인가요?

오류 메시지와 페이지 URL에 있는 참조 ID예요. Anthropic이 실패한 연결을 추적할 수 있게 해요. 시간이 지나면 만료되므로, 실패 후 빨리 복사해서 서비스 제공자에게 주세요.

커스텀 커넥터를 추가하려면 유료 요금제가 필요한가요?

Anthropic 도움말 페이지는 2026-10-18에 읽은 기준으로 Free, Pro, Max, Team, Enterprise 요금제를 나열해요. Free는 커스텀 커넥터가 하나로 제한돼요. 요금제 규칙은 바뀔 수 있으니 페이지를 확인하세요.

Team 요금제에서 커넥터를 추가할 수 없는 이유는 무엇인가요?

도움말 페이지는 Team 요금제에서 커스텀 커넥터를 추가할 수 있는 사람은 소유자와 기본 소유자뿐이라고 말해요. 소유자에게 "Organization settings"(조직 설정) > "Connectors"(커넥터)에서 추가해 달라고 부탁하세요.

추정값이며 의학적 조언이 아니에요. 숫자가 계산되는 방식.