Connect Profound CMS to your AI client

Profound CMS oferă un server MCP la distanță care permite clienților AI compatibili să descopere, să creeze, să actualizeze, să publice și să gestioneze conținut CMS.

Endpoint MCP:

http://107.21.107.99:8081/mcp

Pentru producție, folosiți versiunea HTTPS a URL-ului MCP configurat ori de câte ori este disponibilă.

Autentificare

Profound CMS MCP utilizează OAuth de la WorkOS.

Pentru conectare:

1. Creați un cont Profound CMS.
2. Confirmați că contul dvs. aparține organizației corecte.
3. Adăugați serverul MCP în clientul dvs. AI.
4. Finalizați autentificarea în browser când vi se solicită.

Nu trebuie să copiați o cheie API în clientul dvs. AI. După autentificare, clientul primește un token de acces cu durată scurtă și îl reîmprospătează automat.

Rolul dvs. CMS controlează accesul:

• Membrii pot citi conținut CMS.
• Editorii și administratorii pot crea, actualiza și publica conținut.

Claude Code

Rulați:

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

Apoi porniți Claude Code și finalizați fluxul de autentificare în browser.

Verificați conexiunea:

claude mcp list

Codex CLI

Rulați:

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

Codex va solicita autentificarea la prima utilizare a serverului.

Puteți verifica conexiunea cu:

codex mcp list

OpenCode

Adăugați următoarele în:

~/.config/opencode/opencode.json

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

Apoi autentificați-vă:

opencode mcp auth profound

Verificați conexiunea:

opencode mcp list

Serverul ar trebui să apară ca fiind conectat prin OAuth.

Cursor, Windsurf și alți clienți MCP

Majoritatea clienților compatibili cu MCP acceptă configurația HTTP standard pentru servere la distanță:

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

În Cursor, Windsurf, Claude Desktop sau un alt client MCP:

1. Deschideți setările MCP sau ale integrărilor.
2. Adăugați un server MCP HTTP la distanță.
3. Utilizați URL-ul MCP Profound.
4. Activați autentificarea OAuth dacă clientul oferă o opțiune OAuth.
5. Finalizați autentificarea Profound CMS în browser.

Clientul trebuie să accepte MCP prin Streamable HTTP și OAuth. Clienții care acceptă doar servere locale sau chei API statice nu se pot autentifica direct cu acest server.

Începeți fiecare sesiune cu descoperirea

După conectare, solicitați clientului dvs. AI să descopere organizațiile și site-urile disponibile pentru dvs.:

Use the Profound MCP server only.

First call list_my_organizations.
Then call list_organizations.
Use the organization ID returned by list_organizations to call list_websites.

Show the organization names, website names, and website IDs in a table.

Toate operațiunile CMS necesită un website_id.

Instrumente disponibile

Serverul MCP oferă în prezent 35 de instrumente CMS.

Organizații și site-uri

• list_my_organizations
• list_organizations
• list_websites

Pagini

• create_page
• update_page
• delete_page
• get_page
• list_pages

Asocieri de rute

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Asocierile de rute conectează paginile șablon la anumite valori de conținut sau de parametri.

Componente

• create_component
• update_component
• delete_component
• list_components

Componentele definesc tipuri de conținut reutilizabile și câmpurile acestora.

Blocuri

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

Blocurile sunt instanțe de conținut plasate pe pagini.

Câmpuri dinamice și expresii Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Aceste instrumente gestionează expresii dinamice fx care calculează valorile câmpurilor în momentul randării.

Documente și variante

• create_document
• update_document
• delete_document
• get_document
• list_documents

Documentele sunt intrări de conținut reutilizabile, numite și variante. list_documents returnează metadate; utilizați get_document pentru a prelua conținutul complet.

Traduceri

• list_document_translations
• upsert_document_translation
• delete_document_translation

Traducerile ar trebui stocate ca rânduri pentru fiecare localizare într-un singur document, în loc să creați un document separat pentru fiecare limbă.

Flux CMS obișnuit

Un flux complet de conținut arată de obicei astfel:

1. Descoperiți organizațiile și site-urile.
2. Inspectați componentele, paginile, blocurile și documentele existente.
3. Creați sau actualizați conținutul necesar.
4. Utilizați expected_version la actualizarea blocurilor, componentelor sau documentelor.
5. Publicați blocurile sau documentele.
6. Setați starea paginii la Live.
7. Verificați conținutul publicat.

O pagină este vizibilă public numai atunci când este activă și conținutul acesteia a fost publicat.

Exemple de solicitări

Creați o pagină:

Using Profound CMS, create a page at /pricing for website <website_id>.
Create the required blocks, publish them, and set the page to Live.

Actualizați conținutul existent:

Find the homepage for website <website_id>.
Read its current blocks, update the hero headline, and publish the change.

Creați conținut localizat:

For document <document_id>, add French and German translations.
Use the existing document and create translation rows instead of creating duplicate documents.

Utilizați conținut dinamic:

For the hero block on the template page, make the headline pull from the route-bound document.
Use a block field expression rather than putting the formula in draft_content.

Flux complet de conținut

Profound CMS MCP poate fi combinat cu alte servere MCP pentru a susține un flux complet:

De exemplu:

Figma MCP + Profound CMS MCP

poate conecta descoperirea designului, crearea de conținut, redactarea în CMS, localizarea și publicarea într-un singur flux asistat de AI.