Badges et intégrations
Placez n’importe quel serveur MCP référencé dans un README ou sur un site avec un badge, une carte de configuration en un clic ou une iframe, ou lisez sa fiche en JSON. Chaque intégration renvoie à la page du serveur sur mcp.tc et utilise l’URL du serveur lui-même.
Badge pour README
Une petite image avec le symbole mcp.tc et le nom du serveur, plus la coche quand la fiche est vérifiée. Entourez-la d’un lien vers la fiche :
[](https://mcp.tc/i/deepwiki)<a href="https://mcp.tc/i/deepwiki"><img src="https://mcp.tc/i/deepwiki/badge.svg" alt="DeepWiki on mcp.tc" height="20"></a>
?theme=auto(par défaut) suit le mode clair ou sombre du lecteur ;?theme=lightet?theme=darkle fixent.?style=compactaffiche le symbole sans le mot « mcp.tc » (deuxième ligne ci-dessus).
C’est un simple SVG de moins de 2 Ko sans rien d’autre à charger : il fonctionne dans les README GitHub et partout où les images fonctionnent. Badges, cartes et iframes sont en anglais, quelle que soit la langue de la page qui les accueille.
Carte pour votre site
Collez une seule balise là où la carte doit apparaître :
<script src="https://mcp.tc/w/deepwiki.js" async></script>Ou placez un conteneur où vous voulez et chargez le script une fois, n’importe où sur la page. Chaque conteneur de ce serveur reçoit une carte. Ce que vous mettez dans un conteneur reste affiché jusqu’à ce que la carte le remplace, et reste pour les visiteurs sans JavaScript :
<div data-mcptc="deepwiki"><a href="https://mcp.tc/i/deepwiki">DeepWiki on mcp.tc</a></div>
<script src="https://mcp.tc/w/deepwiki.js" async></script>data-theme:auto(par défaut, suit le mode clair ou sombre du visiteur),lightoudark.data-size:full(par défaut, avec l’accroche) oucompact.- La carte fait au plus 520 px de large (420 px en compact) et s’adapte aux espaces plus étroits. Définissez la variable CSS
--mcptc-max-widthsur le conteneur ou un parent pour changer cela.
Elle montre l’icône, le nom et la coche, ce dont le serveur a besoin (connexion, clé, installation locale), l’URL du serveur ou sa commande d’installation avec un bouton Copy, des boutons « Add to » en un clic pour Claude Code, Cursor, VS Code et claude.ai (pour les clients qui peuvent l’utiliser), et un lien vers la fiche.
Ce qu’elle fait sur votre page
- Chaque fichier contient tout : les données de la fiche, les styles et l’icône. Il ne fait aucune autre requête et n’utilise ni cookies ni stockage local, il n’y a donc rien pour suivre les visiteurs.
- Elle se dessine dans une shadow root fermée : vos styles ne l’atteignent pas et les siens n’atteignent pas votre page.
- Elle écrit le texte uniquement comme texte (jamais comme HTML) et ne renvoie qu’à mcp.tc et aux pages d’installation des clients, en HTTPS.
- Avec une Content Security Policy, autorisez
script-src https://mcp.tc. L’icône est une imagedata:; si votre politique les bloque, la carte affiche à la place la première lettre du nom. - Pour un slug non référencé, rien n’apparaît et la console du navigateur affiche un avertissement.
iframe
Pour les pages qui n’autorisent pas les scripts, comme les créateurs de sites et les wikis, la carte compacte existe aussi sous forme de page à part entière :
<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>- Elle fait 200 px de haut à toute largeur à partir de 320 px. Les noms et URL longs se terminent par des points de suspension, et les boutons « Add to » défilent sur le côté quand ils ne tiennent pas.
?theme=lightou?theme=darkfixe les couleurs ; sans cela, la carte suit le mode du visiteur.allow="clipboard-write"fait fonctionner ses boutons Copy. C’est la seule page de mcp.tc que d’autres sites peuvent encadrer, et les moteurs de recherche ne l’indexent pas.
Les données de la fiche en JSON
Chaque fiche est aussi disponible en JSON, pour vos propres pages et outils :
https://mcp.tc/i/deepwiki.jsonN’importe quel site peut la lire : la réponse porte Access-Control-Allow-Origin: *. Elle est en lecture seule et ne demande aucune clé. Un slug non référencé reçoit 404 et une fiche retirée 410, avec error à not_found ou gone. Les champs sans valeur valent null, ils ne sont jamais omis. Le texte est l’original anglais de la fiche.
| Champ | Type | Ce que c’est |
|---|---|---|
slug | chaîne | Le slug actuel de la fiche. Les anciens slugs et les alias renvoient la fiche actuelle, donc lisez-le ici. |
name | chaîne | Nom du serveur. |
vendor | chaîne ou null | Qui fait le serveur. |
tagline | chaîne ou null | Une ligne, jusqu’à 200 caractères. |
description | chaîne ou null | Texte brut, paragraphes séparés par une ligne vide, jusqu’à 2 000 caractères. Un modèle d’IA l’a rédigé à partir des métadonnées publiques du serveur. |
link | chaîne | La page de la fiche, https://mcp.tc/i/{slug}. |
categorycategory_name | chaîne ou null | Slug de catégorie (comme dans /c/{slug}) et son nom. |
kind | chaîne | remote (connexion en HTTPS) ou local (tourne sur votre ordinateur). |
transport | chaîne | streamable-http, sse ou stdio. |
auth | chaîne | none, oauth, api_key, optional ou unknown. |
access | objet | Comment mcp.tc le qualifie : group (ok, auth ou local, le filtre Accès de l’annuaire), label (texte du badge, comme « No sign-in »), text (forme longue) et note (une phrase). |
endpoint | chaîne ou null | L’URL du serveur lui-même (serveurs distants). C’est à elle qu’un client se connecte. |
install_command | chaîne ou null | La commande qui lance un serveur local, comme npx -y @playwright/mcp. |
package | objet ou null | registry (npm, pypi, oci, nuget…) et identifier. |
relay | booléen | False pour chaque fiche : le lien mcp.tc est une page, et les clients se connectent à l’URL du serveur lui-même. Le champ reste pour que les lecteurs existants continuent de fonctionner. |
verifiedverified_by | booléen, chaîne ou null | La coche, et ce qu’elle signifie pour cette fiche. |
icon | chaîne ou null | URL de l’icône 128 × 128 de la fiche sur mcp.tc. |
tools_counttools | nombre, tableau | Les outils lus sur le serveur (jusqu’à 150) : name, summary et read_only / destructive (true, false, ou null quand le serveur ne le dit pas). |
add | tableau | Les actions en un clic : client (claude-code, cursor, vscode, claude-ai), label, kind et value : une commande à copier pour copy, un lien d’installation pour link. Elles utilisent toujours l’URL ou le paquet du serveur lui-même. |
homepagerepositorydocs | chaîne ou null | Liens de la fiche. |
health | chaîne | Notre dernière vérification : ok, auth (il a répondu et demandé une connexion), down ou unknown (les serveurs locaux ne sont pas vérifiés). |
last_checkedlistedupdated | chaîne ou null | Horodatages ISO 8601 en UTC : la dernière vérification, la date de référencement, la dernière modification du contenu. |
embeds | objet | Les URL badge, widget, iframe et markdown de cette fiche. |
format | chaîne | Un lien vers cette page. |
L’annuaire dans son ensemble a ses propres formats : l’index de recherche, l’API compatible avec le registre MCP et la liste llms.txt. Ajoutez .md au lien d’une fiche pour du Markdown.
Cache et confidentialité
- La carte et l’iframe contiennent des boutons d’installation, elles se mettent donc à jour rapidement. Notre CDN (Cloudflare) garde le script de la carte 15 minutes et les navigateurs jusqu’à 4 heures. L’iframe et le JSON viennent de mcp.tc à chaque requête, et les navigateurs les gardent 10 minutes.
- Le badge n’affiche qu’un nom. Cloudflare le garde un jour et les navigateurs jusqu’à 4 heures ; pendant qu’il rafraîchit une copie, Cloudflare peut servir l’ancienne jusqu’à une semaine.
- Les intégrations ne déposent aucun cookie, et leurs requêtes ne sont pas inscrites dans notre journal d’accès. La politique de confidentialité donne les détails.
- Vous pouvez les utiliser pour n’importe quel serveur référencé, sur n’importe quel site, gratuitement. Le badge indique qu’un serveur est référencé sur mcp.tc, et la coche dit qui l’exploite. Ni l’un ni l’autre n’est un audit de sécurité.