Solución de problemas
Identifique si el problema es el acceso a la conexión, los permisos de las herramientas o el servicio ascendente.
Traducido automáticamente del inglés. Leer el original en inglés
Lectura de 2 minutos · Guía del cliente
Comience por identificar la etapa fallida: agregar la conexión, descubrir herramientas, ejecutar una herramienta o verificar una escritura. Capture la hora y una breve descripción antes de cambiar la configuración.
No se puede alcanzar la conexión#
Verifique el punto final asignado exacto y si el cliente de IA admite su método de transporte y autenticación. La dirección particular de una plataforma no es un punto final de MCP. Utilice la conexión segura normal; no omita una advertencia de certificado.
Si la misma conexión asignada funcionó anteriormente, informe cuándo tuvo éxito por última vez y qué cambió en el cliente. Evite eliminar los detalles de la conexión que funciona antes de que se verifique un reemplazo.
Referencia de error#
| Síntoma | Que comprobar |
|---|---|
401 en la conexión o descubrimiento | Credencial faltante, incorrecta, vencida o revocada; encabezado o punto final incorrecto. |
403 para una operación | Alcance de la credencial, permiso de herramienta o función de servicio ascendente; identificar qué capa lo devolvió. |
429 | Se excedió la asignación solicitada; respete el retraso de reintento y reduzca la frecuencia de solicitud. |
404 | El punto final o el registro al que se hace referencia puede ser incorrecto o no estar disponible; verifique la ruta exacta y el contexto. |
5xx o no disponible | Problema de plataforma o servicio ascendente; tiempo de captura y etapa de solicitud. |
| argumentos inválidos | Campo obligatorio, tipo de entrada, campo adicional no admitido o identificador que no coincide. |
| Conectado pero sin herramienta esperada | Alcance asignado, adición inactiva o no verificada o descubrimiento de cliente obsoleto. |
| Aparecen herramientas pero las llamadas fallan | Autorización ascendente, derecho de cuenta o entrada específica de la operación. |
Estos son puntos de partida del diagnóstico. La fuente real de un error HTTP es importante; El error de permiso de un servicio no se soluciona debilitando la autenticación MCP.
Una secuencia de diagnóstico segura#
Confirme el punto final, actualice la lista de herramientas, compárela con la transferencia y ejecute la prueba de solo lectura acordada. Si falla, registre el nombre de la herramienta y el error redactado. Deténgase antes de repetir una acción de escritura cuyo resultado sea incierto.
Que enviar soporte#
Utilice el lista de verificación de soporte. Incluya una captura de pantalla con información confidencial oculta o el texto del error relevante, no una exportación completa de la conversación ni una configuración que contenga una clave.