¿MCP conectado pero no funciona? Diagnostica cada etapa en Mono
Distingue problemas de transporte, autorización, descubrimiento, compatibilidad del modelo y ejecución de herramientas, y verifica una operación inocua.
Que un servidor MCP esté guardado no significa que la herramienta funcione. La dirección puede ser correcta aunque el inicio de sesión no haya terminado. El inicio de sesión puede funcionar y aun así fallar la carga de las herramientas del servidor. Y una herramienta puede cargarse y recibir igualmente una petición incorrecta. Encuentra el primer paso que falla antes de cambiar ningún ajuste.
Esta guía trata la resolución de problemas en Mono de Reunified, que aún no está disponible (apúntate a la lista de espera). Para una primera conexión, usa la guía de conexión MCP. Aquí el objetivo es convertir un vago «no funciona» en una observación clara que puedas repetir, sin repetir por accidente una escritura.
1. Anota el síntoma y evita repetir operaciones inciertas
Anota el nombre del servidor, el transporte, el dispositivo, la versión de la app, lo que intentabas hacer y el error exacto, sin datos secretos. Indica si la misma configuración funcionaba antes y qué ha cambiado desde entonces. «La lista de herramientas está vacía después de iniciar sesión» es más útil que «MCP no funciona».
Si la última petición podía crear, enviar o actualizar algo, revisa el destino antes de reintentar. Que se pierda la respuesta no significa que la acción no ocurriera. Para probar, pasa a una petición pequeña de solo lectura, como listar un elemento de un proyecto de prueba que puedas comprobar.
Guarda en privado una copia de los últimos ajustes que funcionaban. No pegues tokens, códigos de autorización ni resultados privados de herramientas en una consulta pública de soporte.
2. Comprueba el transporte antes que la cuenta
Una conexión HTTP en Mono necesita la dirección de un servidor MCP, no una página de inicio normal ni la dirección de la API de un modelo. Compara la URL completa, incluida la ruta, con la documentación actual de quien publica el servidor. Que una página se abra en el navegador solo demuestra que esa página es accesible, no que MCP funcione allí.
Con Entrada/salida estándar (stdio), revisa el comando y los argumentos en el dispositivo que tiene que iniciarlos. Volver a iniciar sesión no arregla un comando que falta ni un dispositivo que no puede ejecutarlo. Los teléfonos y los ordenadores son distintos, así que no esperes que un comando de escritorio funcione en un teléfono.
Una dirección con localhost apunta al dispositivo que hace la petición. Prueba desde el dispositivo real, por una ruta compatible y con sesión iniciada. No debilites los controles de acceso de un servidor que funciona solo para que pase una prueba.
3. Distingue guardar ajustes de completar la autorización
Comprueba qué método de autenticación elegiste. Un Token Bearer necesita el token correcto del servicio en su campo. OAuth necesita la cuenta correcta, los requisitos del servidor y una vuelta completa a Mono; cerrar el navegador antes de tiempo no es un inicio de sesión correcto.
Mono puede guardar un servidor antes de que termine el inicio de sesión, así que un servidor guardado no demuestra que el inicio de sesión funcionara. Incluso después de iniciar sesión bien, la carga de las herramientas puede fallar durante un tiempo. Ni una entrada guardada ni un mensaje de «Se ha conectado» demuestran que una herramienta concreta esté lista.
Si cambias la URL o el transporte del servidor, Mono lo trata como una conexión nueva, así que puede que tengas que volver a iniciar sesión. Corrige un error real en la dirección, pero no cambies una y otra vez una URL que funciona como si fuera un reinicio general. Sigue los ajustes de cliente y redirección documentados por quien publica el servidor en vez de adivinar valores.
4. Revisa las capacidades y el modelo seleccionado
La arquitectura MCP distingue herramientas, recursos y prompts. Un servidor puede ofrecer solo algunos, así que un servidor que solo ofrece recursos no le dará al asistente ninguna herramienta que llamar.
En una habilidad MCP instalada, abre su sección Configuración para ver las herramientas que encontró Mono. Si está vacía, revisa el inicio de sesión y si el servidor muestra sus herramientas; no des por hecho que todas las acciones del servicio están disponibles. Guardar un servidor no es una revisión completa de su estado.
Revisa también el modelo que usa el chat. No todos los modelos pueden llamar herramientas, incluidos algunos que conectas tú. Un modelo que responde bien con texto puede ser, aun así, la razón de que una herramienta conectada nunca se use. La guía de endpoints personalizados lo explica.
5. Prueba una operación conocida
Usa una petición inofensiva y compara el resultado con el servicio original:
Lee el título del elemento de demostración existente que te indique.
No crees, edites, envíes ni elimines nada.
Si falla el acceso, informa del fallo en lugar de adivinar el título.| Lo que ves | Qué revisar después |
|---|---|
| No se conecta a la dirección | Dirección, transporte, red del dispositivo y si el servidor está activo |
| El inicio de sesión no termina | Cuenta, método de autenticación y requisitos OAuth de quien publica el servidor |
| No aparecen herramientas | Qué ofrece el servidor, si sus herramientas se cargaron y si el modelo admite herramientas |
| Falla una herramienta | Datos necesarios, permisos del servicio y error devuelto |
| La lectura funciona y la escritura se bloquea | El acceso que querías dar y el permiso de la herramienta; no lo abras todo |
El error propio de una herramienta no es lo mismo que un resultado vacío pero correcto. Guarda juntos el estado devuelto y el texto relevante, sin datos secretos.
6. Verifica la solución y conserva un registro
Cambia una sola cosa cada vez, repite la misma prueba de solo lectura y anota el resultado. Si más adelante necesitas una escritura, revisa su destino exacto y confirma el resultado en el servicio antes de volver a intentarlo.
Guarda una nota breve con el paso que falla, las versiones, el cambio que hiciste y la última prueba correcta. Quitar una conexión en Mono y revocar el acceso en el proveedor son pasos distintos. Para decidir permisos durante el uso, lee cómo revisar permisos de herramientas; aprobar peticiones una y otra vez no arregla una conexión.
