Connect Profound CMS to your AI client

Profound CMS poskytuje vzdialený server MCP, ktorý umožňuje kompatibilným AI klientom vyhľadávať, vytvárať, aktualizovať, publikovať a spravovať obsah CMS.

Koncový bod MCP:

http://107.21.107.99:8081/mcp

V produkcii používajte HTTPS verziu nakonfigurovanej adresy URL MCP vždy, keď je k dispozícii.

Autentifikácia

Profound CMS MCP používa OAuth od WorkOS.

Pripojenie:

1. Vytvorte si účet Profound CMS.
2. Skontrolujte, či váš účet patrí do správnej organizácie.
3. Pridajte server MCP do svojho AI klienta.
4. Po zobrazení výzvy dokončite prihlasovanie v prehliadači.

Do svojho AI klienta nemusíte kopírovať kľúč API. Po prihlásení klient získa krátkodobý prístupový token a automaticky ho obnovuje.

Prístup riadi vaša rola v CMS:

• Členovia môžu čítať obsah CMS.
• Editori a administrátori môžu vytvárať, aktualizovať a publikovať obsah.

Claude Code

Spustite:

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

Potom spustite Claude Code a dokončite autentifikačný proces v prehliadači.

Overenie pripojenia:

claude mcp list

Codex CLI

Spustite:

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

Codex si vyžiada autentifikáciu pri prvom použití servera.

Pripojenie môžete overiť pomocou:

codex mcp list

OpenCode

Pridajte nasledujúci obsah do súboru:

~/.config/opencode/opencode.json

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

Potom sa autentifikujte:

opencode mcp auth profound

Overenie pripojenia:

opencode mcp list

Server by sa mal zobraziť ako pripojený prostredníctvom OAuth.

Cursor, Windsurf a ďalší klienti MCP

Väčšina klientov kompatibilných s MCP podporuje štandardnú konfiguráciu vzdialeného HTTP:

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

V aplikácii Cursor, Windsurf, Claude Desktop alebo inom klientovi MCP:

1. Otvorte nastavenia MCP alebo integrácií.
2. Pridajte vzdialený HTTP server MCP.
3. Použite adresu URL MCP pre Profound.
4. Ak klient ponúka možnosť OAuth, povoľte autentifikáciu OAuth.
5. Dokončite prihlasovanie do Profound CMS v prehliadači.

Klient musí podporovať Streamable HTTP MCP a OAuth. Klienti, ktorí podporujú iba lokálne servery alebo statické kľúče API, sa nemôžu autentifikovať priamo voči tomuto serveru.

Každú reláciu začnite vyhľadávaním

Po pripojení požiadajte svojho AI klienta, aby vyhľadal organizácie a webové stránky, ku ktorým máte prístup:

Používaj iba server Profound MCP.

Najprv zavolaj list_my_organizations.
Potom zavolaj list_organizations.
Použi ID organizácie vrátené funkciou list_organizations na zavolanie list_websites.

Zobraz názvy organizácií, názvy webových stránok a ID webových stránok v tabuľke.

Všetky operácie CMS vyžadujú website_id.

Dostupné nástroje

Server MCP v súčasnosti poskytuje 35 nástrojov CMS.

Organizácie a webové stránky

• list_my_organizations
• list_organizations
• list_websites

Stránky

• create_page
• update_page
• delete_page
• get_page
• list_pages

Väzby trás

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Väzby trás spájajú šablónové stránky s konkrétnym obsahom alebo hodnotami parametrov.

Komponenty

• create_component
• update_component
• delete_component
• list_components

Komponenty definujú opakovane použiteľné typy obsahu a ich polia.

Bloky

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

Bloky sú inštancie obsahu umiestnené na stránkach.

Dynamické polia a výrazy nástroja Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Tieto nástroje spravujú dynamické výrazy fx, ktoré vypočítavajú hodnoty polí v čase vykresľovania.

Dokumenty a varianty

• create_document
• update_document
• delete_document
• get_document
• list_documents

Dokumenty sú opakovane použiteľné položky obsahu, ktoré sa tiež nazývajú varianty. list_documents vracia metadáta; na získanie úplného obsahu použite get_document.

Preklady

• list_document_translations
• upsert_document_translation
• delete_document_translation

Preklady by mali byť uložené ako riadky lokalizácie v jednom dokumente namiesto vytvárania samostatného dokumentu pre každý jazyk.

Typický pracovný postup v CMS

Kompletný pracovný postup s obsahom zvyčajne vyzerá takto:

1. Vyhľadajte organizácie a webové stránky.
2. Preskúmajte existujúce komponenty, stránky, bloky a dokumenty.
3. Vytvorte alebo aktualizujte požadovaný obsah.
4. Pri aktualizácii blokov, komponentov alebo dokumentov použite expected_version.
5. Publikujte bloky alebo dokumenty.
6. Nastavte stav stránky na Live.
7. Overte publikovaný obsah.

Stránka je verejne viditeľná iba vtedy, keď je aktívna a jej obsah bol publikovaný.

Príklady výziev

Vytvorenie stránky:

Pomocou Profound CMS vytvor stránku na adrese /pricing pre webovú stránku <website_id>.
Vytvor požadované bloky, publikuj ich a nastav stránku na Live.

Aktualizácia existujúceho obsahu:

Nájdi domovskú stránku webovej stránky <website_id>.
Prečítaj jej aktuálne bloky, aktualizuj hlavný nadpis a publikuj zmenu.

Vytvorenie lokalizovaného obsahu:

Pre dokument <document_id> pridaj francúzske a nemecké preklady.
Použi existujúci dokument a vytvor riadky prekladov namiesto vytvárania duplicitných dokumentov.

Použitie dynamického obsahu:

Pre hlavný blok na šablónovej stránke nastav, aby sa hlavný nadpis načítaval z dokumentu viazaného na trasu.
Použi výraz poľa bloku namiesto vloženia vzorca do draft_content.

Komplexný pracovný postup s obsahom

Profound CMS MCP možno kombinovať s ďalšími servermi MCP na podporu kompletného pracovného postupu:

Napríklad:

Figma MCP + Profound CMS MCP

môže prepojiť vyhľadávanie dizajnu, tvorbu obsahu, tvorbu obsahu v CMS, lokalizáciu a publikovanie do jediného pracovného postupu s podporou AI.