Connect Profound CMS to your AI client

Profound CMS pruža udaljeni MCP poslužitelj koji kompatibilnim AI klijentima omogućuje otkrivanje, stvaranje, ažuriranje, objavljivanje i upravljanje sadržajem CMS-a.

MCP krajnja točka:

http://107.21.107.99:8081/mcp

Za produkciju upotrebljavajte HTTPS verziju konfiguriranog MCP URL-a kad god je dostupna.

Autentikacija

Profound CMS MCP koristi WorkOS OAuth.

Za povezivanje:

1. Izradite račun za Profound CMS.
2. Potvrdite da vaš račun pripada ispravnoj organizaciji.
3. Dodajte MCP poslužitelj svom AI klijentu.
4. Dovršite prijavu u pregledniku kada se to zatraži.

API ključ ne morate kopirati u svoj AI klijent. Nakon prijave klijent prima kratkotrajni pristupni token i automatski ga osvježava.

Vaša CMS uloga određuje razinu pristupa:

• Članovi mogu čitati CMS sadržaj.
• Urednici i administratori mogu stvarati, ažurirati i objavljivati sadržaj.

Claude Code

Pokrenite:

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

Zatim pokrenite Claude Code i dovršite postupak autentikacije u pregledniku.

Provjerite vezu:

claude mcp list

Codex CLI

Pokrenite:

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

Codex će zatražiti autentikaciju pri prvoj upotrebi poslužitelja.

Vezu možete provjeriti pomoću:

codex mcp list

OpenCode

Dodajte sljedeće u:

~/.config/opencode/opencode.json

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

Zatim se autentificirajte:

opencode mcp auth profound

Provjerite vezu:

opencode mcp list

Poslužitelj bi se trebao prikazati kao povezan putem OAuth-a.

Cursor, Windsurf i drugi MCP klijenti

Većina klijenata kompatibilnih s MCP-om podržava standardnu konfiguraciju udaljenog HTTP-a:

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

U aplikaciji Cursor, Windsurf, Claude Desktop ili drugom MCP klijentu:

1. Otvorite postavke MCP-a ili integracija.
2. Dodajte udaljeni HTTP MCP poslužitelj.
3. Upotrijebite Profound MCP URL.
4. Omogućite OAuth autentikaciju ako klijent nudi OAuth opciju.
5. Dovršite prijavu u Profound CMS u pregledniku.

Klijent mora podržavati Streamable HTTP MCP i OAuth. Klijenti koji podržavaju samo lokalne poslužitelje ili statične API ključeve ne mogu se izravno autentificirati s ovim poslužiteljem.

Započnite svaku sesiju otkrivanjem

Nakon povezivanja zatražite od svog AI klijenta da otkrije organizacije i web-stranice koje su vam dostupne:

Koristi samo Profound MCP poslužitelj.

Najprije pozovi list_my_organizations.
Zatim pozovi list_organizations.
Upotrijebi ID organizacije koji je vratio list_organizations za poziv list_websites.

Prikaži nazive organizacija, nazive web-stranica i ID-ove web-stranica u tablici.

Sve CMS operacije zahtijevaju website_id.

Dostupni alati

MCP poslužitelj trenutačno pruža 35 CMS alata.

Organizacije i web-stranice

• list_my_organizations
• list_organizations
• list_websites

Stranice

• create_page
• update_page
• delete_page
• get_page
• list_pages

Povezivanja ruta

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Povezivanja ruta povezuju predloške stranica s određenim sadržajem ili vrijednostima parametara.

Komponente

• create_component
• update_component
• delete_component
• list_components

Komponente definiraju vrste sadržaja za višekratnu upotrebu i njihova polja.

Blokovi

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

Blokovi su instance sadržaja postavljene na stranice.

Dinamička polja i izrazi alata Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Ovi alati upravljaju dinamičkim izrazima fx koji izračunavaju vrijednosti polja tijekom prikazivanja.

Dokumenti i varijante

• create_document
• update_document
• delete_document
• get_document
• list_documents

Dokumenti su ponovno upotrebljivi unosi sadržaja, koji se nazivaju i varijantama. list_documents vraća metapodatke; upotrijebite get_document za dohvaćanje potpunog sadržaja.

Prijevodi

• list_document_translations
• upsert_document_translation
• delete_document_translation

Prijevode treba pohraniti kao retke lokalizacije u jednom dokumentu, umjesto izrade zasebnog dokumenta za svaki jezik.

Uobičajeni tijek rada CMS-a

Potpuni tijek rada sa sadržajem obično izgleda ovako:

1. Otkrijte organizacije i web-stranice.
2. Pregledajte postojeće komponente, stranice, blokove i dokumente.
3. Izradite ili ažurirajte potreban sadržaj.
4. Pri ažuriranju blokova, komponenti ili dokumenata upotrijebite expected_version.
5. Objavite blokove ili dokumente.
6. Postavite stanje stranice na Live.
7. Provjerite objavljeni sadržaj.

Stranica je javno vidljiva samo kada je aktivna i kada je njezin sadržaj objavljen.

Primjeri upita

Izradite stranicu:

Pomoću Profound CMS-a izradite stranicu na adresi /pricing za web-stranicu <website_id>.
Izradite potrebne blokove, objavite ih i postavite stranicu na Live.

Ažurirajte postojeći sadržaj:

Pronađite početnu stranicu za web-stranicu <website_id>.
Pročitajte njezine trenutačne blokove, ažurirajte glavni naslov i objavite promjenu.

Izradite lokalizirani sadržaj:

Za dokument <document_id> dodajte francuski i njemački prijevod.
Upotrijebite postojeći dokument i izradite retke prijevoda umjesto izrade dupliciranih dokumenata.

Upotrijebite dinamički sadržaj:

Za hero blok na stranici predloška postavite da se glavni naslov dohvaća iz dokumenta povezanog s rutom.
Upotrijebite izraz polja bloka umjesto upisivanja formule u draft_content.

Tijek rada sa sadržajem od početka do kraja

Profound CMS MCP može se kombinirati s drugim MCP poslužiteljima kako bi podržao potpuni tijek rada:

Na primjer:

Figma MCP + Profound CMS MCP

može povezati otkrivanje dizajna, izradu sadržaja, uređivanje u CMS-u, lokalizaciju i objavljivanje u jedinstveni tijek rada uz pomoć AI-ja.