Per chi gestisce un server
Come il tuo server MCP entra in mcp.tc e resta esatto, e cosa puoi aggiungere: una spunta, un badge per il tuo README e una scheda per il tuo sito.
Entra in elenco
Incolla l’URL del tuo server nella pagina Proponi: un endpoint remoto, un repository GitHub o una pagina npm o PyPI. Non serve un account. La tua pagina di stato si aggiorna da sola e mostra il link quando è pronto, di solito in pochi minuti. Molti server vengono aggiunti senza che nessuno lo chieda: da un elenco curato di server noti e dal registro ufficiale MCP, che controlliamo ogni ora.
Cosa leggiamo
Il nostro controllo si collega come farebbe un client. Non invia mai credenziali e non esegue mai il tuo codice. Si identifica come mcp.tc-bot/1.0 (+https://mcp.tc/about) nello User-Agent e come mcp.tc-indexer nell’handshake MCP, e si ferma dopo 25 richieste o 60 secondi.
- L’handshake MCP (
server/discoveroinitialize):serverInfocon nome, titolo, versione, descrizione, sito e icone, e leinstructionsdel server. tools/list, conreadOnlyHintedestructiveHintdi ogni tool. Diventano le indicazioni Sola lettura, Scrive e Può eliminare sulla pagina. Ancheprompts/listeresources/list, quando il server li offre.- Come funziona l’accesso: un 401 con
WWW-Authenticate, e i metadati OAuth della risorsa protetta (RFC 9728). - La tua server card a
{endpoint}/server-carde/.well-known/ai-catalog.jsonsul tuo sito. - La tua voce nel registro ufficiale MCP (
server.json). - Il tuo repository (
server.json,package.json,pyproject.toml,manifest.json, il README), la tua pagina npm o PyPI, e titolo, descrizione e icone del tuo sito.
Poi un modello di AI (Claude, di Anthropic) prepara la scheda da questi dati pubblici: il riassunto, la categoria, cosa puoi fare e alcuni prompt di esempio. Funziona senza strumenti, quindi istruzioni nascoste in un manifest non possono fargli fare nulla, e sono controlli fissi a decidere cosa succede dopo. Una proposta va online da sola solo quando il server ha risposto, non è stato segnalato nulla e il nome o il fornitore corrispondono al dominio dell’URL del server (per un server locale, il proprietario del repository, lo scope npm o il namespace del registro). Tutto il resto aspetta una persona. I termini elencano ogni controllo.
La scheda è scritta in inglese. Lo stesso modello ne traduce poi il testo in italiano, francese, tedesco e spagnolo per le altre versioni linguistiche del sito; la traduzione si aggiorna quando cambia il testo inglese.
Aiuta la scheda a venire bene
- Compila
title,description,websiteUrleiconsinserverInfo, con icone in PNG, WebP o JPEG (ignoriamo le icone SVG e ICO). Le icone del server attivo hanno la precedenza su quelle del registro, della server card e del tuo sito. - Annota i tuoi tool con
readOnlyHintedestructiveHint. Senza, la pagina non può dire quali tool si limitano a leggere. - Se
tools/listrichiede un accesso, non possiamo leggere i tuoi tool. La pagina spiega allora perché l’elenco è vuoto. - Pubblica nel registro ufficiale MCP con il tuo namespace. La scheda avrà allora quel nome, anche nella nostra API del registro.
- Il link viene dal nome del server, senza parole come «MCP server»: un server chiamato Acme Docs MCP riceve
mcp.tc/i/acme-docs.
Mantieni la scheda esatta
I server remoti vengono ricontrollati ogni giorno. Il controllo ripete l’handshake e aggiorna tool, versione e stato mostrati sulla pagina. Non riscrive mai la descrizione, e una modifica all’insieme dei nomi dei tool aspetta il controllo di una persona. Un server che continua a fallire per più di tre giorni riceve il badge Ultimo controllo fallito; uno che all’improvviso risponde da un URL diverso lo riceve subito, finché la scheda non viene aggiornata. Non eseguiamo mai i server locali, quindi non possono essere controllati in questo modo.
Le modifiche fatte da una persona restano: gli aggiornamenti automatici non le sovrascrivono mai. Per cambiare la descrizione, la categoria, il nome o un URL, invia una correzione dalla pagina di segnalazione. Se sposti il tuo server su un nuovo URL, diccelo lì, così la scheda e ogni passaggio di configurazione si aggiornano.
La spunta di verifica
La spunta dopo il nome di un server dice chi lo gestisce. Non è un controllo di sicurezza. I server ufficiali dei fornitori noti la ricevono dopo un controllo manuale. Chiunque altro può dimostrare di controllare il dominio con un record DNS:
- Trova la tua scheda su Verifica e apri la sua pagina di verifica.
- Aggiungi il record TXT che mostra,
mcp-tc-verification=…, sotto_mcp-tco sul dominio stesso. - Premi Avvia la verifica. Cerchiamo subito il record e, se c’è, una persona esamina la richiesta.
- Mantieni il record. Lo controlliamo ogni giorno, e se sparisce riesaminiamo la scheda e di solito togliamo la spunta.
Il dominio è quello dell’URL del tuo server. Il dominio del tuo sito vale quando il server gira in locale o il suo URL è sul dominio di una piattaforma di hosting. Una volta verificata la scheda, gli aggiornamenti automatici non ne cambiano più URL, pacchetto o fornitore.
Badge ed embed
Mostra la tua scheda nel tuo README o sul tuo sito. Ogni embed usa l’URL o il pacchetto del tuo server, rimanda alla scheda e non imposta cookie. Sostituisci deepwiki con il nome della tua scheda.
Badge per il README
[](https://mcp.tc/i/deepwiki)Scheda per il tuo sito
Un solo tag script. Mostra cosa serve al server, il suo URL o il comando di installazione con un pulsante Copia, e pulsanti in un clic per Claude Code, Cursor, VS Code e claude.ai, per i client che possono usarlo:
<script src="https://mcp.tc/w/deepwiki.js" async></script>iframe
Per le pagine che non consentono script:
<iframe src="https://mcp.tc/embed/deepwiki" title="DeepWiki on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>La sezione Embed della tua scheda li ha tutti già compilati, con anteprime dal vivo. Badge ed embed spiega temi, dimensioni e il JSON della scheda. Gli embed sono in inglese, qualunque sia la lingua della pagina che li ospita.
Modifiche e rimozione
Usa la pagina di segnalazione per correggere una scheda o farla rimuovere, compresa la tua. Dimostra che è tua con un’email dal tuo dominio o con un commit che cita mcp.tc. Una persona legge ogni segnalazione.
Il link di una scheda rimossa risponde 410 Gone, ai browser come ai client MCP, e la scheda esce dalle sitemap e dall’API del registro (dove i client che lo chiedono la vedono come eliminata per 180 giorni). Una scheda rinominata mantiene il vecchio link: i browser vengono portati a quello nuovo.
Il link della tua scheda è sempre una pagina. Un client che prova a collegarcisi riceve un errore che indica l’URL del tuo server o il suo comando di installazione, così chi incolla il link sbagliato trova quello giusto. mcp.tc non inoltra mai traffico MCP al tuo server.