Connect Profound CMS to your AI client

Profound CMS предоставляет удалённый MCP-сервер, который позволяет совместимым ИИ-клиентам обнаруживать, создавать, обновлять, публиковать и управлять содержимым CMS.

Конечная точка MCP:

http://107.21.107.99:8081/mcp

В рабочей среде используйте HTTPS-версию настроенного URL MCP, если она доступна.

Аутентификация

Profound CMS MCP использует WorkOS OAuth.

Для подключения:

1. Создайте учётную запись Profound CMS.
2. Убедитесь, что ваша учётная запись принадлежит правильной организации.
3. Добавьте MCP-сервер в свой ИИ-клиент.
4. При появлении запроса завершите вход в браузере.

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

Ваша роль в 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-ключи, не могут напрямую пройти аутентификацию на этом сервере.

Начинайте каждый сеанс с обнаружения

После подключения попросите ИИ-клиент обнаружить доступные вам организации и веб-сайты:

Используй только сервер 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>.
Прочитай её текущие блоки, обнови заголовок главного блока и опубликуй изменения.

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

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

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

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

Сквозной рабочий процесс с содержимым

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

Например:

Figma MCP + Profound CMS MCP

может объединить исследование дизайна, создание содержимого, работу с CMS, локализацию и публикацию в единый рабочий процесс с поддержкой ИИ.