Questa è una guida completa per inviare il tuo server locale (MCPB) alla directory pubblica di Anthropic per una distribuzione e visibilità più ampie.
Prerequisiti
Prima di leggere questa guida, dovresti avere:
Un MCPB funzionante
Codice portabile che utilizza la sostituzione di variabili
Buoni messaggi di errore e user experience
Dipendenze pulite e raggruppate
Nuovo allo sviluppo MCPB? Consulta prima Building MCPB Extensions. Per le best practice tecniche (testing, messaggi di errore, portabilità), consulta MCPB Repository.
Nota: Questa guida riguarda i server MCP locali. Per le estensioni desktop remote, consulta Remote MCP Server Submission Guide.
1. Panoramica della Directory
Quali sono i vantaggi dell'inclusione nella directory?
Visibilità e fiducia:
Elencato nella directory ufficiale di Anthropic all'interno di Claude Desktop
Ricercabile dai singoli utenti di Claude Desktop
Visibile agli utenti Teams/Enterprise quando aggiunto alla lista consentita dagli amministratori
La revisione di Anthropic crea fiducia negli utenti
Esperienza utente:
Installazione con un clic dalla directory
Integrato con l'interfaccia delle impostazioni di Claude Desktop
Presentazione standardizzata
Supporto e credibilità:
Revisione di Anthropic della qualità e sicurezza
Elencato insieme ad altre estensioni revisionate
Visibilità e feedback della community
Canale di distribuzione professionale
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 una richiesta di revisione.
Nota: Questi sono requisiti specifici della directory di Anthropic.
Per le best practice generali di sviluppo MCPB (testing, gestione degli errori, portabilità), consulta il MCPB Repository README.
Le annotazioni degli strumenti sono obbligatorie?
SÌ. Ogni strumento DEVE avere e mantenere annotazioni di sicurezza accurate.
Obbligatorio su ogni strumento:
readOnlyHint: true - Per strumenti che leggono solo dati
destructiveHint: true - Per 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 |
Legge solo dati | readOnlyHint: true | search, get, list, fetch, read |
Scrive/modifica dati | destructiveHint: true | create, update, delete, send, write |
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 |
Dettagli di implementazione: Consulta MCP Protocol - Tools per:
Schema completo degli strumenti con annotazioni
Struttura della definizione degli strumenti
Specifiche dello schema input/output
Proprietà aggiuntive degli strumenti (incluso il campo title facoltativo)
Validazione prima dell'invio:
# Verifica che tutti gli strumenti abbiano annotazioni
grep -A 5 -B 5 "readOnlyHint\|destructiveHint" server/
# Verifica che ogni strumento abbia esattamente un'annotazione
Impatto: La prima cosa che controlliamo e il motivo più comune per una richiesta di revisione.
Annotazione aggiuntiva consigliata:
title - Nome dello strumento leggibile dall'utente per la visualizzazione nell'interfaccia (migliora l'esperienza utente)