Vai al contenuto principale

Domande Frequenti sulla Directory dei Connettori Anthropic

Aggiornato oggi

Che cos'è MCP?

MCP sta per Model Context Protocol, uno standard aperto creato da Anthropic che consente alle applicazioni di intelligenza artificiale di connettersi a strumenti e fonti di dati. Per informazioni complete su MCP e come iniziare, consulta la nostra guida remota MCP: Getting Started with Custom Connectors Using Remote MCP.

Che cos'è la Connectors Directory?

La Connectors Directory mira a mostrare i server Model Context Protocol che funzionano con Claude su tutte le nostre piattaforme - Claude web, Claude Desktop, le nostre app Claude mobile, Claude Code e la nostra API. La Connectors Directory funge da hub unico dove gli utenti possono scoprire i server MCP che Anthropic ha revisionato.

Come faccio a far inserire il mio MCP nella directory?

Puoi compilare il nostro modulo di revisione del server Connectors Directory e ti contatteremo riguardo ai prossimi passi se il tuo MCP fosse una buona scelta per la directory in questo momento.

Ci sono standard a cui il mio MCP dovrà attenersi per l'inclusione nella directory?

Sì, i server devono attenersi agli standard di sicurezza, sicurezza e compatibilità descritti nella nostra MCP Directory Policy. L'adesione a questi standard non garantisce l'inclusione nella directory.

Ho compilato il modulo di invio ma non ho ancora ricevuto risposta, quanto tempo ci vorrà?

Sebbene ci sforziamo di revisionare ogni invio il più rapidamente possibile, a causa dell'enorme interesse non possiamo promettere che accetteremo il tuo invio o che ti risponderemo individualmente.

1. Autenticazione e Autorizzazione

OAuth 2.0 è obbligatorio se non abbiamo bisogno dell'autenticazione dell'utente?

OAuth 2.0 è obbligatorio solo se è necessaria l'autenticazione per il server MCP. I server che non richiedono autenticazione non richiedono OAuth.

Claude supporta il flusso OAuth machine-to-machine (client credentials)?

