Solución de problemas de MCP — Altifigence Documentation

No se puede conectar un cliente alojado

Compruebe que la URL configurada sea https://mcp.altifigence.com/cloud-mcp y que el cliente admita Streamable HTTP con OAuth. Siga la guía de conexión y consulte el estado actual de cualificación. La página de salud del servidor y los metadatos de OAuth no demuestran que un cliente concreto haya completado la autorización.

Resultado	Siguiente paso
HTTP 401	Vuelva a conectar Altifigence Cloud si la autorización caducó o se revocó; complete de nuevo el flujo de autorización del cliente
HTTP 403	Compruebe la organización autorizada por consentimiento, el acceso actual al proyecto y la política de herramientas; vuelva a conectar con el permiso necesario después de que la organización habilite la herramienta
Herramientas vacías o ausentes	Compruebe el catálogo publicado, la aprobación explícita de la organización y el nuevo consentimiento para cada herramienta; renovar un token antiguo no añade herramientas
Lectura del espacio de trabajo no disponible	Compruebe el estado y el acceso al espacio de trabajo en Cloud; reintente cuando esté listo
Faltan herramientas de ejecución	Solicite un nuevo consentimiento de `cloud.execute` y compruebe la publicación, la política de la organización y el acceso al entorno de ejecución del proyecto
Faltan herramientas de escritura	Solicite un nuevo consentimiento de `cloud.write` y compruebe los permisos explícitos de herramientas y proyectos de la organización
Conflicto al modificar un archivo	Vuelva a leer el manifiesto y el archivo, revise los cambios concurrentes y después envíe el cambio previsto con las revisiones actuales
Creación de proyecto o modificación de Git sin confirmar	Consulte la lista de proyectos, el repositorio o el estado remoto antes de reintentar; repetir una creación, commit o push puede tener efectos no deseados
Eliminación de proyecto aceptada	Siga el estado del proyecto y espacio de trabajo hasta que termine la limpieza; aceptada no significa completada
Transferencia del proveedor de Git denegada	Compruebe el repositorio, la rama y la conexión actual del proveedor seleccionados; la herramienta no puede eludir los permisos del proveedor
Operación del entorno de ejecución sin confirmar	Consulte el estado del entorno y conserve el ID de la operación; reanudar utiliza el ID de la operación del entorno detenido
Ha cambiado la generación del proyecto, la versión del archivo o la política	Obtenga una estimación nueva y revise la oferta y la política de consumo seleccionadas
Envío sin confirmar	Consulte el mismo ID de trabajo; reintente únicamente con argumentos idénticos y ese mismo ID
Resultado no listo	Consulte el estado del trabajo antes de solicitar de nuevo el resultado
Créditos insuficientes	Revise el estado de facturación de la organización en Cloud
HTTP 413	Reduzca la solicitud a los argumentos del esquema de herramienta descubierto
HTTP 501 de una herramienta local	El entorno de ejecución instalado no implementa esta operación; el descubrimiento por sí solo no establece que se admita
HTTP 503	Espere a que se recupere el servicio; conserve el punto de conexión configurado

Una solicitud de lectura no inicia ni reinicia un proyecto. Los nombres de herramientas desconocidos o no autorizados no habilitan la edición ni la ejecución. Corrija la conexión o la condición de acceso antes de reintentar; no proporcione credenciales alternativas en los argumentos.

Demasiadas solicitudes

Si una respuesta incluye HTTP 429, espere el periodo indicado por Retry-After antes de volver a intentarlo. Evite los intentos repetidos de registro o inicio de sesión.

Contactar con soporte

Contacte con Soporte de Altifigence e indique el nombre del cliente, la versión, la hora del problema y el mensaje de error después de retirar la información sensible. No incluya credenciales, cookies ni contenido del proyecto.

Recuperar sin duplicar el trabajo

Punto del fallo	Qué consultar antes de reintentar
Identidad o descubrimiento	Versión del cliente, punto de conexión, inicio de sesión o sesión y lista de herramientas autorizadas por consentimiento.
Continuación de lectura de archivo	Versiones del archivo y del manifiesto; reinicie si la instantánea ha cambiado.
Escritura de archivo, commit o push	Archivo guardado actual, repositorio y estado remoto.
Envío de trabajo	ID y estado del trabajo existente; conserve la identidad original.
Entrada de terminal o solicitud de IA	Sesión y salida actuales; no repita automáticamente la entrada.

Registre la solicitud mínima reproducible con marcadores para los datos del proyecto. Preserve el código de error, el estado HTTP, el identificador de la solicitud si se muestra y la marca de tiempo. Retire tokens y contenido del código fuente antes de compartir un diagnóstico.