Connect Profound CMS to your AI client

A Profound CMS távoli MCP-szervert biztosít, amely lehetővé teszi a kompatibilis AI-kliensek számára a CMS-tartalmak felderítését, létrehozását, frissítését, közzétételét és kezelését.

MCP-végpont:

http://107.21.107.99:8081/mcp

Éles környezetben mindig a konfigurált MCP-URL HTTPS-verzióját használd, amikor az elérhető.

Hitelesítés

A Profound CMS MCP WorkOS OAuthot használ.

A csatlakozáshoz:

1. Hozz létre egy Profound CMS-fiókot.
2. Ellenőrizd, hogy a fiókod a megfelelő szervezethez tartozik.
3. Add hozzá az MCP-szervert az AI-kliencedhez.
4. Amikor a rendszer kéri, végezd el a böngészőalapú bejelentkezést.

Nem kell API-kulcsot bemásolnod az AI-klien sedbe. A bejelentkezés után a kliens rövid élettartamú hozzáférési tokent kap, és automatikusan frissíti azt.

A CMS-ben betöltött szerepköröd szabályozza a hozzáférést:

• A tagok olvashatják a CMS-tartalmakat.
• A szerkesztők és a rendszergazdák létrehozhatnak, frissíthetnek és közzétehetnek tartalmakat.

Claude Code

Futtasd:

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

Ezután indítsd el a Claude Code-ot, és végezd el a böngészőben a hitelesítési folyamatot.

A kapcsolat ellenőrzése:

claude mcp list

Codex CLI

Futtasd:

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

A Codex az első használatkor hitelesítést fog kérni.

A kapcsolatot a következő paranccsal ellenőrizheted:

codex mcp list

OpenCode

Add hozzá a következőket ehhez a fájlhoz:

~/.config/opencode/opencode.json

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

Ezután hitelesíts:

opencode mcp auth profound

A kapcsolat ellenőrzése:

opencode mcp list

A szervernek OAuth-kapcsolaton keresztül csatlakoztatottként kell megjelennie.

Cursor, Windsurf és egyéb MCP-kliensek

A legtöbb MCP-kompatibilis kliens támogatja a szabványos távoli HTTP-konfigurációt:

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

A Cursorban, Windsurfben, Claude Desktopban vagy más MCP-kliensben:

1. Nyisd meg az MCP- vagy integrációs beállításokat.
2. Adj hozzá egy távoli HTTP MCP-szervert.
3. Használd a Profound MCP-URL-jét.
4. Engedélyezd az OAuth-hitelesítést, ha a kliens OAuth-beállítást kínál.
5. Végezd el a Profound CMS böngészőben történő bejelentkezését.

A kliensnek támogatnia kell a Streamable HTTP MCP-t és az OAuthot. Azok a kliensek, amelyek csak helyi szervereket vagy statikus API-kulcsokat támogatnak, nem tudnak közvetlenül hitelesíteni ezen a szerveren.

Minden munkamenetet kezdeti felderítéssel indíts

A csatlakozás után kérd meg az AI-klienst, hogy derítse fel a számodra elérhető szervezeteket és webhelyeket:

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.

Minden CMS-művelethez szükség van egy website_id értékre.

Elérhető eszközök

Az MCP-szerver jelenleg 35 CMS-eszközt biztosít.

Szervezetek és webhelyek

• list_my_organizations
• list_organizations
• list_websites

Oldalak

• create_page
• update_page
• delete_page
• get_page
• list_pages

Útvonal-hozzárendelések

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Az útvonal-hozzárendelések sablonoldalakat kapcsolnak meghatározott tartalmakhoz vagy paraméterértékekhez.

Komponensek

• create_component
• update_component
• delete_component
• list_components

A komponensek újrafelhasználható tartalomtípusokat és azok mezőit határozzák meg.

Blokkok

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

A blokkok az oldalakon elhelyezett tartalompéldányok.

Dinamikus mezők és a Template Builder kifejezései

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Ezek az eszközök a dinamikus fx-kifejezéseket kezelik, amelyek rendereléskor kiszámítják a mezők értékeit.

Dokumentumok és változatok

• create_document
• update_document
• delete_document
• get_document
• list_documents

A dokumentumok újrafelhasználható tartalombejegyzések, amelyeket változatoknak is nevezünk. A list_documents metaadatokat ad vissza; a teljes tartalom lekéréséhez használd a get_document eszközt.

Fordítások

• list_document_translations
• upsert_document_translation
• delete_document_translation

A fordításokat egyetlen dokumentumban, területi beállítás szerinti sorokként kell tárolni, ahelyett, hogy minden nyelvhez külön dokumentumot hoznál létre.

Tipikus CMS-munkafolyamat

Egy teljes tartalom-munkafolyamat általában a következőképpen néz ki:

1. Derítsd fel a szervezeteket és a webhelyeket.
2. Vizsgáld meg a meglévő komponenseket, oldalakat, blokkokat és dokumentumokat.
3. Hozd létre vagy frissítsd a szükséges tartalmat.
4. Blokkok, komponensek vagy dokumentumok frissítésekor használd az expected_version értéket.
5. Tedd közzé a blokkokat vagy dokumentumokat.
6. Állítsd az oldal állapotát Live értékre.
7. Ellenőrizd a közzétett tartalmat.

Egy oldal csak akkor látható nyilvánosan, ha éles állapotban van, és a tartalma közzé lett téve.

Példapromptok

Oldal létrehozása:

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

Meglévő tartalom frissítése:

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

Lokalizált tartalom létrehozása:

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

Dinamikus tartalom használata:

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.

Végponttól végpontig terjedő tartalom-munkafolyamat

A Profound CMS MCP más MCP-szerverekkel együtt használható egy teljes munkafolyamat támogatására:

Például:

Figma MCP + Profound CMS MCP

összekapcsolhatja a dizájn felderítését, a tartalom létrehozását, a CMS-ben történő szerkesztést, a lokalizációt és a közzétételt egyetlen, AI által támogatott munkafolyamatban.