Risoluzione dei problemi
Identificare se il problema riguarda l'accesso alla connessione, le autorizzazioni dello strumento o il servizio upstream.
Tradotto automaticamente dall’inglese. Leggi l’originale in inglese
2 minuti di lettura · Guida per il cliente
Inizia identificando la fase non riuscita: aggiunta della connessione, rilevamento degli strumenti, esecuzione di uno strumento o verifica di una scrittura. Cattura l'ora e una breve descrizione prima di modificare le impostazioni.
Impossibile raggiungere la connessione#
Controlla l'esatto endpoint assegnato e se il client AI supporta il suo metodo di trasporto e autenticazione. Un indirizzo home della piattaforma non è un endpoint MCP. Utilizza la normale connessione sicura; non ignorare un avviso di certificato.
Se la stessa connessione assegnata ha funzionato in precedenza, segnala quando è riuscita l'ultima volta e cosa è cambiato nel client. Evitare di eliminare i dettagli della connessione funzionante prima che venga verificata una sostituzione.
Riferimento all'errore#
| Sintomo | Cosa controllare |
|---|---|
401 al momento della connessione o della scoperta | Credenziale mancante, errata, scaduta o revocata; intestazione o endpoint errato. |
403 per un'operazione | Ambito delle credenziali, autorizzazione dello strumento o ruolo del servizio upstream; identificare quale livello lo ha restituito. |
429 | Superata la franchigia richiesta; rispettare il ritardo tra i tentativi e ridurre la frequenza delle richieste. |
404 | L'endpoint o il record a cui si fa riferimento potrebbero essere errati o non disponibili; controllare il percorso esatto e il contesto. |
5xx o non disponibile | Problema della piattaforma o del servizio upstream; tempo di acquisizione e fase di richiesta. |
| Argomenti non validi | Campo obbligatorio, tipo di input, campo aggiuntivo non supportato o identificatore non corrispondente. |
| Connesso ma nessuno strumento previsto | Ambito assegnato, aggiunta inattiva o non verificata o rilevamento client non aggiornato. |
| Vengono visualizzati gli strumenti ma le chiamate falliscono | Autorizzazione a monte, titolarità dell'account o input specifici dell'operazione. |
Questi sono i punti di partenza diagnostici. L'origine effettiva di un errore HTTP è importante; l'errore di autorizzazione di un servizio non viene risolto indebolendo l'autenticazione MCP.
Una sequenza diagnostica sicura#
Conferma l'endpoint, aggiorna l'elenco degli strumenti, confrontalo con l'handoff ed esegui il test di sola lettura concordato. Se fallisce, registrare il nome dello strumento e l'errore oscurato. Fermarsi prima di ripetere un'azione di scrittura il cui risultato è incerto.
Cosa inviare supporto#
Usa il lista di controllo del supporto. Includi uno screenshot con informazioni riservate nascoste o il testo dell'errore pertinente, non un'esportazione completa della conversazione o una configurazione contenente una chiave.