Connect Profound CMS to your AI client

Profound CMS fournit un serveur MCP distant qui permet aux clients IA compatibles de découvrir, créer, mettre à jour, publier et gérer le contenu du CMS.

Point de terminaison MCP :

http://107.21.107.99:8081/mcp

En production, utilisez la version HTTPS de l’URL MCP configurée dès qu’elle est disponible.

Authentification

Le MCP de Profound CMS utilise OAuth via WorkOS.

Pour vous connecter :

1. Créez un compte Profound CMS.
2. Vérifiez que votre compte appartient à la bonne organisation.
3. Ajoutez le serveur MCP à votre client IA.
4. Effectuez la connexion dans le navigateur lorsque vous y êtes invité.

Vous n’avez pas besoin de copier une clé API dans votre client IA. Après la connexion, le client reçoit un jeton d’accès à courte durée de vie et le renouvelle automatiquement.

Votre rôle dans le CMS contrôle les accès :

• Les membres peuvent lire le contenu du CMS.
• Les éditeurs et les administrateurs peuvent créer, mettre à jour et publier du contenu.

Claude Code

Exécutez :

claude mcp add --transport http Profound http://107.21.107.99:8081/mcp

Lancez ensuite Claude Code et terminez le processus d’authentification dans le navigateur.

Vérifiez la connexion :

claude mcp list

Codex CLI

Exécutez :

codex mcp add Profound --url http://107.21.107.99:8081/mcp

Codex demandera une authentification lors de la première utilisation du serveur.

Vous pouvez vérifier la connexion avec :

codex mcp list

OpenCode

Ajoutez ce qui suit dans :

~/.config/opencode/opencode.json

{
  "mcp": {
    "profound": {
      "type": "remote",
      "url": "http://107.21.107.99:8081/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

Puis authentifiez-vous :

opencode mcp auth profound

Vérifiez la connexion :

opencode mcp list

Le serveur devrait apparaître comme connecté via OAuth.

Cursor, Windsurf et autres clients MCP

La plupart des clients compatibles avec MCP prennent en charge la configuration HTTP distante standard :

{
  "mcpServers": {
    "profound": {
      "url": "http://107.21.107.99:8081/mcp"
    }
  }
}

Dans Cursor, Windsurf, Claude Desktop ou un autre client MCP :

1. Ouvrez les paramètres MCP ou des intégrations.
2. Ajoutez un serveur MCP HTTP distant.
3. Utilisez l’URL MCP de Profound.
4. Activez l’authentification OAuth si le client propose une option OAuth.
5. Connectez-vous à Profound CMS dans votre navigateur.

Le client doit prendre en charge MCP via HTTP diffusable (Streamable HTTP) et OAuth. Les clients qui ne prennent en charge que les serveurs locaux ou les clés API statiques ne peuvent pas s’authentifier directement auprès de ce serveur.

Commencez chaque session par une découverte

Après la connexion, demandez à votre client IA de découvrir les organisations et les sites web auxquels vous avez accès :

Utilise uniquement le serveur MCP de Profound.

Commence par appeler list_my_organizations.
Appelle ensuite list_organizations.
Utilise l’identifiant d’organisation renvoyé par list_organizations pour appeler list_websites.

Affiche les noms des organisations, les noms des sites web et les identifiants des sites web dans un tableau.

Toutes les opérations du CMS nécessitent un website_id.

Outils disponibles

Le serveur MCP fournit actuellement 35 outils CMS.

Organisations et sites web

• list_my_organizations
• list_organizations
• list_websites

Pages

• create_page
• update_page
• delete_page
• get_page
• list_pages

Liaisons de routes

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Les liaisons de routes relient les pages modèles à un contenu ou à des valeurs de paramètres spécifiques.

Composants

• create_component
• update_component
• delete_component
• list_components

Les composants définissent des types de contenu réutilisables et leurs champs.

Blocs

• create_block
• update_block
• delete_block
• get_block
• list_blocks
• publish_block

Les blocs sont des instances de contenu placées sur les pages.

Champs dynamiques et expressions de Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Ces outils gèrent les expressions fx dynamiques qui calculent les valeurs des champs au moment du rendu.

Documents et variantes

• create_document
• update_document
• delete_document
• get_document
• list_documents

Les documents sont des entrées de contenu réutilisables, également appelées variantes. list_documents renvoie les métadonnées ; utilisez get_document pour récupérer le contenu complet.

Traductions

• list_document_translations
• upsert_document_translation
• delete_document_translation

Les traductions doivent être stockées sous forme de lignes correspondant aux locales dans un même document, plutôt que de créer un document distinct pour chaque langue.

Flux de travail CMS habituel

Un flux de travail de contenu complet se déroule généralement comme suit :

1. Découvrez les organisations et les sites web.
2. Examinez les composants, pages, blocs et documents existants.
3. Créez ou mettez à jour le contenu requis.
4. Utilisez expected_version lors de la mise à jour des blocs, composants ou documents.
5. Publiez les blocs ou les documents.
6. Définissez l’état de la page sur Live.
7. Vérifiez le contenu publié.

Une page n’est visible publiquement que lorsqu’elle est en ligne et que son contenu a été publié.

Exemples de requêtes

Créer une page :

Avec Profound CMS, crée une page à l’adresse /pricing pour le site web <website_id>.
Crée les blocs requis, publie-les et définis la page sur Live.

Mettre à jour du contenu existant :

Trouve la page d’accueil du site web <website_id>.
Lis ses blocs actuels, mets à jour le titre principal de la section hero et publie la modification.

Créer du contenu localisé :

Pour le document <document_id>, ajoute les traductions française et allemande.
Utilise le document existant et crée des lignes de traduction au lieu de créer des documents en double.

Utiliser du contenu dynamique :

Pour le bloc hero de la page modèle, fais en sorte que le titre récupère ses données depuis le document lié à la route.
Utilise une expression de champ de bloc au lieu de placer la formule dans draft_content.

Flux de travail de contenu de bout en bout

Le MCP de Profound CMS peut être combiné à d’autres serveurs MCP afin de prendre en charge un flux de travail complet :

Par exemple :

Figma MCP + Profound CMS MCP

peut relier la découverte du design, la création de contenu, la rédaction dans le CMS, la localisation et la publication au sein d’un flux de travail unique assisté par l’IA.