Scegliere una configurazione client MCP dosya

dosya MCP è un connettore OAuth remoto ospitato su https://mcp.dosya.dev/mcp. Non è un server stdio locale e non accetta nella configurazione client una chiave API REST dosya, un segreto client o un comando shell.

Prima di iniziare

• Scegli un client che supporti server MCP HTTP remoti e OAuth. Claude offre Settings → Connectors → Add custom connector. ChatGPT usa connettori o app personalizzati dopo l’attivazione della modalità sviluppatore, secondo la disponibilità del piano.
• L’autorizzazione vincola alla connessione uno spazio di lavoro dosya.
• Il connettore offre nove strumenti di sola lettura. Le operazioni di base sui file usano files.read; le informazioni sull’account richiedono l’autorizzazione aggiuntiva separata account.read.

Passaggi

1. Apri le impostazioni dei connettori del client. Se accetta solo un comando locale, un eseguibile stdio o un token Bearer statico, scegli invece un client remoto con OAuth.
2. Aggiungi un connettore personalizzato il cui URL server sia esattamente https://mcp.dosya.dev/mcp. Lascia vuoti i campi per chiave API, segreto client, comando e ambiente.
3. Avvia il flusso OAuth, accedi a dosya, esamina gli ambiti richiesti e scegli lo spazio di lavoro desiderato. Non autorizzarne uno solo perché comodo senza controllarne il nome.
4. Torna al client e verifica che il connettore risulti connesso. Se mostra gli strumenti disponibili, verifica quelli di sola lettura previsti prima di condividere contesto con un modello.
5. Esegui un elenco di file o una ricerca a basso impatto. Verifica che i risultati appartengano allo spazio vincolato e che non siano offerti strumenti per creare, rinominare, spostare, caricare, condividere o eliminare.
6. Richiedi informazioni sull’account solo quando servono e approva consapevolmente l’autorizzazione aggiuntiva account.read. Rimuovi e riconnetti il connettore per cambiare lo spazio di lavoro associato.

Risultato previsto

Il client completa OAuth remoto, elenca gli strumenti di sola lettura dosya e restituisce dati solo dallo spazio di lavoro approvato durante la connessione. Nessuna chiave API REST compare nella configurazione client.

Risoluzione dei problemi

Il client chiede un comando o pacchetto stdio. Non supporta il formato del connettore remoto dosya; usa un client con MCP HTTP remoto e OAuth.

L’autenticazione API REST fallisce all’URL MCP. Rimuovi la chiave API. I token MCP sono vincolati al destinatario mcp.dosya.dev e il middleware API REST li rifiuta nella direzione opposta.

Appare lo spazio di lavoro sbagliato. Disconnetti e autorizza di nuovo, scegliendo quello corretto durante OAuth. Un argomento dello strumento non può uscire dall’autorizzazione vincolata.

Guide correlate

• Collegare un client MCP
• Risolvere problemi MCP