¿Falla el conector de Claude? Dos errores explicados
Claude muestra dos errores principales cuando falla un conector personalizado: "Couldn't reach the MCP server" (No se pudo conectar con el servidor MCP) y "Authorization with the MCP server failed" (Falló la autorización con el servidor MCP). La mayoría de las causas están en el lado del servidor, así que los pasos útiles son pocos. Revisa que la URL sea exactamente la que te dio el servicio y que tu plan o la configuración de tu administrador permita conectores personalizados. Elimina el conector y vuelve a añadirlo. Después copia el ID de referencia que empieza por ofid_ y envíalo a quien administra el servidor.
Puntos clave
- Dos mensajes cubren la mayoría de los fallos de conexión. Un tercer mensaje, "Unexpected error while invoking tool" (Error inesperado al invocar una herramienta), significa que el conector está conectado y que falló una llamada a una herramienta.
- La página de solución de problemas de Anthropic dice que "Couldn't reach" (No se pudo conectar) "no siempre es un fallo de red" (traducción nuestra), y que la página está escrita para el desarrollador del servidor, no para ti.
- En el plan Free puedes añadir un conector personalizado. En un plan Team, solo los "Owners" (propietarios) y "Primary Owners" (propietarios principales) pueden añadir uno.
- Para cambiar la configuración de un conector personalizado, lo eliminas y lo vuelves a añadir. No hay botón de editar.
- Una URL de servidor que redirige a otro host pierde la cabecera de inicio de sesión por el camino, y Claude entonces muestra el error de autorización. Solo el dueño del servidor puede indicarte la URL correcta, y quizá tengas que volver a añadir el conector con ella.
- El ID
ofid_del error tiene tiempo límite. Cópialo justo después del fallo.
¿Qué significan los dos errores del conector de Claude?
Un conector personalizado es un servicio que añades a Claude con su URL, usando el Model Context Protocol (MCP). Claude no lo llama desde tu equipo. La página de solución de problemas de Anthropic dice que los conectores en claude.ai "se ejecutan en la infraestructura de Anthropic y llegan a tu servidor por la internet pública" (traducción nuestra). Muchos fallos vienen de ese hecho, porque el servidor tiene que ser accesible desde fuera de tu red, no solo desde ti.
La misma página enumera los mensajes y lo que cubren. Describe "Couldn't reach the MCP server" como el error que aparece "cuando Claude no puede completar el handshake de conexión" (traducción nuestra), y añade: "Pese a su redacción, no siempre es un fallo de red" (traducción nuestra). Describe "Authorization with the MCP server failed" como un error que "normalmente aparece después de que empieza el flujo OAuth" (traducción nuestra). OAuth es el estándar de inicio de sesión que usan los conectores.
| Mensaje | Cuándo aparece | Quién suele poder arreglarlo | Fuente |
|---|---|---|---|
| Couldn't reach the MCP server | Claude no puede terminar el handshake de conexión | El desarrollador del servidor (DNS, firewall, descubrimiento del inicio de sesión). Tú puedes revisar la URL que pegaste. | Solución de problemas de tu conector |
| Authorization with the MCP server failed | El flujo de inicio de sesión empieza, pero no termina, o la URL redirige a otro host | El desarrollador del servidor (configuración del inicio de sesión, redirección). Tú puedes volver a iniciar sesión o volver a añadir el conector. | Solución de problemas de tu conector |
| Unexpected error while invoking tool | El conector aparece como conectado, pero falla una llamada a una herramienta | El desarrollador del servidor. Este error no tiene ID ofid_. | Solución de problemas de tu conector |
La página es directa sobre su público: "Esta página es para el desarrollador del servidor MCP" (traducción nuestra). También dice que cada mensaje "cubre varias causas de tu lado" (traducción nuestra), donde "your" significa el desarrollador. Por eso aquí va una lista corta de comprobaciones para ti, y después una lista más larga de causas del desarrollador. La página está en claude.com/docs/connectors/building/troubleshooting.
¿Qué puedes revisar tú mismo?
Estos cinco pasos siguen la ayuda y las páginas de pruebas y solución de problemas de Anthropic. No necesitan herramientas para desarrolladores.
- Plan y rol. La página de ayuda de Anthropic dice que los conectores personalizados están disponibles "para usuarios de los planes Free, Pro, Max, Team y Enterprise" (traducción nuestra), que "los usuarios Free están limitados a un conector personalizado" (traducción nuestra), y que "solo los Owners y Primary Owners pueden añadirlos a los planes Team" (traducción nuestra). En Enterprise, la página también menciona a las personas con un rol personalizado que incluye "Manage access to Libraries" (Gestionar el acceso a las bibliotecas). Si estás en Team y no eres "Owner", pide a un Owner que lo añada.
- La URL, exactamente como la da el servicio. Pégala completa, con la ruta. Si la página del servicio indica una segunda dirección, por ejemplo una con
www.delante, usa la que el servicio indique. Una URL que redirige a otro host es una causa conocida del error de autorización (ver el ejemplo práctico más abajo). - Elimínalo y vuelve a añadirlo. La página de ayuda dice: "Si quieres editar un conector personalizado, primero tienes que eliminarlo y después volver a añadirlo con los datos actualizados" (traducción nuestra). En la web y en la aplicación de escritorio, los usuarios Pro y Max individuales encuentran los conectores en "Customize" (Personalizar) > "Connectors" (Conectores). Los "Owners" de Team y Enterprise usan "Organization settings" (Configuración de la organización) > "Connectors".
- Inicia sesión otra vez cuando Claude lo pida. La página de pruebas de Anthropic dice que un conector en funcionamiento muestra "Connected" (Conectado) en "Your connectors" (Tus conectores). Si muestra "Connect" (Conectar) o "Reconnect" (Volver a conectar), "el inicio de sesión no terminó" (traducción nuestra). Completa el paso de inicio de sesión y después vuelve a revisar el estado.
- Copia el ID
ofid_. Está en el mensaje de error y en la dirección de la página. Cópialo antes de cerrar la pestaña.
Nada en estas páginas sugiere desactivar una protección del navegador, un firewall o un paso de inicio de sesión. Si un paso te pide eso, detente y consulta al proveedor del servicio.
¿Qué solo puede arreglar el desarrollador del servidor?
Cuando las cinco comprobaciones no ayudan, la causa suele estar en la configuración del servidor. No tienes que arreglar estas causas, pero conocerlas te dice qué pedir. La tabla sigue la página de solución de problemas de Anthropic, con palabras sencillas.
| Causa | Qué hace Claude | Comprobación del desarrollador |
|---|---|---|
| El nombre de host se resuelve a una dirección privada | Rechaza la conexión antes de que salga ninguna petición de Anthropic. Los registros del servidor no ven nada. | Consulta el nombre de host desde fuera de la red. Cada dirección debe ser enrutable globalmente. |
| Un firewall o una regla contra bots bloquea a Anthropic | La petición se detiene antes de que la aplicación la vea. | Busca respuestas 403 o 429 en los registros de borde (edge). Permite el rango IP publicado de Anthropic. |
| La URL redirige a otro host | Elimina la cabecera de inicio de sesión en la redirección. El destino responde 401. Claude muestra el error de autorización. | Pide la URL y lee el destino de la redirección. Registra esa URL. |
| Faltan los datos de descubrimiento del inicio de sesión | No encuentra el servidor de autorización. Puede mostrar "Couldn't reach" aunque el endpoint sí responda. | Pide los documentos de descubrimiento desde una red pública. Deben responder 200. |
| No hay forma de registrar un cliente | No puede obtener una identidad de cliente, así que el inicio de sesión no puede empezar. | Ofrece registro dinámico de clientes, documentos de metadatos de ID de cliente o credenciales preregistradas. |
| PKCE con S256 no está soportado | El flujo falla en el endpoint de tokens. | Soporta S256 y anúncialo en los metadatos del servidor de autorización. |
| El endpoint de tokens tarda más de 10 segundos | Espera hasta 10 segundos la respuesta y luego falla, aunque el token se emita después. | Mide el manejador de tokens y cualquier proxy que esté delante de él. |
La misma página enumera más causas del error de autorización, como una discordancia de emisor, una discordancia de audiencia y fallos al renovar tokens. Su lista de diagnóstico sigue el orden en que Claude pasa cada paso. Una de sus comprobaciones es una petición simple para ver las cabeceras de redirección:
curl -sI https://your-server.example.com/your-mcp-path
Si la respuesta es un 3xx que apunta a otro host, "ese destino es la URL que debes registrar" (traducción nuestra). La página de solución de problemas dice que las peticiones salientes de Anthropic salen de un rango publicado, que Anthropic indica en su página de direcciones IP. La especificación de autorización de MCP dice que los servidores MCP deben implementar OAuth 2.0 Protected Resource Metadata, definido en RFC 9728. Esos metadatos son a lo que se refieren las filas de "descubrimiento" de arriba.
¿Qué es el ID de referencia ofid_ y quién lo recibe?
Cuando falla una conexión o un inicio de sesión en claude.ai, la página de Anthropic dice que "el mensaje de error y la URL de la página incluyen un ID de referencia que empieza por ofid_" (traducción nuestra). El ID "permite a Anthropic rastrear el fallo concreto de su lado, y tiene tiempo límite, así que repórtalo poco después del fallo" (traducción nuestra).
La vía de Anthropic para un reporte es una incidencia en el rastreador de incidencias anthropics/claude-ai-mcp, con el ID, la URL del servidor y lo que muestran los registros del servidor durante el intento. La página se dirige a desarrolladores, que sí pueden aportar esos registros. Tú no puedes. Así que el orden que sugerimos es este: envía primero el ID, el mensaje exacto y la hora al proveedor del servicio. Si el proveedor no encuentra nada de su lado, él abre la incidencia. Si la abres tú, el rastreador se puede leer sin iniciar sesión, así que omite datos personales y cualquier token.
Un fallo en una llamada a una herramienta es distinto. Anthropic dice que "no hay ID de referencia ofid_" para ese error (traducción nuestra). Un reporte de ese error incluye el nombre de la herramienta y la hora del fallo en UTC.
Ejemplo: una URL que redirige a www
Ejemplo práctico (hipotético): un servicio te pide añadir
https://example.com/mcp. Nada aquí es salida real de un servidor. Solo recorre un error desde el mensaje hasta la causa.
- Mensaje: añades la URL y pulsas Connect. Claude muestra "Authorization with the MCP server failed". Funciona para el desarrollador en MCP Inspector o en Claude Code.
- Causa: el servidor responde
301y envía a los clientes ahttps://www.example.com/mcp. La página de Anthropic explica el resto: Claude sigue la redirección, elimina la cabecera de inicio de sesión, el destino responde 401 y aparece el error de autorización. Los clientes locales "fallan rápido en una redirección" (traducción nuestra), y claude.ai no, así que el fallo aparece más tarde como error de autorización.- Comprobación:
curl -sI https://example.com/mcpdevuelve un estado 3xx y una cabeceraLocationen el hostwww..- Solución: el desarrollador confirma la URL final. Tú eliminas el conector y lo vuelves a añadir con
https://www.example.com/mcp.La página de Anthropic incluye la redirección entre las causas del error de autorización. Por eso vale la pena pedir al dueño que haga la comprobación del paso 3.
Así se explica el reporte frecuente de que un conector funciona en MCP Inspector o Claude Code, pero no en claude.ai. La página ofrece además otra razón: "la CLI y curl se conectan desde tu equipo, mientras que claude.ai se conecta desde los servidores de Anthropic" (traducción nuestra). Si un nombre de host se resuelve de forma distinta dentro y fuera de la red de una empresa, claude.ai puede obtener una dirección privada y mostrar "Couldn't reach".
ofid_ llegando al dueño del servidor. Diagrama de Remembite.¿Qué debes saber antes de conectar un conector personalizado?
Un conector personalizado puede ser cualquier servicio cuyo dueño publique una URL. La página de ayuda de Anthropic dice que los conectores personalizados conectan Claude con servicios arbitrarios que Anthropic no ha revisado. También advierte: "Los servidores MCP maliciosos pueden incluir instrucciones ocultas que intenten hacer que Claude realice acciones no previstas" (traducción nuestra).
La página da dos hábitos. Revisa cada solicitud de aprobación de herramienta antes de permitirla: "Revisa con cuidado las solicitudes de aprobación de herramientas de Claude" (traducción nuestra). Elige "Allow always" (Permitir siempre) solo para servidores y herramientas en los que confíes. Añade un conector solo cuando sepas quién administra el servicio y qué puede hacer con tus datos. La página está en Get started with custom connectors using remote MCP.
¿Y si es el conector de Remembite?
La URL del conector de Remembite es https://remembite.com/mcp. Funciona en Claude, también en la aplicación de iPhone. Remembite también funciona en ChatGPT (beta, mediante el modo desarrollador): soluciones para ChatGPT. Empieza por la guía que coincide con lo que ves:
- Conectado, pero Claude no muestra herramientas de Remembite: El conector de Remembite no muestra herramientas.
- Claude te pide conectar o autorizar otra vez: Claude pide volver a conectar Remembite.
- Primera configuración, paso a paso: conecta Remembite a Claude.
- Sigues atascado después de esas páginas: soporte de Remembite. Incluye el mensaje exacto y el ID
ofid_.
Tu IA hace los cálculos. Remembite guarda el registro. El conector es el vínculo entre las dos, así que para un recorrido por el registro de comidas con Claude lee cómo registrar comidas con Claude. Para ver cómo encajan las piezas, lee cómo funciona Remembite. Para saber qué es un servidor MCP, lee la guía del servidor MCP de nutrición.
¿Qué no cubre esta página?
- Las páginas de Anthropic cambian. Todas las citas de aquí se leyeron el 18 oct 2026. Si un nombre de menú o un límite es distinto cuando leas esto, manda la página de Anthropic.
- No reproducimos estos errores. Las causas vienen de las páginas de Anthropic y de la especificación de MCP, no de nuestras propias pruebas.
- Esta página cubre conectores personalizados. Los conectores del directorio de Anthropic son un caso aparte.
- No afirma nada sobre ningún servidor concreto, incluido si un servicio está bien administrado o sigue funcionando.
- La lista de comprobaciones para ti es corta a propósito. Solo contiene pasos que una página de Anthropic respalda.
Preguntas frecuentes
¿Por qué no funciona mi conector personalizado de Claude?
Claude llega al servidor desde la infraestructura de Anthropic, así que una dirección privada, una regla de firewall, una redirección o un problema de configuración del inicio de sesión en el servidor pueden impedirlo. Revisa tu plan, la URL exacta y si el inicio de sesión terminó. Luego vuelve a añadir el conector y envía el ID ofid_ al dueño del servidor.
¿Por qué funciona en Claude Code o MCP Inspector, pero no en Claude?
Anthropic dice que las herramientas locales se conectan desde tu equipo y que claude.ai se conecta desde los servidores de Anthropic. Un nombre de host que se resuelve de forma distinta fuera de tu red, o una URL que redirige a otro host, aparece solo en claude.ai.
¿Qué es el ID ofid_ del error?
Es un ID de referencia en el mensaje de error y en la URL de la página, que permite a Anthropic rastrear una conexión fallida. Tiene tiempo límite, así que cópialo poco después del fallo y entrégaselo al proveedor del servicio.
¿Necesito un plan de pago para añadir un conector personalizado?
La página de ayuda de Anthropic, leída el 18 oct 2026, incluye los planes Free, Pro, Max, Team y Enterprise. Free está limitado a un conector personalizado. Las reglas de los planes pueden cambiar, así que revisa la página.
¿Por qué no puedo añadir un conector en un plan Team?
La página de ayuda dice que solo los "Owners" (propietarios) y "Primary Owners" (propietarios principales) pueden añadir conectores personalizados a los planes Team. Pide a un Owner que lo añada en "Organization settings" > "Connectors".
Son estimaciones, no consejo médico. Cómo funcionan los números.