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 pueden acotar al comando del servidor, al acceso, al espacio de trabajo o al modo seleccionado.

1. Confirme que Node.js 22 o una versión 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, llame a 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, lista de argumentos y tiempo de espera del cliente durante el arranque.
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 explícito del entorno que prevalece sobre el guardado.
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 a su equipo.

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 las páginas sobre el inicio de sesión y los ajustes 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.