Questa è una guida completa per inviare il tuo server MCP remoto alla Directory MCP di Anthropic per una distribuzione e una scopribilità più ampia.
Prerequisiti
Prima dell'invio del server, dovresti avere:
Un server MCP remoto funzionante e completamente testato
Autenticazione OAuth 2.0 implementata (se richiesta l'autenticazione)
Tutti gli strumenti con annotazioni di sicurezza appropriate
Distribuzione pronta per la produzione
Un canale di supporto dedicato (email o web)
Account di test fornito con dati di esempio
Documentazione completa
Nuovo allo sviluppo MCP remoto? Consulta prima Getting Started with Custom Connectors Using Remote MCP. Per le best practice tecniche e i dettagli del protocollo, consulta MCP Protocol Documentation.
Nota: Questa guida copre i server MCP remoti (ospitati nel cloud, HTTPS). Per le estensioni desktop locali, consulta Local MCP Server Submission Guide.
1. Panoramica della Directory
Quali sono i vantaggi dell'inclusione nella directory?
Scopribilità e fiducia:
Elencato nella Directory MCP ufficiale di Anthropic accessibile da Claude.ai
Accessibile agli utenti di Claude su tutte le piattaforme (web, desktop, mobile)
Visibilità professionale per il tuo servizio
Esperienza utente:
Connessione con un clic dalla directory
Integrato con l'interfaccia del connettore di Claude
Presentazione standardizzata su tutte le piattaforme
Flusso OAuth gestito senza problemi
Supporto e credibilità:
Revisione di Anthropic della qualità, della sicurezza e della conformità
Elencato insieme ad altri connettori verificati
Visibilità della comunità e feedback
Canale di distribuzione professionale
Quali piattaforme Claude supportano i server MCP remoti?
Tutte le principali piattaforme Claude:
Claude.ai (web) - Supporto completo con OAuth
Claude Desktop - Supporto completo con OAuth
Claude Code - Connessione diretta dalla macchina dell'utente (con supporto OAuth)
Claude API - Supporto dell'integrazione
App mobile Claude - Supporto del connettore
2. Requisiti Obbligatori
Tutti i requisiti in questa sezione sono obbligatori per l'approvazione della directory. La mancanza di uno qualsiasi di questi comporterà il rifiuto o richieste di revisione.
Le annotazioni di sicurezza sono obbligatorie?
SÌ - Ogni strumento DEVE avere annotazioni di sicurezza accurate.
Obbligatorio su ogni strumento:
readOnlyHint: true - Per gli strumenti che solo leggono dati
destructiveHint: true - Per gli strumenti che modificano dati o hanno effetti collaterali
Consulta MCP Protocol - Tool Annotations per lo schema completo e i dettagli di implementazione.
Non è facoltativo. Questo è un requisito rigoroso derivato dalla MCP Directory Policy.
Come decidere quale annotazione:
Comportamento dello Strumento | Annotazione | Esempi |
Solo lettura dati | readOnlyHint: true, destructiveHint: false | search, get, list, fetch, read |
Scrive/modifica dati | destructiveHint: true, readOnlyHint: false | create, update, delete, send |
Crea file temporanei | destructiveHint: true | Anche le scritture temporanee contano |
Invia richieste esterne | destructiveHint: true | Email, notifiche, webhook |
Cache solo internamente | readOnlyHint: true | Ottimizzazione interna OK |
Annotazione aggiuntiva consigliata:
title - Nome dello strumento leggibile dall'uomo per la visualizzazione nell'interfaccia utente (migliora l'esperienza utente)
Devo fornire account di test?
SÌ - Se il tuo server richiede autenticazione.
Cosa fornire:
Credenziali dell'account di test (nome utente/password o chiavi API)
Dati di esempio nell'account (necessari per il test funzionale)
Istruzioni di configurazione per l'ambiente di test
Limitazioni di accesso (se presenti)
Gli account di test dovrebbero avere:
Accesso a tutti gli strumenti in fase di revisione
Dati di esempio rappresentativi
Autorizzazioni appropriate per il test della funzionalità completa
Stato attivo durante il periodo di revisione e oltre
Come fornire:
Includi le credenziali nel modulo di invio (idealmente condivise tramite un metodo sicuro, come un link 1Password)
Assicurati che gli account rimangono attivi durante e dopo la revisione per revisioni periodiche post-ammissione
Fornisci accesso sufficiente per il test completo
OAuth 2.0 è obbligatorio?
SÌ - Se il tuo server richiede autenticazione.
Requisiti di implementazione OAuth:
Deve utilizzare il flusso del codice di autorizzazione OAuth 2.0
Certificati da autorità riconosciute
Whitelist del client MCP locale (ad es. Claude Code, MCP Inspector) URL di callback:
Whitelist degli URL di callback di Claude:
Configurazione corretta dell'URI di reindirizzamento
Problemi OAuth comuni da evitare:
Errori di URI di reindirizzamento non valido (assicurati che entrambi gli URL di callback siano nella whitelist)
Richieste HEAD senza token (gestisci con grazia dopo il flusso OAuth)
Guida all'implementazione: Consulta OAuth 2.0 Authorization Framework per i dettagli completi dell'implementazione OAuth.
Ci sono requisiti del firewall?
SÌ - Deve essere nella whitelist degli indirizzi IP di Claude per la compatibilità con claude.ai
Per i server dietro firewall, aggiungi alla whitelist gli indirizzi IP da https://docs.claude.com/en/api/ip-addresses.
Obbligatorio per: Claude.ai e Claude Desktop
Non obbligatorio per: Claude Code (si connette direttamente dalla macchina dell'utente)
Importante: La whitelist degli indirizzi IP da sola non è consigliata come misura di sicurezza. Utilizza OAuth 2.0 per l'autenticazione quando possibile.
Quale documentazione è richiesta?
Documentazione completa del server con sezioni specifiche.
Sezioni consigliate:
Descrizione del Server - Spiegazione chiara di cosa fa il tuo server
Funzionalità - Capacità chiave e casi d'uso
Istruzioni di Configurazione - Come gli utenti si connettono e configurano
Autenticazione - Configurazione OAuth e requisiti (se applicabile)
Esempi di Utilizzo - Minimo 3 esempi funzionanti con prompt (obbligatorio)
Politica sulla Privacy - Link alla politica sulla privacy completa
Supporto - Come gli utenti possono ottenere aiuto o segnalare problemi
Struttura di documentazione di esempio:
# [Nome del Tuo Servizio] MCP Server
## Descrizione
[Breve descrizione dell'integrazione del servizio e delle capacità]
## Funzionalità
- Funzionalità 1: [descrizione e valore]
- Funzionalità 2: [descrizione e valore]
- Funzionalità 3: [descrizione e valore]
## Configurazione
1. Visita la [Anthropic MCP Directory](https://claude.com/connectors)
2. Trova e connettiti a [Il Tuo Servizio]
3. Completa l'autenticazione OAuth
4. Configura le impostazioni richieste
## Autenticazione
Questo server richiede l'autenticazione OAuth. Avrai bisogno di:
- Account [Il Tuo Servizio] valido
- [Eventuali autorizzazioni specifiche o tipi di account]
## Esempi
[Vedi sezione minimo 3 esempi di seguito]
## Politica sulla Privacy
Vedi la nostra politica sulla privacy: https://your-domain.com/privacy
## Supporto
- Email: [email protected]
- Documentazione: https://your-domain.com/mcp-docs
- Problemi: https://github.com/yourcompany/mcp-server/issues
Quanti esempi di utilizzo sono richiesti?
MINIMO di tre esempi funzionanti che dimostrino la funzionalità principale.
Cosa si qualifica come un buon esempio:
Mostra il prompt/richiesta realistica dell'utente
Dimostra la funzionalità effettiva del server
Include l'output previsto o il comportamento
Flusso di lavoro chiaro e comprensibile
Copre diverse capacità
Formato di esempio:
## Esempi
### Esempio 1: Cerca documenti
**Prompt dell'utente:** "Trova i rapporti di progetto recenti nel mio workspace"
**Cosa succede:**
- Il server cerca il tuo workspace
- Restituisce i documenti corrispondenti con metadati
- Fornisce link di accesso rapido
### Esempio 2: Crea nuovo contenuto
**Prompt dell'utente:** "Crea una nuova lista di attività per la campagna di marketing"
**Cosa succede:**
- Il server crea una nuova lista di attività
- Aggiunge la struttura iniziale in base al contesto
- Restituisce il link alla lista appena creata
### Esempio 3: Aggiorna dati esistenti
**Prompt dell'utente:** "Aggiorna lo stato del progetto a 'In Corso' e aggiungi la milestone di oggi"
**Cosa succede:**
- Il server individua il progetto
- Aggiorna il campo dello stato
- Aggiunge la milestone con la data odierna
- Conferma le modifiche apportate
Requisiti:
Minimo 3 esempi (nessun massimo)
Coprire diversi strumenti/capacità
Mostrare interazioni utente realistiche
Dimostrare la proposta di valore
Includere nella documentazione del server
Quali sono i requisiti di disponibilità generale?
Il server deve essere in stato di Disponibilità Generale (GA).
Pronto per la produzione significa:
Il server è stabile e affidabile in produzione
Non contrassegnato come "beta", "alpha" o "development"
Tutte le funzionalità completamente implementate e testate
Gestione degli errori appropriata e fallimenti eleganti
Infrastruttura scalabile e monitoraggio
Documentazione completa e canali di supporto
Non può essere incluso: Versioni beta, server di sviluppo o servizi con accesso limitato.
Quali requisiti tecnici devono essere soddisfatti?
Deve soddisfare gli standard di conformità tecnica principale.
Trasporto e Prestazioni:
Deve supportare il trasporto HTTP Streamable (il supporto SSE potrebbe essere deprecato)
Tempi di risposta veloci con alta disponibilità
Gestione degli errori elegante con messaggi utili
Risposte efficienti in termini di token (massimo 25.000 token per risultato dello strumento)
Sicurezza e Dati:
HTTPS/TLS con certificati validi
CORS correttamente configurato per i client del browser
Supporto per tutte le origini client Claude richieste
Raccogliere solo i dati necessari per la funzionalità
Nessuna raccolta di dati di conversazione estranei
Pratiche di dati conformi alla privacy
3. Processo di Invio
Come invio il mio server MCP remoto?
Segui questo processo di invio passo dopo passo:
1. Checklist pre-invio:
Verifica i requisiti obbligatori:
[ ] Tutti gli strumenti hanno annotazioni readOnlyHint O destructiveHint
[ ] OAuth 2.0 implementato (se richiesta l'autenticazione)
[ ] Server accessibile tramite HTTPS
[ ] Indirizzi IP di Claude nella whitelist (se il server è dietro un firewall)
[ ] Documentazione completa pubblicata
[ ] Politica sulla privacy pubblicata e accessibile
[ ] Canali di supporto dedicati (email o web)
[ ] Account di test pronto (se richiesta l'autenticazione)
[ ] Il server è pronto per la produzione (stato GA)
Testa il tuo server:
[ ] Funziona correttamente da Claude.ai
[ ] Funziona correttamente da Claude Desktop
[ ] Funziona correttamente da Claude Code (se nessuna restrizione IP)
[ ] Il flusso OAuth si completa con successo
[ ] Tutti gli strumenti funzionano come documentato
[ ] I messaggi di errore sono utili e user-friendly
[ ] Le prestazioni sono accettabili sotto carico
2. Completa il modulo di invio:
Modulo di invio: MCP Directory Server Review Form
Informazioni richieste: Dettagli del server, link alla documentazione, credenziali di test, esempi (minimo 3) e informazioni di contatto. Il modulo fornisce un elenco completo.
Anche se ci sforziamo di rivedere ogni invio il più rapidamente possibile, a causa della quantità di interesse non possiamo promettere che accetteremo il tuo invio o che risponderemo individualmente.
4. Problemi Comuni
Quali sono i motivi più comuni per le richieste di revisione?
Questi sono i principali problemi in base ai dati di invio:
1. Annotazioni di strumenti mancanti
Problema: Gli strumenti mancano di annotazioni di sicurezza richieste
Soluzione: Aggiungi readOnlyHint o destructiveHint a TUTTI gli strumenti
Impatto: Rifiuto immediato, richiede modifiche al codice
Prevenzione: Convalida tutti gli strumenti prima dell'invio
2. Problemi di implementazione OAuth
Problema: Il flusso OAuth fallisce o ha errori di configurazione
Cause comuni:
URL di callback mancanti nel provider OAuth
Configurazione dell'URI di reindirizzamento non valida
Configurazione errata del firewall
Soluzione: Testa il flusso OAuth a fondo con MCP Inspector, Claude Code o Claude.ai
Impatto: Impossibile completare il test funzionale, ritarda l'approvazione
3. Documentazione incompleta
Problema: Esempi mancanti, istruzioni di configurazione poco chiare o sezioni richieste mancanti
Soluzione: Fornisci minimo 3 esempi dettagliati e completa tutte le sezioni della documentazione
Impatto: Richiesta di revisione, ritarda l'approvazione
Prevenzione: Segui esattamente il modello di documentazione
4. Problemi di disponibilità generale
Problema: Il server è contrassegnato come "beta" o mostra problemi di instabilità
Soluzione: Assicurati lo stato GA e la distribuzione stabile in produzione
Impatto: Non può essere incluso fino a quando non è pronto per la produzione
Prevenzione: Completa il test interno e la convalida della stabilità
5. Problemi di politica sulla privacy/canale di supporto
Problema: URL mancanti o inaccessibili per la politica sulla privacy/canali di supporto
Soluzione: Fornisci una politica sulla privacy appropriata e canali di supporto (email o web)
Impatto: Rifiuto immediato a causa del requisito di politica
Prevenzione: Verifica l'accessibilità della politica sulla privacy/canale di supporto prima dell'