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/discover o initialize): serverInfo con nome, titolo, versione, descrizione, sito e icone, e le instructions del server.
  • tools/list, con readOnlyHint e destructiveHint di ogni tool. Diventano le indicazioni Sola lettura, Scrive e Può eliminare sulla pagina. Anche prompts/list e resources/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-card e /.well-known/ai-catalog.json sul 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, websiteUrl e icons in serverInfo, 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 readOnlyHint e destructiveHint. Senza, la pagina non può dire quali tool si limitano a leggere.
  • Se tools/list richiede 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:

  1. Trova la tua scheda su Verifica e apri la sua pagina di verifica.
  2. Aggiungi il record TXT che mostra, mcp-tc-verification=…, sotto _mcp-tc o sul dominio stesso.
  3. Premi Avvia la verifica. Cerchiamo subito il record e, se c’è, una persona esamina la richiesta.
  4. 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

Markdown
[![DeepWiki on mcp.tc](https://mcp.tc/i/deepwiki/badge.svg)](https://mcp.tc/i/deepwiki)
Anteprima del badge, chiaroAnteprima del badge, scuro

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:

HTML
<script src="https://mcp.tc/w/deepwiki.js" async></script>

iframe

Per le pagine che non consentono script:

HTML
<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.