Per chi gestisce un server
Come il tuo server MCP entra in mcp.tc, come ne modifichi la scheda e cosa puoi aggiungere: una spunta, un badge per il tuo README e una card 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. Uno script può inviare la stessa proposta in JSON: Proporre un server da uno script spiega come. 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/ard.json(o/.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 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.
Per una scheda migliore
- 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 né controllare se cambiano. 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
Ogni 3 ore rileggiamo l’elenco dei tool di ogni server remoto che lo mostra senza accesso, e il manifest.json dei server i cui tool vengono da un bundle MCP. Per un server locale pubblicato su npm o PyPI controlliamo l’ultima versione. Quando i tool cambiano e una seconda lettura lo conferma, la scheda mostra subito il nuovo elenco e la sua Cronologia registra cosa è cambiato: tool aggiunti o rimossi, nuove descrizioni, schemi e indicazioni, nuove istruzioni del server. Un nuovo tool compare con il titolo o la descrizione che gli dà il tuo server. Chi segue la scheda riceve un’email. Cronologia e avvisi spiega le regole.
Una volta al giorno ripetiamo anche l’handshake con ogni server remoto per aggiornarne lo stato. Nessuno dei due controlli riscrive la descrizione. 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.
Le modifiche fatte da una persona restano, comprese le tue: gli aggiornamenti automatici non le sovrascrivono mai. Il modo più rapido per correggere la tua scheda è modificarla tu. Il nome, il fornitore e il passaggio a un altro dominio passano dalla pagina di segnalazione: diccelo lì, così la scheda e ogni passaggio di configurazione si aggiornano.
Modifica la tua scheda
Accedi con GitHub o con un codice inviato via email, poi rivendica la tua scheda. Ti mostriamo un record DNS TXT, un file o un meta tag da aggiungere sul dominio dove vive il tuo server: quello del suo URL, o della sua homepage per un server locale. Quando lo troviamo, puoi modificare la scheda: le descrizioni, la categoria, i tag, cosa puoi fare, i prompt di esempio, le note di configurazione, i link e l’icona. Le modifiche vanno online appena salvi e ognuna viene registrata.
- Lascia il record, il file o il tag al suo posto. Lo controlliamo ogni giorno e, se manca per una settimana, le modifiche restano sospese finché non lo dimostri di nuovo.
- L’URL del server può spostarsi solo dentro il dominio che hai dimostrato, e un pacchetto npm solo dentro il suo scope. Dopo un nuovo URL o pacchetto controlliamo di nuovo il server, così gli strumenti e l’accesso mostrati nella pagina si aggiornano.
- Se hai effettuato l’accesso più di 15 minuti fa, per cambiare un link, l’URL del server, il pacchetto o le note di configurazione ti chiediamo prima di confermare che sei tu.
- Ogni modifica che salvi compare nella Cronologia pubblica della scheda come modifica di chi gestisce il server, con il testo prima e dopo (per le note di configurazione, solo il fatto che sono cambiate) ma senza il tuo nome né il tuo account, e arriva via email a chi segue la scheda. Se annulliamo una modifica, nascondiamo la sua voce.
- Con un record DNS puoi anche richiedere la spunta di verifica dal tuo account.
- Il tuo account mostra le statistiche di ogni scheda: visualizzazioni giornaliere, clic sui pulsanti (copia, aggiungi a un client, schede di configurazione, link), da dove arrivano i visitatori, i loro paesi e la lingua della pagina. I conteggi sono anonimi, uno per visitatore al giorno, senza i bot; vedi l’informativa sulla privacy.
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:
- Cerca la tua scheda nella pagina della spunta e aprila.
- Aggiungi il record TXT che mostra,
mcp-tc-verification=…, sotto_mcp-tco sul dominio stesso. - Premi Richiedi la spunta. 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)Card 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, a meno che tu non aggiunga ?lang=it, fr, de o es al loro indirizzo.
Dalla riga di comando
Ti aiuta anche mcp-tc, il nostro strumento open source da riga di comando. Richiede Node.js 20 o successivo:
npx mcp-tc create my-servercrea un nuovo progetto di server MCP da un modello: Streamable HTTP su Express, Cloudflare Workers o un server locale su stdio.npx mcp-tc check https://mcp.example.com/mcplegge il tuo server come lo legge mcp.tc ed elenca cosa impedirebbe ai client o alla scheda di leggerlo bene. Non può dirti se il server verrà pubblicato su mcp.tc.npx mcp-tc cardcrea una server card e unserver.jsonper il registro ufficiale MCP.npx mcp-tc submit https://mcp.example.com/mcpinvia la stessa proposta della pagina Proponi e aspetta il risultato.npx mcp-tc badge <slug>stampa il badge per il README e gli snippet per il sito web della tua scheda.npx mcp-tc dns-check example.comcerca il tuo record TXTmcp-tc-verification=sul dominio e sotto_mcp-tc, così puoi controllarlo prima di richiedere la spunta.
Modifiche e rimozione
Usa la pagina di segnalazione per far rimuovere una scheda, compresa la tua, o per correggere ciò che non puoi modificare da solo. 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.