Connect Profound CMS to your AI client

Profound CMS poskytuje vzdálený server MCP, který kompatibilním klientům AI umožňuje vyhledávat, vytvářet, aktualizovat, publikovat a spravovat obsah CMS.

Koncový bod MCP:

http://107.21.107.99:8081/mcp

V produkčním prostředí používejte HTTPS verzi nakonfigurované adresy URL MCP, kdykoli je k dispozici.

Ověřování

Profound CMS MCP používá OAuth WorkOS.

Postup připojení:

1. Vytvořte si účet Profound CMS.
2. Ověřte, že váš účet patří do správné organizace.
3. Přidejte server MCP do svého klienta AI.
4. Po zobrazení výzvy dokončete přihlášení v prohlížeči.

Do klienta AI nemusíte kopírovat klíč API. Po přihlášení klient obdrží krátkodobý přístupový token a automaticky jej obnovuje.

Vaše role v CMS řídí přístup:

• Členové mohou číst obsah CMS.
• Editoři a administrátoři mohou vytvářet, aktualizovat a publikovat obsah.

Claude Code

Spusťte:

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

Poté spusťte Claude Code a dokončete ověřování v prohlížeči.

Ověřte připojení:

claude mcp list

Codex CLI

Spusťte:

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

Codex vyžádá ověření při prvním použití serveru.

Připojení můžete ověřit pomocí:

codex mcp list

OpenCode

Přidejte následující obsah do souboru:

~/.config/opencode/opencode.json

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

Poté se ověřte:

opencode mcp auth profound

Ověřte připojení:

opencode mcp list

Server by měl být zobrazen jako připojený prostřednictvím OAuth.

Cursor, Windsurf a další klienti MCP

Většina klientů kompatibilních s MCP podporuje standardní konfiguraci vzdáleného HTTP serveru:

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

V aplikaci Cursor, Windsurf, Claude Desktop nebo jiném klientovi MCP:

1. Otevřete nastavení MCP nebo integrací.
2. Přidejte vzdálený HTTP server MCP.
3. Použijte adresu URL MCP Profound.
4. Pokud klient nabízí možnost OAuth, povolte ověřování OAuth.
5. Dokončete přihlášení do Profound CMS v prohlížeči.

Klient musí podporovat MCP přes Streamable HTTP a OAuth. Klienti, kteří podporují pouze lokální servery nebo statické klíče API, se k tomuto serveru nemohou přímo ověřit.

Každou relaci začněte vyhledáním

Po připojení požádejte klienta AI, aby vyhledal organizace a weby, které máte k dispozici:

Používej pouze server Profound MCP.

Nejprve zavolej list_my_organizations.
Poté zavolej list_organizations.
Použij ID organizace vrácené funkcí list_organizations k zavolání list_websites.

Zobraz názvy organizací, názvy webů a ID webů v tabulce.

Všechny operace CMS vyžadují website_id.

Dostupné nástroje

Server MCP aktuálně poskytuje 35 nástrojů CMS.

Organizace a weby

• list_my_organizations
• list_organizations
• list_websites

Stránky

• create_page
• update_page
• delete_page
• get_page
• list_pages

Vazby tras

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Vazby tras propojují šablonové stránky s konkrétním obsahem nebo hodnotami parametrů.

Komponenty

• create_component
• update_component
• delete_component
• list_components

Komponenty definují opakovaně použitelné typy obsahu a jejich pole.

Bloky

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

Bloky jsou instance obsahu umístěné na stránkách.

Dynamická pole a výrazy nástroje Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Tyto nástroje spravují dynamické výrazy fx, které vypočítávají hodnoty polí při vykreslování.

Dokumenty a varianty

• create_document
• update_document
• delete_document
• get_document
• list_documents

Dokumenty jsou opakovaně použitelné obsahové položky, nazývané také varianty. Funkce list_documents vrací metadata; úplný obsah získáte pomocí get_document.

Překlady

• list_document_translations
• upsert_document_translation
• delete_document_translation

Překlady by měly být uloženy jako řádky lokalizací v jednom dokumentu, nikoli vytvořením samostatného dokumentu pro každý jazyk.

Typický pracovní postup CMS

Kompletní pracovní postup obsahu obvykle vypadá takto:

1. Vyhledejte organizace a weby.
2. Prozkoumejte stávající komponenty, stránky, bloky a dokumenty.
3. Vytvořte nebo aktualizujte požadovaný obsah.
4. Při aktualizaci bloků, komponent nebo dokumentů použijte expected_version.
5. Publikujte bloky nebo dokumenty.
6. Nastavte stav stránky na Live.
7. Ověřte publikovaný obsah.

Stránka je veřejně viditelná pouze tehdy, když je aktivní a její obsah byl publikován.

Příklady požadavků

Vytvoření stránky:

Pomocí Profound CMS vytvoř stránku na adrese /pricing pro web <website_id>.
Vytvoř požadované bloky, publikuj je a nastav stránku na Live.

Aktualizace existujícího obsahu:

Najdi domovskou stránku webu <website_id>.
Přečti její aktuální bloky, aktualizuj hlavní nadpis a publikuj změnu.

Vytvoření lokalizovaného obsahu:

Pro dokument <document_id> přidej francouzský a německý překlad.
Použij existující dokument a vytvoř řádky překladů namísto vytváření duplicitních dokumentů.

Použití dynamického obsahu:

U hero bloku na šablonové stránce nastav, aby se nadpis načítal z dokumentu propojeného s trasou.
Použij výraz pole bloku namísto vložení vzorce do draft_content.

Komplexní pracovní postup obsahu

Profound CMS MCP lze kombinovat s dalšími servery MCP a podporovat tak kompletní pracovní postup:

Například:

Figma MCP + Profound CMS MCP

může propojit vyhledávání návrhů, tvorbu obsahu, tvorbu v CMS, lokalizaci a publikování do jediného pracovního postupu podporovaného AI.