Connect Profound CMS to your AI client

Profound CMS надає віддалений MCP-сервер, який дає змогу сумісним AI-клієнтам знаходити, створювати, оновлювати, публікувати та керувати вмістом CMS.

Кінцева точка MCP:

http://107.21.107.99:8081/mcp

Для робочого середовища використовуйте HTTPS-версію налаштованої URL-адреси MCP, якщо вона доступна.

Автентифікація

Profound CMS MCP використовує OAuth WorkOS.

Щоб підключитися:

1. Створіть обліковий запис Profound CMS.
2. Переконайтеся, що ваш обліковий запис належить до правильної організації.
3. Додайте MCP-сервер до свого AI-клієнта.
4. Завершіть вхід у браузері, коли з’явиться відповідний запит.

Вам не потрібно копіювати ключ API у свій AI-клієнт. Після входу клієнт отримує короткоживучий токен доступу та автоматично оновлює його.

Ваша роль у CMS визначає рівень доступу:

• Учасники можуть читати вміст CMS.
• Редактори й адміністратори можуть створювати, оновлювати та публікувати вміст.

Claude Code

Виконайте:

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

Потім запустіть Claude Code і завершіть автентифікацію через браузер.

Перевірте підключення:

claude mcp list

Codex CLI

Виконайте:

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

Codex запросить автентифікацію під час першого використання сервера.

Перевірити підключення можна за допомогою:

codex mcp list

OpenCode

Додайте наведене нижче до:

~/.config/opencode/opencode.json

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

Потім пройдіть автентифікацію:

opencode mcp auth profound

Перевірте підключення:

opencode mcp list

Сервер має відображатися як підключений через OAuth.

Cursor, Windsurf та інші MCP-клієнти

Більшість MCP-сумісних клієнтів підтримують стандартну конфігурацію віддаленого HTTP-підключення:

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

У Cursor, Windsurf, Claude Desktop або іншому MCP-клієнті:

1. Відкрийте налаштування MCP або інтеграцій.
2. Додайте віддалений HTTP MCP-сервер.
3. Використайте URL-адресу Profound MCP.
4. Увімкніть автентифікацію OAuth, якщо клієнт надає відповідну опцію.
5. Завершіть вхід до Profound CMS у браузері.

Клієнт має підтримувати Streamable HTTP MCP та OAuth. Клієнти, які підтримують лише локальні сервери або статичні ключі API, не можуть напряму автентифікуватися на цьому сервері.

Починайте кожен сеанс із пошуку доступних ресурсів

Після підключення попросіть свій AI-клієнт знайти доступні вам організації та вебсайти:

Використовуй лише сервер Profound MCP.

Спочатку виклич list_my_organizations.
Потім виклич list_organizations.
Використай ідентифікатор організації, повернутий list_organizations, щоб викликати list_websites.

Покажи назви організацій, назви вебсайтів та ідентифікатори вебсайтів у таблиці.

Для всіх операцій CMS потрібен website_id.

Доступні інструменти

Наразі MCP-сервер надає 35 інструментів CMS.

Організації та вебсайти

• list_my_organizations
• list_organizations
• list_websites

Сторінки

• create_page
• update_page
• delete_page
• get_page
• list_pages

Прив’язки маршрутів

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Прив’язки маршрутів з’єднують шаблонні сторінки з конкретним вмістом або значеннями параметрів.

Компоненти

• create_component
• update_component
• delete_component
• list_components

Компоненти визначають повторно використовувані типи вмісту та їхні поля.

Блоки

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

Блоки — це екземпляри вмісту, розміщені на сторінках.

Динамічні поля та вирази Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Ці інструменти керують динамічними виразами fx, які обчислюють значення полів під час відтворення.

Документи та варіанти

• create_document
• update_document
• delete_document
• get_document
• list_documents

Документи — це повторно використовувані записи вмісту, які також називають варіантами. list_documents повертає метадані; використовуйте get_document, щоб отримати повний вміст.

Переклади

• list_document_translations
• upsert_document_translation
• delete_document_translation

Переклади слід зберігати як рядки локалей в одному документі, а не створювати окремий документ для кожної мови.

Типовий робочий процес CMS

Повний робочий процес роботи з вмістом зазвичай має такий вигляд:

1. Знайдіть організації та вебсайти.
2. Перевірте наявні компоненти, сторінки, блоки та документи.
3. Створіть або оновіть потрібний вміст.
4. Використовуйте expected_version під час оновлення блоків, компонентів або документів.
5. Опублікуйте блоки або документи.
6. Установіть для сторінки стан Live.
7. Перевірте опублікований вміст.

Сторінка є загальнодоступною лише тоді, коли вона має стан Live, а її вміст опубліковано.

Приклади запитів

Створити сторінку:

За допомогою Profound CMS створи сторінку за адресою /pricing для вебсайту <website_id>.
Створи потрібні блоки, опублікуй їх і встанови для сторінки стан Live.

Оновити наявний вміст:

Знайди головну сторінку вебсайту <website_id>.
Прочитай її поточні блоки, онови заголовок головного банера та опублікуй зміни.

Створити локалізований вміст:

Для документа <document_id> додай переклади французькою та німецькою мовами.
Використай наявний документ і створи рядки перекладів замість створення дублікатів документів.

Використовувати динамічний вміст:

Для головного банера на шаблонній сторінці зроби так, щоб заголовок отримував значення з документа, прив’язаного до маршруту.
Використай вираз поля блока, а не додавай формулу до draft_content.

Повний робочий процес роботи з вмістом

Profound CMS MCP можна поєднувати з іншими MCP-серверами для підтримки повного робочого процесу:

Наприклад:

Figma MCP + Profound CMS MCP

може об’єднати пошук дизайну, створення вмісту, роботу з CMS, локалізацію та публікацію в єдиний робочий процес із підтримкою AI.