Connect Profound CMS to your AI client

Profound CMS biedt een externe MCP-server waarmee compatibele AI-clients CMS-inhoud kunnen ontdekken, maken, bijwerken, publiceren en beheren.

MCP-eindpunt:

http://107.21.107.99:8081/mcp

Gebruik in productie waar mogelijk de HTTPS-versie van je geconfigureerde MCP-URL.

Authenticatie

Profound CMS MCP gebruikt WorkOS OAuth.

Verbinden:

1. Maak een Profound CMS-account aan.
2. Controleer of je account bij de juiste organisatie hoort.
3. Voeg de MCP-server toe aan je AI-client.
4. Voltooi de browsergebaseerde aanmelding wanneer daarom wordt gevraagd.

Je hoeft geen API-sleutel naar je AI-client te kopiëren. Na het aanmelden ontvangt de client een toegangstoken met een korte geldigheidsduur en vernieuwt dit automatisch.

Je CMS-rol bepaalt de toegang:

• Leden kunnen CMS-inhoud lezen.
• Editors en beheerders kunnen inhoud maken, bijwerken en publiceren.

Claude Code

Voer uit:

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

Start vervolgens Claude Code en voltooi de browserauthenticatie.

Controleer de verbinding:

claude mcp list

Codex CLI

Voer uit:

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

Codex vraagt om authenticatie wanneer de server voor het eerst wordt gebruikt.

Je kunt de verbinding controleren met:

codex mcp list

OpenCode

Voeg het volgende toe aan:

~/.config/opencode/opencode.json

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

Authenticeer vervolgens:

opencode mcp auth profound

Controleer de verbinding:

opencode mcp list

De server moet als verbonden via OAuth worden weergegeven.

Cursor, Windsurf en andere MCP-clients

De meeste MCP-compatibele clients ondersteunen de standaardconfiguratie voor externe HTTP:

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

In Cursor, Windsurf, Claude Desktop of een andere MCP-client:

1. Open de MCP- of integratie-instellingen.
2. Voeg een externe HTTP-MCP-server toe.
3. Gebruik de Profound MCP-URL.
4. Schakel OAuth-authenticatie in als de client een OAuth-optie biedt.
5. Voltooi het aanmelden bij Profound CMS in je browser.

De client moet Streamable HTTP MCP en OAuth ondersteunen. Clients die alleen lokale servers of statische API-sleutels ondersteunen, kunnen zich niet rechtstreeks bij deze server authenticeren.

Begin elke sessie met ontdekking

Vraag je AI-client na het verbinden om de organisaties en websites te ontdekken waartoe je toegang hebt:

Gebruik alleen de Profound MCP-server.

Roep eerst list_my_organizations aan.
Roep daarna list_organizations aan.
Gebruik de organisatie-ID die door list_organizations wordt geretourneerd om list_websites aan te roepen.

Toon de organisatienamen, websitenamen en website-ID's in een tabel.

Voor alle CMS-bewerkingen is een website_id vereist.

Beschikbare tools

De MCP-server biedt momenteel 35 CMS-tools.

Organisaties en websites

• list_my_organizations
• list_organizations
• list_websites

Pagina's

• create_page
• update_page
• delete_page
• get_page
• list_pages

Routekoppelingen

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Routekoppelingen verbinden templatespagina's met specifieke inhoud of parameterwaarden.

Componenten

• create_component
• update_component
• delete_component
• list_components

Componenten definiëren herbruikbare inhoudstypen en hun velden.

Blokken

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

Blokken zijn inhoudsinstanties die op pagina's worden geplaatst.

Dynamische velden en Template Builder-expressies

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Deze tools beheren dynamische fx-expressies die veldwaarden berekenen tijdens het renderen.

Documenten en varianten

• create_document
• update_document
• delete_document
• get_document
• list_documents

Documenten zijn herbruikbare inhoudsitems, ook wel varianten genoemd. list_documents retourneert metagegevens; gebruik get_document om de volledige inhoud op te halen.

Vertalingen

• list_document_translations
• upsert_document_translation
• delete_document_translation

Vertalingen moeten als localerijen in één document worden opgeslagen in plaats van voor elke taal een afzonderlijk document aan te maken.

Typische CMS-workflow

Een volledige inhoudsworkflow ziet er meestal als volgt uit:

1. Ontdek organisaties en websites.
2. Bekijk bestaande componenten, pagina's, blokken en documenten.
3. Maak de vereiste inhoud aan of werk deze bij.
4. Gebruik expected_version bij het bijwerken van blokken, componenten of documenten.
5. Publiceer blokken of documenten.
6. Stel de paginastatus in op Live.
7. Controleer de gepubliceerde inhoud.

Een pagina is alleen openbaar zichtbaar wanneer deze live is en de inhoud ervan is gepubliceerd.

Voorbeeldprompts

Een pagina maken:

Maak met Profound CMS een pagina op /pricing voor website <website_id>.
Maak de vereiste blokken aan, publiceer ze en stel de pagina in op Live.

Bestaande inhoud bijwerken:

Zoek de homepage voor website <website_id>.
Lees de huidige blokken, werk de kop van de hero bij en publiceer de wijziging.

Gelokaliseerde inhoud maken:

Voeg voor document <document_id> Franse en Duitse vertalingen toe.
Gebruik het bestaande document en maak vertaalrijen aan in plaats van dubbele documenten te maken.

Dynamische inhoud gebruiken:

Laat voor het hero-blok op de templatepagina de kop afkomstig zijn uit het routegebonden document.
Gebruik een blokveldexpressie in plaats van de formule in draft_content te plaatsen.

End-to-end-inhoudsworkflow

Profound CMS MCP kan worden gecombineerd met andere MCP-servers om een volledige workflow te ondersteunen:

Bijvoorbeeld:

Figma MCP + Profound CMS MCP

kan ontwerpverkenning, het maken van inhoud, CMS-auteurschap, lokalisatie en publicatie verbinden in één AI-ondersteunde workflow.