Claude Code MCP Log: Trova il primo confine fallito

Se stai cercando Claude Code MCP log , inizia dallo stato del server risolto, poi cattura un file di debug con scopo di incidente. Non iniziare seguendo la cartella di Claude Desktop log: la documentazione MCP attuale etichetta quei percorsi del file system specificamente per il Desktop, mentre Claude Code documenti /mcp , claude mcp list , claude debug mcp e debug file . Il risultato utile non è "trova un tronco". Serve a identificare il primo confine fallito: configurazione, approvazione del progetto, avvio del processo, scoperta dello strumento, esecuzione dello strumento o il risultato esterno che lo strumento avrebbe dovuto produrre. Un log può spiegare un confine. Non può provare tutti e sei. Questa guida utilizza la documentazione Claude Code attuale e il rilascio del 2.1.220 npm, consultato il 30 luglio 2026. Fissa la versione installata in ogni incidente perché MCP comportamento e diagnostica stanno ancora cambiando. Ispezionare lo stato risolto prima di leggere l'output grezzo Esegui questi controlli dallo stesso elenco funzionante e dallo stesso account utente che ha mostrato il problema: All'interno della sessione Claude Code interessata, esegui: Il Guida ufficiale alla configurazione e debug Dice /mcp mostra server configurati, stato della connessione e approvazione del progetto. Il MCP riferimento Aggiunge due dettagli operativi che contano: un server .mcp.json con ambito di progetto può rimanere in sospeso finché lo spazio di lavoro non è stato fidato e il server non è approvato; Un server connesso può comunque non esporre alcun strumento e /mcp report che contano. Questi fatti eliminano tre classi di ricerca al cieco nel registro: Prove risolte Prima decisione Perché i log non sono i primi Server assente CONFIG MISSING Non c'è ancora un processo server caricato da diagnosticare. Controlla le fonti di ambito e impostazioni. In attesa di approvazione APPROVAL WAIT Questo è un confine legittimo di autorità, non un incidente. Rivedi e approva in modo interattivo. Non è riuscito a collegare Acquisizione MCP prove di debug Il comando, il percorso, l'ambiente, l'autenticazione o il trasporto potrebbero aver fallito. Connesso, zero strumenti Riconnetti, poi cattura MCP prove di debug L'avvio ebbe successo abbastanza da connettersi, ma la scoperta non produsse un registro utilizzabile. Connesso, strumenti presenti Riprodursi una chiamata limitata La salute della connessione non dice nulla sullo strumento selezionato o sul suo effetto esterno. I percorsi relativi meritano particolare sospetto per i server stdio locali. Claude Code documenti che command e args i percorsi si risolvono dalla directory in cui è stato avviato Claude Code, non dalla posizione di .mcp.json . Un server può quindi lavorare in un repository e fallire da un altro con testo di configurazione identico. Acquisisci un file di debug con ambito Claude Code MCP L'attuale Claude Code riferimento alla CLI documenta due segnalazioni rilevanti: debug abilita la modalità debug e accetta filtri di categoria come mcp ; debug file <path scrive l'output del debug su un percorso esplicito e attiva implicitamente la modalità debug. Crea una directory privata degli incidenti, avvia una sessione da zero solo con la categoria di debug MCP e riproduce un sintomo limitato: All'interno di quella sessione, ispeziona /mcp . Se un server è connesso senza alcun strumento, usa la sua azione Reconnetti . Se sono presenti strumenti, invoca solo il più piccolo strumento di sola lettura che riproduce il problema. Non riprovare una chiamata in grado di scrivere solo per rendere il log più interessante. Considera il file di debug come sensibile. Può contenere percorsi assoluti, nomi server, dettagli dell'ambiente, metadati delle richieste o standard del server. Registra le prove derivate nella ricevuta dell'incidente, poi conserva o elimina il file grezzo secondo la tua politica di sicurezza. Non copiare token di accesso, corpi di prompt, argomenti di strumenti, risultati o testo standard in un sistema di monitoraggio solo perché il file li contiene. Un pubblico Claude Code richiesta di funzionalità per file di log per MCP server segnala che gli utenti desiderano file persistenti in stile desktop per Claude Code. Questa questione è un'utile prova dei confini, non una garanzia di prodotto. La procedura di incidente supportata dovrebbe dipendere dal file di debug esplicito documentato, non da un percorso predefinito per server presupposto. Confronta il percorso delle prove con il trasporto Il MCP guida al debug per la revisione del protocollo 2026 07 28 traccia un confine di trasporto cruciale. Per un server locale stdio , stdout trasporta i messaggi del protocollo. Le diagnostiche server appartengono a stderr; Scrivere testo diagnostico su STDOUT può corrompere il flusso del protocollo. La guida di troubleshooting di Claude Code raccomanda specificamente claude debug mcp quando un server connesso non espone alcun strumento perché questo rende disponibile lo stderr del server nelle prove di debug. Per Streamable HTTP , il client non può catturare lo stderr del processo server remoto. Un file di debug Claude Code può comunque mostrare il comportamento di connessione e richieste lato client, ma il guasto interno del server necessita di log lato server o di OpenTelemetry più un'ispezione a livello HTTP. Un segmento di debug del client vuoto non è la prova che il servizio remoto non abbia fatto nulla. Questa distinzione impedisce una comune conclusione falsa: Annota il trasporto nella ricevuta. Senza di esso, "no stderr" è ambiguo. Costruire una ricevuta dell'incidente minimizzata dal contenuto Il registro grezzo è una prova per l'indagine. La ricevuta è la cartella clinica duratura. Può rimanere utile senza memorizzare contenuti: Mantieni esplicita la precedenza del classificatore: Ho rigiocato quella regola contro otto custodie sintetiche. Ha separato correttamente la configurazione mancante, l'attesa di approvazione, il fallimento di avvio catturato, la connessione a zero strumenti, l'errore dello strumento, la risposta riuscita dello strumento senza risultato, il risultato verificato e una connessione fallita con prove di debug insufficienti. Tutti e otto gli stati previsti sono stati approvati. Gli ultimi due casi sono il confine importante. Un risultato JSON RPC di successo o non errore è l'evidenza dell'attività. Se il compito prometteva un problema creato, un record modificato, un file consegnato o una destinazione aggiornata, verifica quella destinazione separatamente. Senza quella ricevuta, lo stato corretto è OUTCOME UNVERIFIED , non è salutare. Scegli la più piccola azione sicura successiva Ogni stato dovrebbe portare a una risposta limitata: CONFIG MISSING : Ispeziona l'ambito delle impostazioni e il file esatto Claude Code caricato. Non modificare il codice del server. APPROVAL WAIT : instradare l'approvazione all'umano responsabile. Non definire l'attesa un incidente. STARTUP FAILED : riparare la prima causa di avvio del calcestruzzo nell'evidenza di debug a scopo, poi riconnettersi una volta. DISCOVERY EMPTY : confrontare l'inizializzazione e le prove della lista degli strumenti; Testa il server in modo indipendente con MCP Inspector se necessario. TOOL CALL FAILED : Conservare l'identità della richiesta, identificare se il retry è sicuro ed evitare di ripetere una scrittura incerta. OUTCOME UNVERIFIED : consulta la destinazione tramite identificatore stabile. Non rieseguire lo strumento finché non sai se l'effetto è già avvenuto. UNCERTAIN : raccogliere le prove dei confini mancanti o intensificare. Lo sconosciuto è uno stato operativo, non un invito a indovinare. HEALTHY : richiedono sia una catena di MCP utilizzabile sia una ricevuta di risultato nuova e deterministica. I log rendono spiegabile un guasto. Stato risolto lo rende localizzabile. Una ricevuta di destinazione rende verificabile il recupero. Tieni questi compiti separati, e un incidente Claude Code MCP diventa un breve esercizio di prove invece di una sequenza di tentativi sempre più rischiosi. Sidewisp è progettato attorno a questa distinzione che centra la salute tra connessione, progresso utile, strumenti e risultati. Sidewisp è attualmente in anteprima privata. Gli adattatori di monitoraggio di produzione e l'executor di recupero generalmente non vengono forniti.