Connect Profound CMS to your AI client

Profound CMS stellt einen entfernten MCP-Server bereit, über den kompatible KI-Clients CMS-Inhalte entdecken, erstellen, aktualisieren, veröffentlichen und verwalten können.

MCP-Endpunkt:

http://107.21.107.99:8081/mcp

Verwenden Sie in der Produktion nach Möglichkeit die HTTPS-Version Ihrer konfigurierten MCP-URL.

Authentifizierung

Profound CMS MCP verwendet WorkOS OAuth.

So stellen Sie eine Verbindung her:

1. Erstellen Sie ein Profound-CMS-Konto.
2. Bestätigen Sie, dass Ihr Konto zur richtigen Organisation gehört.
3. Fügen Sie den MCP-Server zu Ihrem KI-Client hinzu.
4. Schließen Sie die browserbasierte Anmeldung ab, wenn Sie dazu aufgefordert werden.

Sie müssen keinen API-Schlüssel in Ihren KI-Client kopieren. Nach der Anmeldung erhält der Client ein kurzlebiges Zugriffstoken und aktualisiert es automatisch.

Ihre CMS-Rolle steuert den Zugriff:

• Mitglieder können CMS-Inhalte lesen.
• Redakteure und Administratoren können Inhalte erstellen, aktualisieren und veröffentlichen.

Claude Code

Führen Sie Folgendes aus:

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

Starten Sie anschließend Claude Code und schließen Sie den browserbasierten Authentifizierungsprozess ab.

Verbindung überprüfen:

claude mcp list

Codex CLI

Führen Sie Folgendes aus:

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

Codex fordert zur Authentifizierung auf, sobald der Server zum ersten Mal verwendet wird.

Sie können die Verbindung mit folgendem Befehl überprüfen:

codex mcp list

OpenCode

Fügen Sie Folgendes hinzu in:

~/.config/opencode/opencode.json

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

Authentifizieren Sie sich anschließend:

opencode mcp auth profound

Verbindung überprüfen:

opencode mcp list

Der Server sollte als über OAuth verbunden angezeigt werden.

Cursor, Windsurf und andere MCP-Clients

Die meisten MCP-kompatiblen Clients unterstützen die standardmäßige Konfiguration für entfernte HTTP-Verbindungen:

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

In Cursor, Windsurf, Claude Desktop oder einem anderen MCP-Client:

1. Öffnen Sie die MCP- oder Integrationseinstellungen.
2. Fügen Sie einen entfernten HTTP-MCP-Server hinzu.
3. Verwenden Sie die Profound-MCP-URL.
4. Aktivieren Sie die OAuth-Authentifizierung, sofern der Client eine OAuth-Option anbietet.
5. Schließen Sie die Anmeldung bei Profound CMS in Ihrem Browser ab.

Der Client muss Streamable HTTP MCP und OAuth unterstützen. Clients, die nur lokale Server oder statische API-Schlüssel unterstützen, können sich nicht direkt bei diesem Server authentifizieren.

Starten Sie jede Sitzung mit der Erkundung

Bitten Sie Ihren KI-Client nach dem Herstellen der Verbindung, die für Sie verfügbaren Organisationen und Websites zu ermitteln:

Verwende ausschließlich den Profound-MCP-Server.

Rufe zuerst list_my_organizations auf.
Rufe anschließend list_organizations auf.
Verwende die von list_organizations zurückgegebene Organisations-ID, um list_websites aufzurufen.

Zeige die Organisationsnamen, Websitenamen und Website-IDs in einer Tabelle an.

Für alle CMS-Operationen ist eine website_id erforderlich.

Verfügbare Tools

Der MCP-Server stellt derzeit 35 CMS-Tools bereit.

Organisationen und Websites

• list_my_organizations
• list_organizations
• list_websites

Seiten

• create_page
• update_page
• delete_page
• get_page
• list_pages

Routenbindungen

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Routenbindungen verknüpfen Vorlagenseiten mit bestimmten Inhalten oder Parameterwerten.

Komponenten

• create_component
• update_component
• delete_component
• list_components

Komponenten definieren wiederverwendbare Inhaltstypen und deren Felder.

Blöcke

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

Blöcke sind Inhaltsinstanzen, die auf Seiten platziert werden.

Dynamische Felder und Ausdrücke des Template Builders

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Diese Tools verwalten dynamische fx-Ausdrücke, die Feldwerte zur Renderzeit berechnen.

Dokumente und Varianten

• create_document
• update_document
• delete_document
• get_document
• list_documents

Dokumente sind wiederverwendbare Inhaltseinträge, die auch als Varianten bezeichnet werden. list_documents gibt Metadaten zurück; verwenden Sie get_document, um den vollständigen Inhalt abzurufen.

Übersetzungen

• list_document_translations
• upsert_document_translation
• delete_document_translation

Übersetzungen sollten als Sprachzeilen in einem einzigen Dokument gespeichert werden, anstatt für jede Sprache ein separates Dokument zu erstellen.

Typischer CMS-Workflow

Ein vollständiger Content-Workflow sieht normalerweise folgendermaßen aus:

1. Ermitteln Sie Organisationen und Websites.
2. Prüfen Sie vorhandene Komponenten, Seiten, Blöcke und Dokumente.
3. Erstellen oder aktualisieren Sie die erforderlichen Inhalte.
4. Verwenden Sie beim Aktualisieren von Blöcken, Komponenten oder Dokumenten expected_version.
5. Veröffentlichen Sie Blöcke oder Dokumente.
6. Setzen Sie den Seitenstatus auf Live.
7. Überprüfen Sie die veröffentlichten Inhalte.

Eine Seite ist nur dann öffentlich sichtbar, wenn sie live ist und ihre Inhalte veröffentlicht wurden.

Beispiel-Prompts

Eine Seite erstellen:

Erstelle mit Profound CMS eine Seite unter /pricing für die Website <website_id>.
Erstelle die erforderlichen Blöcke, veröffentliche sie und setze die Seite auf Live.

Vorhandene Inhalte aktualisieren:

Finde die Startseite für die Website <website_id>.
Lies ihre aktuellen Blöcke, aktualisiere die Überschrift des Hero-Bereichs und veröffentliche die Änderung.

Lokalisierte Inhalte erstellen:

Füge für das Dokument <document_id> französische und deutsche Übersetzungen hinzu.
Verwende das vorhandene Dokument und erstelle Übersetzungszeilen, anstatt doppelte Dokumente anzulegen.

Dynamische Inhalte verwenden:

Sorge dafür, dass die Überschrift des Hero-Blocks auf der Vorlagenseite aus dem routengebundenen Dokument übernommen wird.
Verwende einen Blockfeld-Ausdruck, anstatt die Formel in draft_content einzufügen.

Durchgängiger Content-Workflow

Profound CMS MCP kann mit anderen MCP-Servern kombiniert werden, um einen vollständigen Workflow zu unterstützen:

Zum Beispiel:

Figma MCP + Profound CMS MCP

kann die Erkundung von Designs, die Inhaltserstellung, die CMS-Autorentätigkeit, die Lokalisierung und die Veröffentlichung zu einem einzigen KI-gestützten Workflow verbinden.