Connect Profound CMS to your AI client

Profound CMS предоставя отдалечен MCP сървър, който позволява на съвместими AI клиенти да откриват, създават, актуализират, публикуват и управляват съдържание в CMS.

MCP крайна точка:

http://107.21.107.99:8081/mcp

За продукционна среда използвайте HTTPS версията на конфигурирания MCP URL, когато е налична.

Удостоверяване

Profound CMS MCP използва WorkOS OAuth.

За да се свържете:

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. Използвайте Profound MCP URL.
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. Проверете публикуваното съдържание.

Страницата е публично видима само когато е активна и съдържанието ѝ е публикувано.

Примерни подкани

Създаване на страница:

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

Актуализиране на съществуващо съдържание:

Намери началната страница за уебсайт <website_id>.
Прочети текущите ѝ блокове, актуализирай заглавието в hero секцията и публикувай промяната.

Създаване на локализирано съдържание:

За документ <document_id> добави преводи на френски и немски език.
Използвай съществуващия документ и създай редове за превод, вместо да създаваш дублирани документи.

Използване на динамично съдържание:

За hero блока на шаблонната страница направи така, че заглавието да се извлича от документа, обвързан с маршрута.
Използвай израз за поле на блок, вместо да поставяш формулата в draft_content.

Цялостен работен процес за съдържание

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

Например:

Figma MCP + Profound CMS MCP

може да свърже откриването на дизайна, създаването на съдържание, създаването на съдържание в CMS, локализацията и публикуването в единен работен процес, подпомаган от AI.