Serveur MCP Total CMS
Commit 24 oct. 2026Connecte Claude à un site Total CMS pour rechercher du contenu, lire la documentation et gérer les données du site via une clé API.
Aussi connu sous totalcms/mcpb, mcpb
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.2.3
- Dernier commit
- 24 oct. 2026
- Licence
- MIT
Qu'est-ce que Total CMS MCP ?
Connecte Claude à un site Total CMS pour rechercher du contenu, lire la documentation et gérer les données du site via une clé API.
Résumé généré à partir du README du projet
À propos du MCP server Total CMS
Total CMS agit comme un pont local qui connecte les clients IA comme Claude Desktop à un site web Total CMS. Il fonctionne comme un processus Node léger s'exécutant sur votre machine, qui sert de proxy pour le trafic MCP vers un endpoint de site spécifique via HTTPS. Cette configuration permet à l'IA d'interagir avec le contenu et la documentation de votre site en ajoutant un header X-API-Key personnalisé pour les requêtes authentifiées, une fonctionnalité non disponible via les connecteurs distants standards.
Les utilisateurs peuvent utiliser le serveur en mode zero-config pour interroger la documentation officielle de Total CMS ou se connecter à leurs propres sites en fournissant une URL d'endpoint MCP spécifique. En ajoutant une clé API optionnelle depuis les paramètres d'administration de Total CMS, l'IA obtient des permissions basées sur les scopes définis de la clé. Cela peut aller d'un accès en lecture seule à des capacités d'administration complètes, incluant la gestion des schémas, des templates et du cache du site. Le serveur est compatible avec tout client prenant en charge les serveurs stdio locaux, tels que Cursor, VS Code ou Windsurf, à condition qu'ils utilisent Node 18 ou une version ultérieure.
Ce que vous pouvez faire avec
- 1Parcourir les collections du siteRecherchez et explorez le contenu public et les collections hébergés sur votre site Total CMS spécifique.
- 2Effectuer la gestion administrative du siteUtilisez une clé API d'administration complète pour permettre à l'IA de gérer les templates, les informations du site et de vider le cache.
- 3Gérer les données du site via les scopes APIContrôlez la capacité de l'IA à lire ou écrire des données en configurant des chemins de clé API et des méthodes HTTP spécifiques.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Configuration
API_KEYMCP_URL
| Nom | Description | Type |
|---|---|---|
| API_KEY | — | |
| MCP_URL | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibletotalcms/mcpb is public and reachablegithub.com/totalcms/mcpb ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-24github.com/totalcms/mcpb ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubTotal CMS Desktop Extension (MCPB)
A Claude Desktop extension that connects Claude to any Total CMS site's built-in MCP server. Install once, and Claude can search docs, browse content, and (with an API key) manage your Total CMS site directly.
This is a local bridge, not a hosted connector: it runs as a small Node
process on your machine and proxies MCP traffic to your site's /mcp
endpoint over HTTPS. That's what lets it attach a custom X-API-Key header
for authenticated access - something Claude Desktop's built-in remote
connectors can't do for servers that advertise optional auth.
Privacy Policy
This extension does not collect, transmit, or store any data of its own. It
opens an HTTPS connection directly from your machine to the Total CMS MCP
endpoint you configure (default: https://totalcms.co/mcp, the official
Total CMS docs site) and relays MCP protocol messages between Claude Desktop
and that endpoint. Your optional API key is stored in your OS's secure
credential store (via Claude Desktop's sensitive: true config handling) and
is sent only as an X-API-Key request header to the site you configured -
never logged, never sent anywhere else.
For the privacy policy of the Total CMS product and totalcms.co itself, see https://totalcms.co/privacy.
Setup
Zero-config: ask about Total CMS itself
Just install the extension. It defaults to https://totalcms.co/mcp, the
official Total CMS documentation server, so Claude can immediately answer
questions like "how do I set up webhooks in Total CMS?" or "what schema
fields does Total CMS support?" with no configuration.
Connect to your own site
- In your Total CMS admin, go to Settings -> MCP and copy your site's
MCP endpoint URL (it will look like
https://yoursite.com/mcp, or include a subpath if you installed Total CMS in one). - In Claude Desktop's extension settings for Total CMS, paste that URL into Total CMS MCP endpoint.
- Reinstall/reconnect. Claude can now browse and search your site's public collections.
Authenticated access
- Create a Total CMS API key for your site in Settings → API Keys. What
the key's Scopes allow is exactly what Claude can do:
- Full admin access: All endpoints (
*) with every HTTP method. - Limited access: add
/mcpto the key's paths, plus the collections it should reach, such as/api/collections/blog./mcpon its own opens the endpoint but reaches no content. The key's HTTP methods decide its tools: a GET-only key connects read-only. A limited key reaches a collection only when that collection's MCP access is API keys or wider. See Keys over MCP.
- Full admin access: All endpoints (
- Paste it into the API key (optional) field in the extension settings. It's stored in your OS keychain, not in plain text.
- Claude now reaches what the key allows, in addition to public content. With a full admin key that includes schema management, templates, site info and cache clearing. Leave the field empty to keep Claude limited to public, anonymous access.
Other MCP clients
The bridge is a plain stdio MCP server, so any client that launches local
servers (Cursor, VS Code, Windsurf, and others) can run it with Node 18 or
later. A client that supports remote servers with custom headers can skip
the bridge and connect to your site's /mcp endpoint directly.
-
Download
totalcms.mcpbfrom the latest release. It is a zip archive: unzip it anywhere.server/index.jsinside is self-contained and needs nonpm install. -
Add it to your client's MCP configuration:
{ "mcpServers": { "totalcms": { "command": "node", "args": ["/path/to/totalcms/server/index.js"], "env": { "MCP_URL": "https://yoursite.com/mcp", "API_KEY": "" } } } }Leave
MCP_URLempty to use the Total CMS docs server, and leaveAPI_KEYempty for public, anonymous access.
To build from source instead, npm install && npm run build writes
server/index.js.
How it works
server/index.js is a small stdio MCP server that Claude Desktop spawns
directly (no Node install required - MCPB bundles include their own
runtime handling). It opens a
streamable HTTP
connection to the MCP_URL you configured and forwards every JSON-RPC
message in both directions verbatim: initialize, tools/list,
tools/call, resources/*, prompts/*, and all notifications. When
API_KEY is set, every outbound HTTP request carries an X-API-Key header.
It refuses to start unless MCP_URL is https:// - plaintext credentials on
the wire are not acceptable, even for local testing.
Why not mcp-remote?
We spiked it first (see BUILD-REPORT.md for the full writeup). Short
version: mcp-remote unconditionally runs OAuth discovery on startup and,
on any HTTP 401 response, launches a browser-based OAuth authorization flow
with no flag to disable it. Total CMS uses a plain API-key header, not OAuth
- a bad key needs to surface as a clean 401 error to the MCP client, not
hang behind a browser popup trying to OAuth against a server that doesn't
implement it. So this bundle ships a small hand-rolled proxy built directly
on
@modelcontextprotocol/sdk'sStreamableHTTPClientTransportandStdioServerTransportinstead.
Development
npm install
npm run build # typecheck -> esbuild bundle -> mcpb validate -> mcpb pack
Produces dist/totalcms.mcpb. Install by dragging that file onto Claude
Desktop.
npm run typecheck and npm run validate are available standalone.
Releasing
npm run bump 0.3.0 # rewrites the version in all four files
# add a "## [0.3.0] - YYYY-MM-DD" section to CHANGELOG.md
git commit -am "Release v0.3.0"
git tag v0.3.0 && git push origin master v0.3.0
Pushing the tag is the whole release. The Release workflow builds the
bundle, attaches it to a GitHub release, and publishes the new version to the
MCP Registry as
io.github.totalcms/total-cms.
The GitHub release notes are the matching CHANGELOG.md section, so that
file is where a release gets described — write it before tagging. A missing
section warns and falls back to generated notes rather than failing the build;
a release should never be blocked because its prose was not written.
Two more things worth knowing:
- The registry is a separate system from GitHub Releases. People who installed from the MCP directory get updates from the registry, not from the release page — publishing one without the other leaves them stranded on the old version. That is why the workflow does both, and why it is worth never publishing a release by hand.
fileSha256inserver.jsonis stamped by CI, because a zip embeds timestamps and a CI build never hashes identically to a local one. The value committed to git is only a record of the last local build; ignore it.
Authentication to the registry is GitHub OIDC, so there is no secret to
rotate. To re-publish a tag that already exists — or one released before this
workflow existed — run the Release workflow manually from the Actions tab
and give it the tag.
Security notes
- Zero filesystem access, zero subprocess spawns, outbound HTTPS to exactly
one host (whatever
MCP_URLpoints at). - The API key is read from the
API_KEYenvironment variable (set by Claude Desktop from your keychain-stored config) and is never written to stdout, stderr, or any log. MCP_URLmust behttps://or the process refuses to start.
License
Source code is MIT licensed. The Total CMS name, flame logo, and
the bundled icon.png are trademarks and are not covered by that grant — you
may fork the code, but a redistributed version must not present itself as
published or endorsed by Total CMS. See TRADEMARKS.md.
Questions sur Total CMS MCP
Comment connecter mon propre site Total CMS ?
Allez dans l'administration de votre Total CMS, naviguez vers Settings -> MCP, copiez l'URL de l'endpoint MCP de votre site, puis collez-la dans les paramètres de l'extension Claude Desktop.
Claude peut-il gérer le contenu de mon site ?
Oui, si vous fournissez une clé API avec les scopes appropriés, Claude peut effectuer des tâches administratives telles que la gestion des schémas, l'édition de templates et la purge du cache.
Ma clé API est-elle stockée de manière sécurisée ?
Oui, la clé API est stockée dans le gestionnaire d'identifiants sécurisé de votre système d'exploitation et n'est jamais enregistrée dans des logs ou envoyée ailleurs.
Cela fonctionne-t-il avec d'autres clients MCP que Claude Desktop ?
Oui, tout client prenant en charge les serveurs stdio locaux comme Cursor, VS Code ou Windsurf peut l'utiliser avec Node 18 ou une version ultérieure.