Risoluzione dei problemi MCP — Altifigence Documentation

Impossibile connettere un client ospitato

Verifica che l'URL configurato sia https://mcp.altifigence.com/cloud-mcp e che il client supporti Streamable HTTP con OAuth. Segui le indicazioni per la connessione e lo stato corrente di qualificazione. La pagina di stato del server e i metadati OAuth non dimostrano che uno specifico client abbia completato l'autorizzazione.

Risultato	Passo successivo
HTTP 401	Riconnetti Altifigence Cloud se l'autorizzazione è scaduta o revocata; completa nuovamente il flusso di autorizzazione del client
HTTP 403	Controlla organizzazione autorizzata dal consenso, accesso corrente al progetto e politica degli strumenti; riconnettiti con l'autorizzazione richiesta dopo che l'organizzazione ha abilitato lo strumento
Strumenti vuoti o mancanti	Controlla catalogo rilasciato, approvazione esplicita dell'organizzazione e nuovo consenso per ogni strumento; aggiornare un vecchio token non può aggiungere strumenti
Lettura del workspace non disponibile	Controlla stato e accesso del workspace in Cloud; ritenta dopo che è pronto
Strumenti di esecuzione mancanti	Richiedi un nuovo consenso `cloud.execute` e controlla release, politica dell'organizzazione e accesso al runtime del progetto
Strumenti di scrittura mancanti	Richiedi un nuovo consenso `cloud.write` e controlla le autorizzazioni esplicite dell'organizzazione per strumenti e progetti
Conflitto nella modifica di un file	Rileggi manifesto e file, esamina le modifiche simultanee, poi invia la modifica prevista con le revisioni correnti
Creazione del progetto o modifica Git non confermata	Esamina elenco dei progetti, repository o stato remoto prima di ritentare; ripetere creazione, commit o push può avere effetti indesiderati
Eliminazione del progetto accettata	Segui lo stato di progetto/workspace fino alla fine della pulizia; accettato non significa completato
Trasferimento al provider Git negato	Controlla repository e branch selezionati e connessione corrente al provider; lo strumento non può aggirare le autorizzazioni del provider
Operazione sul runtime non confermata	Leggi lo stato del runtime e conserva l'ID dell'operazione; la ripresa usa l'ID dell'operazione del runtime arrestato
Generazione del progetto, versione del file o politica cambiata	Ottieni una nuova stima ed esamina l'offerta selezionata e la politica di utilizzo
Invio non confermato	Esamina lo stesso ID del job; ritenta solo con argomenti identici e quello stesso ID
Risultato non pronto	Leggi lo stato del job prima di richiedere di nuovo il risultato
Crediti insufficienti	Esamina lo stato di fatturazione dell'organizzazione in Cloud
HTTP 413	Riduci la richiesta agli argomenti dello schema dello strumento rilevato
HTTP 501 da uno strumento locale	Il runtime installato non implementa questa operazione; il solo rilevamento non ne attesta il supporto
HTTP 503	Attendi il ripristino del servizio; conserva l'endpoint configurato

Una richiesta di lettura non avvia né riavvia un progetto. Nomi di strumenti sconosciuti o non autorizzati non abilitano modifica o esecuzione. Correggi la condizione di connessione o accesso prima di ritentare; non fornire credenziali alternative negli argomenti.

Troppe richieste

Se una risposta include HTTP 429, attendi il periodo specificato da Retry-After prima di riprovare. Evita tentativi ripetuti di registrazione o accesso.

Contatta l'assistenza

Contatta l'assistenza Altifigence con nome e versione del client, ora del problema e messaggio di errore dopo aver rimosso le informazioni sensibili. Non includere credenziali, cookie o contenuti del progetto.

Recupera senza duplicare il lavoro

Punto di errore	Cosa esaminare prima di ritentare
Identità o rilevamento	Versione del client, endpoint, accesso/sessione ed elenco degli strumenti autorizzati dal consenso.
Continuazione della lettura di un file	Versioni di file e manifesto; ricomincia in caso di snapshot cambiato.
Scrittura di un file, commit o push	File salvato corrente, repository e stato remoto.
Invio del job	ID e stato del job esistente; conserva l'identità originale.
Input del terminale o richiesta AI	Sessione/output correnti; non riprodurre automaticamente l'input.

Registra la richiesta minima riproducibile con segnaposto per i dati di progetto. Conserva codice di errore, stato HTTP, identificativo della richiesta se mostrato e timestamp. Rimuovi token e contenuti sorgenti prima di condividere una diagnostica.