Connect Profound CMS to your AI client

Profound CMS udostępnia zdalny serwer MCP, który pozwala kompatybilnym klientom AI wyszukiwać, tworzyć, aktualizować, publikować i zarządzać treścią CMS.

Punkt końcowy MCP:

http://107.21.107.99:8081/mcp

W środowisku produkcyjnym używaj wersji HTTPS skonfigurowanego adresu URL MCP, gdy tylko jest dostępna.

Uwierzytelnianie

Profound CMS MCP korzysta z WorkOS OAuth.

Aby się połączyć:

1. Utwórz konto Profound CMS.
2. Potwierdź, że Twoje konto należy do właściwej organizacji.
3. Dodaj serwer MCP do swojego klienta AI.
4. Po wyświetleniu monitu dokończ logowanie w przeglądarce.

Nie musisz kopiować klucza API do klienta AI. Po zalogowaniu klient otrzymuje krótkoterminowy token dostępu i automatycznie go odświeża.

Rola CMS kontroluje dostęp:

• Członkowie mogą odczytywać treści CMS.
• Redaktorzy i administratorzy mogą tworzyć, aktualizować i publikować treści.

Claude Code

Uruchom:

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

Następnie uruchom Claude Code i dokończ proces uwierzytelniania w przeglądarce.

Sprawdź połączenie:

claude mcp list

Codex CLI

Uruchom:

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

Codex poprosi o uwierzytelnienie przy pierwszym użyciu serwera.

Możesz zweryfikować połączenie za pomocą:

codex mcp list

OpenCode

Dodaj poniższą konfigurację do:

~/.config/opencode/opencode.json

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

Następnie uwierzytelnij się:

opencode mcp auth profound

Sprawdź połączenie:

opencode mcp list

Serwer powinien być oznaczony jako połączony za pośrednictwem OAuth.

Cursor, Windsurf i inne klienty MCP

Większość klientów kompatybilnych z MCP obsługuje standardową konfigurację zdalnego serwera HTTP:

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

W Cursorze, Windsurfie, Claude Desktop lub innym kliencie MCP:

1. Otwórz ustawienia MCP lub integracji.
2. Dodaj zdalny serwer HTTP MCP.
3. Użyj adresu URL Profound MCP.
4. Włącz uwierzytelnianie OAuth, jeśli klient udostępnia taką opcję.
5. Dokończ logowanie do Profound CMS w przeglądarce.

Klient musi obsługiwać MCP za pośrednictwem Streamable HTTP oraz OAuth. Klienci obsługujący wyłącznie serwery lokalne lub statyczne klucze API nie mogą uwierzytelnić się bezpośrednio w tym serwerze.

Rozpoczynaj każdą sesję od wyszukiwania

Po nawiązaniu połączenia poproś klienta AI o wyszukanie dostępnych dla Ciebie organizacji i witryn:

Używaj wyłącznie serwera Profound MCP.

Najpierw wywołaj list_my_organizations.
Następnie wywołaj list_organizations.
Użyj identyfikatora organizacji zwróconego przez list_organizations, aby wywołać list_websites.

Wyświetl nazwy organizacji, nazwy witryn i identyfikatory witryn w tabeli.

Wszystkie operacje CMS wymagają parametru website_id.

Dostępne narzędzia

Serwer MCP udostępnia obecnie 35 narzędzi CMS.

Organizacje i witryny

• list_my_organizations
• list_organizations
• list_websites

Strony

• create_page
• update_page
• delete_page
• get_page
• list_pages

Powiązania tras

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Powiązania tras łączą strony szablonów z określoną treścią lub wartościami parametrów.

Komponenty

• create_component
• update_component
• delete_component
• list_components

Komponenty definiują wielokrotnego użytku typy treści i ich pola.

Bloki

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

Bloki to instancje treści umieszczane na stronach.

Pola dynamiczne i wyrażenia Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Narzędzia te zarządzają dynamicznymi wyrażeniami fx, które obliczają wartości pól w czasie renderowania.

Dokumenty i warianty

• create_document
• update_document
• delete_document
• get_document
• list_documents

Dokumenty to wielokrotnego użytku wpisy treści, nazywane również wariantami. list_documents zwraca metadane; użyj get_document, aby pobrać pełną treść.

Tłumaczenia

• list_document_translations
• upsert_document_translation
• delete_document_translation

Tłumaczenia należy przechowywać jako wiersze lokalizacji w jednym dokumencie, zamiast tworzyć osobny dokument dla każdego języka.

Typowy przepływ pracy CMS

Kompletny przepływ pracy z treścią zwykle wygląda następująco:

1. Wyszukaj organizacje i witryny.
2. Sprawdź istniejące komponenty, strony, bloki i dokumenty.
3. Utwórz lub zaktualizuj wymaganą treść.
4. Podczas aktualizowania bloków, komponentów lub dokumentów użyj expected_version.
5. Opublikuj bloki lub dokumenty.
6. Ustaw stan strony na Live.
7. Zweryfikuj opublikowaną treść.

Strona jest publicznie widoczna tylko wtedy, gdy jest aktywna, a jej treść została opublikowana.

Przykładowe polecenia

Utwórz stronę:

Używając Profound CMS, utwórz stronę pod adresem /pricing dla witryny <website_id>.
Utwórz wymagane bloki, opublikuj je i ustaw stronę na Live.

Zaktualizuj istniejącą treść:

Znajdź stronę główną witryny <website_id>.
Odczytaj jej bieżące bloki, zaktualizuj nagłówek sekcji hero i opublikuj zmianę.

Utwórz zlokalizowaną treść:

Dla dokumentu <document_id> dodaj tłumaczenia na język francuski i niemiecki.
Użyj istniejącego dokumentu i utwórz wiersze tłumaczeń zamiast tworzyć zduplikowane dokumenty.

Użyj treści dynamicznej:

W przypadku bloku hero na stronie szablonu spraw, aby nagłówek pobierał dane z dokumentu powiązanego z trasą.
Użyj wyrażenia pola bloku zamiast umieszczać formułę w draft_content.

Kompletny przepływ pracy z treścią

Profound CMS MCP można połączyć z innymi serwerami MCP, aby obsługiwać kompletny przepływ pracy:

Na przykład:

Figma MCP + Profound CMS MCP

może połączyć wyszukiwanie projektów, tworzenie treści, przygotowywanie treści w CMS, lokalizację i publikowanie w jeden przepływ pracy wspomagany przez AI.