No. Il flusso puro delle credenziali del client (OAuth machine-to-machine con solo client_id/client_secret e nessuna interazione dell'utente) non è supportato. Possiamo fornire un client_id/client_secret statico per Claude, ma gli utenti devono comunque completare un flusso di consenso OAuth per autenticare i loro account individuali. Questo funziona su claude.ai e Claude Desktop, ma non su Claude Code perché Claude Code stabilisce connessioni direttamente dal computer dell'utente al tuo server MCP (e quindi non hanno accesso alle credenziali statiche).

Possiamo identificare i singoli utenti senza implementare OAuth?

No. OAuth è l'unico modo per identificare univocamente gli utenti. Non inoltriamo indirizzi IP, ID utente o altri metadati dagli utenti finali ai server MCP.

Dove avviene la comunicazione del server MCP - lato client o server Anthropic?

Dipende dalla superficie del prodotto. La comunicazione avviene attraverso i server Anthropic (claude.ai, Claude Desktop), il browser dell'utente o i client locali dell'utente (Claude Code). Attualmente non esiste un metodo di connessione centralizzato su tutte le superfici.

Gli utenti possono autenticarsi con credenziali personali da un account Claude aziendale?

Sì. Gli utenti si autenticano con i server MCP su base per-server. Possono utilizzare credenziali di autenticazione personali per i server MCP anche quando sono connessi a claude.ai con un account aziendale.

Possiamo implementare OAuth per-tool invece di OAuth per-server?

No. OAuth si verifica quando il client si connette al server MCP, non a livello di tool. Puoi applicare autorizzazioni a livello di tool in base all'autenticazione dell'utente dopo che la connessione al server è stata stabilita.

Quando un utente disconnette uno strumento MCP, i token OAuth vengono revocati?

I token vengono rimossi dai sistemi di Anthropic ma non dai tuoi sistemi. I token di accesso e aggiornamento presso il tuo provider di identità rimangono validi fino alla scadenza e i cookie di sessione non vengono cancellati (poiché sono a livello di browser, al di fuori del controllo di Claude).

Come può il nostro servizio MCP segnalare a Claude che la sessione di un utente non è valida?

Restituisci una risposta 401 Unauthorized. Per attivare la rigenerazione completa delle credenziali del client DCR, restituisci un errore invalid_client secondo la sezione RFC 6749 5.2.

client_id/client_secret sono obbligatori per i flussi OAuth standard?

No. Le credenziali del client non sono obbligatorie per i flussi OAuth standard con autenticazione dell'utente.

2. Limitazione della velocità e prevenzione degli abusi

Come possiamo implementare la limitazione della velocità per-utente senza OAuth?

La limitazione della velocità per-utente richiede OAuth. Senza OAuth, le tue opzioni sono:

  • Opzione 1: Nessuna autenticazione con limitazione della velocità globale

  • Opzione 2: IP allowlisting utilizzando gli IP statici di Claude

Possiamo utilizzare IP allowlisting per limitare l'accesso al server MCP solo agli utenti Claude?

Consigliamo vivamente di utilizzare OAuth e non di utilizzare IP allowlisting. Tuttavia, questo è possibile utilizzando gli indirizzi IP statici disponibili su https://docs.claude.com/en/api/ip-addresses.

Limitazioni importanti:

  • Funziona solo per claude.ai e Claude Desktop. Il tuo server MCP non funzionerà in Claude Code.

  • Gli IP di uscita potrebbero cambiare - un avviso anticipato del cambio sarà pubblicato nella documentazione

  • Non consigliato come misura di sicurezza unica, ma accettabile da utilizzare quando OAuth non è fattibile

Claude fornisce limitazione della velocità o protezione DDoS per i server MCP?

No. I proprietari del server MCP devono implementare le proprie misure di limitazione della velocità e prevenzione degli abusi.

3. Limiti tecnici e vincoli

Qual è la dimensione massima del token per i risultati dello strumento MCP?

25.000 token. Utilizza paginazione, filtri o parametri di limite per ridurre la dimensione della risposta se necessario.

Quali sono i limiti di timeout per gli strumenti MCP?

I timeout variano per componente:

  • Claude Code: Configurabile tramite l'impostazione MCP_TOOL_TIMEOUT

  • Claude.ai e Claude Desktop: 300 secondi (5 minuti)

4. Invio della directory e requisiti

Quali tipi di piano Claude possono accedere ai Connectors?

Tutti gli utenti possono accedere ai connectors, ad eccezione dei connectors personalizzati, che sono disponibili solo per i piani a pagamento (Pro, Max, Team ed Enterprise).

Abbiamo bisogno di un piano Claude specifico per inviare un MCP alla directory?

No. Qualsiasi organizzazione può inviare alla directory indipendentemente dal tipo di piano.

Dobbiamo fornire ad Anthropic un account di test?

Se il tuo server richiede autenticazione / un account per l'utilizzo, avremo bisogno che tu ci fornisca un account di test per scopi di QA iniziali. Includere dati fittizi nell'account è anche utile per verificare la funzionalità.

Quanti strumenti dovrebbe fornire un server MCP?

Nessun requisito minimo o massimo. Consigliamo di iniziare con un set utile di strumenti e di espandere le capacità nel tempo.

Quali sono i requisiti di prestazione per i server MCP?

Attualmente non ci sono requisiti SLA specifici. Tuttavia, i connectors con problemi di prestazioni o affidabilità possono essere rimossi dalla directory.

Quali sono i motivi più comuni per cui gli invii MCP vengono ritardati o rifiutati?

Problema principale: Annotazioni di strumenti mancanti (30% dei rifiuti)

Requisito: Tutti gli strumenti DEVONO includere readOnlyHint o destructiveHint

Impatto: Rifiuto immediato, richiede modifiche al codice.

Non opzionale: Requisito di conformità secondo MCP Directory Policy

Esempio:

{
"name": "read_data",
"readOnlyHint": true
}

5. Privacy dei dati e aspetti legali

Quali telemetrie raccoglie Anthropic dalle chiamate dello strumento MCP?

La telemetria include tutti i parametri e i dati passati nelle chiamate dello strumento nonché la risposta dal server MCP.

I dati MCP vengono utilizzati per l'addestramento dei modelli Claude?

Addestriamo solo i dati dei consumatori quando gli utenti esplicitamente acconsentono. Vedi https://www.anthropic.com/news/updates-to-our-consumer-terms per i dettagli. Non addestriamo sui piani Team/Enterprise.

I server MCP possono identificare quale SKU Claude sta utilizzando l'utente?

No. I server MCP non possono determinare lo SKU Claude in uso.

Cosa significa "Data Processing Agreement URL" nel modulo di invio?

Fornisci un URL ai termini di elaborazione dei dati della tua azienda applicabili al servizio MCP. Questo non deve essere specifico per MCP - il tuo DPA standard è accettabile.

I connectors sono disponibili a livello globale? Possiamo limitare per geografia?

I connectors sono disponibili per gli utenti Claude a livello globale. La restrizione geografica non è supportata. Puoi guidare la comprensione dell'utente e di Claude di eventuali limitazioni geografiche nella descrizione del tuo MCP o nelle descrizioni degli strumenti se necessario (ad es. "solo organizzazioni statunitensi disponibili").

Dove posso trovare i Termini di servizio della MCP Directory e le politiche sui dati?

Risorse chiave:

Quali sono i requisiti di conformità della protezione dei dati (ad es. GDPR, CCPA, LGPD) per i server MCP?

I server MCP devono gestire la conformità indipendentemente da Claude. Se un utente esercita un diritto legale di protezione dei dati con il tuo servizio, devi gestirlo da parte tua.

Dove devo includere le politiche sulla privacy per i connectors locali (estensioni desktop)?

Nel tuo .mcpb, ci sono due posizioni obbligatorie:

1. README.md - Aggiungi una sezione "Privacy Policy" con URL o testo completo.

2. manifest.json - Aggiungi l'array privacy_policies con URL HTTPS (richiede manifest_version 0.2+)

Esempio:

{
"manifest_version": "0.2",
"privacy_policies": ["https://your-domain.com/privacy"],
...
}

Deve coprire: Quali dati vengono raccolti, come vengono utilizzati/archiviati, condivisione con terze parti, conservazione e informazioni di contatto. ⚠️ La mancanza di una politica sulla privacy porterà a un rifiuto immediato.

6. Esperienza utente e branding

Come aggiorniamo l'icona del nostro connector?

Utilizziamo la favicon fornita da Google, quindi puoi personalizzare l'URL dell'icona del tuo connector aggiornando la favicon per l'URL del tuo connector. Puoi verificare l'icona che useremo su https://www.google.com/s2/favicons?domain=<YOUR_CONNECTOR_URL>&sz=64

Assicurati di testare ogni dimensione di favicon (16, 32, 48, 64, 96, 128) aggiornando la porzione &sz= dell'URL.

Connectors remoti:

  • Se utilizzi un URL di icona personalizzato: Aggiorna l'icona all'URL fornito.

  • Se affidati al rilevamento automatico: Le icone vengono estratte dalla favicon indicizzata da Google all'URL del tuo server MCP. Aggiorna la tua favicon e attendi che Google la reindicizzi.

Altrimenti, forniscici un URL con la favicon che desideri utilizzare come icona.

Connectors locali (estensioni desktop): Sostituisci `icon.png` nel tuo bundle e ridistribuisci il pacchetto `.mcpb` aggiornato agli utenti.

Le descrizioni dei connectors in Claude supportano markdown?

Sì. La formattazione markdown è supportata nelle descrizioni dei connectors.

Possiamo includere i requisiti dell'account e i link di iscrizione nei dettagli del connector?

Sì. Includi il linguaggio dei requisiti dell'account (ad es. "account registrato gratuito richiesto") e i link ipertestuali alle pagine di iscrizione nei dettagli del connector.

Come possiamo assicurarci che gli utenti vedano i nostri Termini di servizio prima di connettersi?

Implementa una schermata OAuth. Questo è l'unico modo per garantire la visualizzazione dei TOS. Senza OAuth, gli utenti potrebbero teoricamente aggiungere connectors a Claude Desktop modificando direttamente claude_desktop_config.json.

Possiamo mostrare il linguaggio di consenso con link TOS/Privacy Notice durante l'installazione?

Includi il linguaggio nella descrizione del connector, ma non esiste un flusso di consenso speciale o popup. Utilizza una schermata OAuth per assicurarti che gli utenti vedano e accettino i termini.

7. Implementazione tecnica

Il trasporto SSE è accettabile o dobbiamo utilizzare Streamable HTTP?

Devi utilizzare Streamable HTTP.

Possiamo aggiungere descrizioni a livello di server o solo descrizioni a livello di tool?

Attualmente sono supportate solo le descrizioni a livello di tool. Non esiste una descrizione a livello di server. Ciò richiede di ripetere le indicazioni di steering nelle descrizioni dei singoli strumenti. Riconosciamo che questo è scomodo e stiamo esplorando miglioramenti.

Come rendiamo disponibili i server MCP locali (.mcpb) in Claude Code?

Utilizza il plugin marketplace. Node.js è consigliato rispetto a Python o altri linguaggi per MCP locali a causa della migliore compatibilità con il runtime integrato di Claude Desktop.

Quali sono le best practice di osservabilità per MCP locali in Claude Desktop?

I MCP locali possono registrare solo su ~/Library/Logs/Claude/mcp*.log. Gli utenti devono condividere manualmente i file di log per la risoluzione dei problemi. La trasmissione diretta dei log dai server MCP locali non è supportata a causa di vincoli di sicurezza.

8. Test e debug

IP allowlisting non funziona. Come eseguiamo il debug dei problemi di connessione?

Rimuovi temporaneamente l'allowlist IP per verificare che la configurazione rimanente sia corretta. Se la connessione funziona senza allowlist, il problema è con la configurazione del filtro IP.

Quali test dovremmo completare prima di inviare alla directory?

I test essenziali prevengono l'80% dei ritardi di invio. Consulta le nostre guide per l'invio di connectors remoti e locali per le best practice e una lista di controllo pre-invio.

9. Modelli di implementazione comuni

Quale approccio di autenticazione dovremmo utilizzare per il nostro MCP?

Scegli in base ai tuoi requisiti di sicurezza e vincoli:

Opzione 1: Nessuna autenticazione + limitazione della velocità globale

Migliore per: Dati pubblici con basso rischio di abuso

  • Implementazione più semplice, funziona su tutte le superfici Claude

  • Nessuna limitazione della velocità per-utente, accessibile da internet pubblico

  • Può aggiungere IP allowlisting per limitare al solo traffico Claude

Opzione 2: OAuth completo con registrazione dell'utente

Migliore per: Sicurezza aziendale, dati sensibili, limitazione della velocità per-utente

  • Più sicuro, funziona su tutte le superfici, identificazione completa dell'utente

  • Richiede sistema di registrazione dell'utente, implementazione più complessa

  • Approccio consigliato per i sistemi di produzione

Opzione 3: IP-allowlisting

Consigliamo vivamente l'Opzione 2 rispetto all'Opzione 3, ma se l'implementazione di OAuth è veramente infattibile, puoi comunque ottenere un accesso limitato solo agli utenti Claude

  • Nessuna capacità di identificare i singoli utenti, ma limita le richieste da claude.ai e Claude Desktop.

  • Il server MCP non funzionerà con Claude Code

  • Implementazione: Utilizza Claude Static IPs

10. Risorse chiave

Link importanti:

Hai ricevuto la risposta alla tua domanda?