Resolver problemas de conexión MCP

Compruebe la conexión antes de modificar el proyecto. La mayoría de los problemas de configuración se deben al comando del servidor, al acceso, al espacio de trabajo o al modo seleccionado.

1. Confirme que Node.js 22 o posterior y npx estén disponibles en el entorno del proceso del cliente.
2. Compruebe que la entrada owlmeans utilice el formato de configuración que espera el cliente.
3. Reinicie el cliente después de guardar la configuración o cambiar la preferencia de inferencia.
4. Revise el estado de la conexión con el servidor y, a continuación, invoque session_status.
5. Complete el inicio de sesión en el navegador si el acceso ha caducado o se ha revocado.
6. Verifique el destino, el modo de inferencia y el espacio de trabajo antes de volver a intentar la acción prevista.

Síntoma	Siguiente comprobación
El servidor no se inicia	Ruta del comando, arreglo de argumentos y tiempo que espera el cliente al iniciar el servidor.
Faltan herramientas	Lista de herramientas del host conectado, destino y modo de inferencia.
Los archivos locales no son los correctos	Raíces MCP y directorio del proyecto indicado explícitamente.
Acceso denegado	Cuenta, entidad de la organización, caducidad del token y token definido mediante una variable de entorno que sustituye al configurado.
El trabajo delegado queda en espera	Gestión de tareas del agente y preguntas pendientes.
La generación parece haberse detenido	Estado del proyecto o de la ejecución existente antes de volver a enviar la solicitud.

Utilice una conexión stdio para la ejecución local o la inferencia delegada. El endpoint alojado no puede acceder al equipo de trabajo.

Al informar de un problema, incluya el cliente, el error visible, el modo seleccionado y la información de estado que no contenga secretos. No comparta archivos de credenciales, tokens de acceso ni URL de conexión privadas. Consulte Inicio de sesión y Configuración de la CLI.

Nombres y marcas

OpenAI, ChatGPT y las marcas relacionadas con OpenAI pertenecen a OpenAI; Codex es un producto de OpenAI. Política de uso.

Claude y Claude Code son productos de Anthropic; sus nombres y marcas siguen perteneciendo a su respectivo titular. Política de uso.

Los nombres Node.js y npx y las marcas asociadas siguen perteneciendo a sus respectivos titulares o a los responsables de los proyectos. Las referencias identifican productos, estándares o ejemplos de código fuente. La documentación de OwlMeans no implica patrocinio ni respaldo por parte de esos titulares.