Noi e terze parti selezionate usiamo cookie o tecnologie simili per finalità tecniche e, con il tuo consenso, per analizzare l’uso del sito.

Puoi liberamente prestare, negare o revocare il tuo consenso in qualsiasi momento.

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/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/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, 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 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:

  1. Cerca la tua scheda nella pagina della spunta e aprila.
  2. Aggiungi il record TXT che mostra, mcp-tc-verification=…, sotto _mcp-tc o sul dominio stesso.
  3. Premi Richiedi la spunta. 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

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:

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, 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-server crea 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/mcp legge 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 card crea una server card e un server.json per il registro ufficiale MCP.
  • npx mcp-tc submit https://mcp.example.com/mcp invia 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.com cerca il tuo record TXT mcp-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.