Questa è una guida completa per inviare il tuo server locale (MCPB) alla directory pubblica di Anthropic per una distribuzione e una scoperta più ampia.
Prerequisiti
Prima di leggere questa guida, dovresti avere:
Un MCPB funzionante
Codice portabile che utilizza la sostituzione di variabili
Messaggi di errore e esperienza utente di qualità
Dipendenze pulite e raggruppate
Nuovo allo sviluppo di MCPB? Vedi Building MCPB Extensions per primo. Per le migliori pratiche tecniche (test, messaggi di errore, portabilità), vedi MCPB Repository.
Nota: Questa guida copre i server MCP locali. Per le estensioni desktop remote, vedi Remote MCP Server Submission Guide.
1. Panoramica della Directory
Quali sono i vantaggi dell'inclusione nella directory?
Scoperta 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 di autorizzazione dagli amministratori
La revisione di Anthropic costruisce la fiducia degli utenti
Esperienza utente:
Installazione con un clic dalla directory
Integrato con l'interfaccia utente delle impostazioni di Claude Desktop
Presentazione standardizzata
Supporto e credibilità:
Revisione di Anthropic della qualità e della sicurezza
Elencato insieme ad altre estensioni revisionate
Visibilità della comunità e feedback
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à un rifiuto o una richiesta di revisione.
Nota: Questi sono requisiti specifici della directory di Anthropic.
Per le migliori pratiche generali di sviluppo di MCPB (test, gestione degli errori, portabilità), vedi 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 gli strumenti che solo leggono i dati
destructiveHint: true - Per gli strumenti che modificano i dati o hanno effetti collaterali
Vedi MCP Protocol - Tool Annotations per lo schema completo e i dettagli di implementazione.
Non è opzionale. Questo è un requisito rigoroso derivato dalla MCP Directory Policy.
Come decidere quale annotazione:
Comportamento dello Strumento | Annotazione | Esempi |
Solo lettura dei dati | readOnlyHint: true | search, get, list, fetch, read |
Scrittura/modifica dei 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: Vedi MCP Protocol - Tools per:
Schema completo dello strumento con annotazioni
Struttura della definizione dello strumento
Specifiche dello schema di input/output
Proprietà aggiuntive dello strumento (incluso il campo titolo opzionale)
Validazione prima dell'invio:
# Controlla 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'uomo per la visualizzazione