Agility CMS MCP Server

Официальный MCP-сервер для Agility CMS: размещённый удалённый сервер, который предоставляет вашим AI-инструментам доступ в реальном времени к контенту, моделям, страницам и медиафайлам в экземплярах Agility, к которым у вас уже есть доступ. Управляйте ими в диалоге, а не через API.

Подключение клиента · Возможности · Инструменты · Данные и безопасность · Устранение неполадок · Поддержка

Устанавливать ничего не нужно. Укажите в настройках клиента адрес https://mcp.agilitycms.com/api/mcp, войдите в свою учётную запись Agility — и ваш ассистент сможет работать с доступными вам экземплярами.

Конечная точка: https://mcp.agilitycms.com/api/mcp (потоковый HTTP)
Аутентификация: OAuth 2.0 через вашу организацию Agility — доступ определяется вашими разрешениями в Agility
Инструменты: 32 инструмента для работы с контентом, моделями, компонентами, контейнерами, страницами, картами сайта и медиафайлами
Инструкция по настройке со снимками экрана: mcp.agilitycms.com/instructions
Каталог инструментов: mcp.agilitycms.com/tools

Подключение клиента

В один клик

Все поддерживаемые клиенты

Клиент	Как подключить
VS Code (GitHub Copilot)	Нажмите на значок подключения выше или откройте Command Palette → MCP: Add Server → HTTP
Cursor	Нажмите на значок подключения выше или откройте Settings → MCP → Add new MCP server → HTTP
LM Studio	Нажмите на значок подключения выше
Claude Code	`claude mcp add --transport http "Agility-CMS" https://mcp.agilitycms.com/api/mcp`
Claude (настольная и веб-версии)	Официальный коннектор — Customize → Connectors → Discover → найдите Agility CMS → Connect
Windsurf	Settings → Cascade → MCP servers → добавьте конечную точку
Gemini CLI	`gemini mcp add --transport http agility-cms https://mcp.agilitycms.com/api/mcp`
ChatGPT	Settings → Apps & Connectors → Advanced → Developer mode → добавьте коннектор
Любой другой клиент	Подойдёт любой клиент с поддержкой потокового HTTP. Для клиентов, работающих только через stdio, используйте мост `mcp-remote`

Подробные инструкции со снимками экрана доступны на странице mcp.agilitycms.com/instructions. Для ручной настройки достаточно указать конечную точку. Ниже приведены инструкции для отдельных клиентов.

Claude Code

claude mcp add --transport http "Agility-CMS" https://mcp.agilitycms.com/api/mcp

Claude (настольная и веб-версии)

Agility CMS — официальный коннектор в каталоге Claude, поэтому вставлять адрес вручную не нужно.

Для личной учётной записи — откройте Customize → Connectors → Discover, найдите Agility CMS и нажмите Connect. Затем войдите в Agility, когда появится соответствующий запрос. Или сразу перейдите на страницу коннектора:

https://claude.ai/customize/connectors/directory?q=Agility%20CMS

Выберите Agility CMS. Agility CMS Knowledgebase — отдельный коннектор для сайта с документацией, помеченный как Custom.

Для администрирования рабочей области Team или Enterprise — включите коннектор Agility CMS для организации в настройках администратора. После этого он станет доступен всем пользователям, но не подключит их автоматически: каждый участник должен войти в Agility самостоятельно, а все действия будут выполняться с его разрешениями в Agility. Общие учётные данные или учётные данные службы не используются.

Если коннектор ещё не появился в каталоге, можно подключиться к серверу напрямую: откройте Customize → Connectors → Add и добавьте адрес как пользовательский коннектор:

https://mcp.agilitycms.com/api/mcp

VS Code (GitHub Copilot)

Откройте Command Palette → MCP: Add Server → HTTP, затем вставьте адрес конечной точки. Или добавьте следующие настройки в файл конфигурации MCP:

{
  "servers": {
    "agility-cms": {
      "type": "http",
      "url": "https://mcp.agilitycms.com/api/mcp"
    }
  }
}

Cursor

Откройте Settings → MCP → Add new MCP server, выберите HTTP и укажите URL, приведённый выше. Или добавьте настройки в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "agility-cms": {
      "url": "https://mcp.agilitycms.com/api/mcp"
    }
  }
}

LM Studio

Используйте значок подключения выше или добавьте конечную точку в разделе Program → Install → Edit mcp.json:

{
  "mcpServers": {
    "agility-cms": {
      "url": "https://mcp.agilitycms.com/api/mcp"
    }
  }
}

Windsurf

Откройте Settings → Cascade → MCP servers и добавьте сервер, указав конечную точку выше.

Gemini CLI

gemini mcp add --transport http agility-cms https://mcp.agilitycms.com/api/mcp

Или добавьте настройки в ~/.gemini/settings.json:

{
  "mcpServers": {
    "agility-cms": {
      "httpUrl": "https://mcp.agilitycms.com/api/mcp"
    }
  }
}

ChatGPT

Откройте Settings → Apps & Connectors → Advanced → Developer mode, затем добавьте коннектор, указав конечную точку выше.

Любой другой клиент

Подойдёт любой клиент с поддержкой потокового HTTP. Укажите конечную точку и запустите процесс OAuth — API-ключ вводить не нужно, а сохранять настройки в конфигурационном файле не требуется.

Если клиент поддерживает только локальные серверы (stdio), подключите его через mcp-remote:

{
  "mcpServers": {
    "agility-cms": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.agilitycms.com/api/mcp"]
    }
  }
}

Этот мост — универсальный клиентский адаптер, а не пакет Agility. Пакета agility-mcp-server в npm нет и не будет: для размещённого HTTP-сервера ничего устанавливать не нужно. Если вы встретите конфигурацию, в которой предлагается запустить через npx пакет с названием Agility, она неверна.

Возможности

После подключения общайтесь с ассистентом о своём контенте — он сам выберет подходящие инструменты. Большинство инструментов используют instanceGuid (идентификатор экземпляра Agility), а для работы с контентом также требуется locale. Сначала попросите ассистента перечислить доступные экземпляры — затем он будет использовать нужный.

«Перечисли доступные мне экземпляры Agility, а затем покажи модели контента на маркетинговом сайте».
«Добавь текстовое поле Subtitle в модель Blog Post, на существующую вкладку SEO».
«Создай модель Team Member с полями для имени, фотографии и биографии, а также со ссылкой на публикации этого участника. Затем создай для неё контейнер».
«Создай запись в блоге на en-us по этому плану и дай мне ссылку для редактора».
«Какие страницы в основном канале ещё не опубликованы?»
«Опубликуй три записи, которые я только что создал».

Данные и безопасность

Аутентификация выполняется через OAuth 2.0 для вашей организации Agility по HTTPS. API-ключ вводить не нужно, а сохранять настройки в конфигурационном файле не требуется: токены хранятся в клиенте MCP, а не в конфигурации этого репозитория или в редактируемых вами файлах.

Доступ ограничен вашими разрешениями в Agility. Каждый запрос выполняется от вашего имени: Management API отклоняет действия, которые вам недоступны. Поэтому сервер не может предоставить больше прав, чем у вас уже есть. Чтобы ограничить доступ ассистента, войдите в Agility под учётной записью, которой предоставлены только те права, которыми вы готовы поделиться.

Перед потенциально разрушительными действиями клиент запрашивает подтверждение. Инструменты delete_*, unpublish_content и unpublish_page помечены атрибутом destructiveHint: true, поэтому интерактивные клиенты запрашивают подтверждение перед их запуском. Неинтерактивные клиенты подтверждение не запрашивают — в них необходимо явно разрешить каждый инструмент для записи.

Считайте контент недоверенными данными. Это особенность MCP в целом, а не только Agility: ассистент читает элементы контента, текст страниц и описания полей, в которых могут содержаться фразы, похожие на инструкции (prompt injection). Если клиент реагирует на такие фразы, он делает это с вашими разрешениями. Используйте только те клиенты, которым доверяете, не отключайте запросы подтверждения для разрушающих действий и не предоставляйте агенту без контроля учётную запись Agility с широкими правами.

Какие данные попадают в журналы. Размещённый сервер записывает эксплуатационную телеметрию в Agility's Application Insights: вызванный инструмент или метод API, длительность, успешность или неудачу запроса, GUID экземпляра Agility и идентификатор вашего пользователя Agility. Для отладки запросы и ответы записываются в усечённом виде (по умолчанию не более 2 KB), поэтому в журналах могут оказаться небольшие фрагменты контента. На размещённом сервере отключить запись телеметрии со стороны клиента нельзя. Чтобы не собирать её, используйте собственный сервер без APP_INSIGHTS_CONNECTION_STRING.

Доступные инструменты MCP

Agility CMS MCP Server предоставляет 32 инструмента для решения различных задач:

🔍 Инструменты для поиска и обзора

get_available_instances — выводит список всех доступных вам экземпляров Agility CMS
get_current_user — определяет пользователя, от имени которого выполнена аутентификация по текущему токену (только для чтения, аналог whoami)
get_containers — предоставляет доступ к контейнерам контента, сгруппированным по категориям

📋 Инструменты для просмотра моделей

get_content_models — получает все модели контента для экземпляра
get_component_models — предоставляет доступ к моделям компонентов страниц

🔍 Инструменты для просмотра подробной информации

get_content_model_details — показывает подробные описания полей модели контента
get_component_model_details — показывает подробные описания полей модели компонента

📝 Инструменты управления контентом

get_locales — получить список доступных языков для многоязычного контента
get_content_items — получить несколько элементов контента с фильтрацией и постраничной выдачей
get_content_item — получить отдельный элемент контента по ID
save_content_items — создать или обновить элементы контента (для каждого элемента возвращается URL редактора)
publish_content — опубликовать один или несколько элементов контента
unpublish_content — снять с публикации один или несколько элементов контента (разрушительное действие)
manage_content_workflow — одобрить или отклонить элементы контента либо запросить их одобрение
delete_content_item — удалить элементы контента (разрушительное действие)

📄 Инструменты управления страницами

get_sitemaps — получить список всех цифровых каналов (карт сайта)
get_sitemap — получить полную иерархию страниц канала
get_page — получить страницу по ID
get_page_models — получить список доступных моделей страниц (шаблонов)
save_page_model — создать или обновить модель страницы (шаблон) и её зоны контента
save_page — создать или обновить страницу
reorder_page_modules — изменить порядок модулей в зоне страницы
publish_page — опубликовать одну или несколько страниц
unpublish_page — снять с публикации одну или несколько страниц (разрушительное действие)
manage_page_workflow — одобрить или отклонить страницы либо запросить их одобрение
delete_page — удалить страницы (разрушительное действие)

🖼️ Инструменты для работы с медиафайлами и ресурсами

initialize_media_upload — получить подписанные URL для загрузки медиафайлов
list_media — получить список ресурсов медиатеки с постраничной выдачей
delete_media — удалить ресурс медиатеки по ID (разрушительное действие)

⚡ Инструменты создания моделей и управления ими

save_content_model — создать или обновить модели контента
save_component_model — создать или обновить модели компонентов
save_container — создать и настроить контейнеры контента

🔒 Разрушительные действия отмечены отдельно. Для инструментов delete_*, unpublish_content и unpublish_page задан параметр destructiveHint: true, поэтому интерактивные MCP-клиенты запрашивают подтверждение перед их запуском («Разрешить запуск этого инструмента?»). Если выбрать «всегда разрешать», запросы подтверждения отключаются. Публикация и рабочий процесс одобрения являются добавочными и обратимыми действиями, поэтому они не помечены как разрушительные. О том, как работают разрешения и запросы подтверждения, см. в разделе «Данные и безопасность», а подробное описание каждого инструмента — в документации.

📚 Полная документация по инструментам и примеры: mcp.agilitycms.com/tools

Поддерживаемые типы полей

Agility CMS MCP Server поддерживает более 20 типов полей для создания полноценных моделей контента:

📝 Основные поля: текст, длинный текст, HTML, логическое значение, целое число, десятичное число, дата
🎯 Поля выбора: раскрывающийся список, ссылка, список с поиском, флажки
🎨 Медиа-поля: вложение изображения, вложение файла
🔗 Связи между элементами контента: общая сетка/ссылка, вложенная сетка/ссылка
📂 Организация: поле вкладки, пользовательский раздел
⚡ Расширенные поля: поля со сложными объектами, пользовательские типы полей, редактор форматированного текста

📚 Полная документация по типам полей: mcp.agilitycms.com/tools

Устранение неполадок

Симптом	Вероятная причина
Экземпляр отсутствует в результатах `get_available_instances`	У вашей учётной записи Agility нет доступа к этому экземпляру либо он не размещён в рабочем клиенте Agility, к которому подключается этот сервер.
При вызове инструментов возникает ошибка авторизации	Срок действия токена OAuth истёк или токен отозван — повторно подключите сервер в клиенте.
Ассистент сообщает, что не может вносить изменения, или незаметно переходит в режим чтения	В неинтерактивных клиентах необходимо явно разрешить каждый инструмент записи по имени. Проверьте разрешения на инструменты в настройках клиента.
Ссылка для установки в один клик ничего не делает	Редактор не был запущен или заблокировал передачу управления — вместо этого добавьте конечную точку вручную.
Инструмент отклоняет настройку поля	Agility проверяет изменения моделей на стороне сервера; текст ошибки передаётся без изменений. Например, для полей со связанным контентом нельзя задать параметры `required`, `unique` или `copyAcrossAllLanguages`.

Если проблему не удалось решить, напишите на support@agilitycms.com или

обратитесь в наше сообщество в Slack.

Поддержка и обратная связь

🌐 Веб-сайт: mcp.agilitycms.com
📖 Инструкции по настройке: mcp.agilitycms.com/instructions
🛠️ Каталог инструментов: mcp.agilitycms.com/tools
📚 Документация Agility CMS: agilitycms.com/docs
💬 Поддержка: support@agilitycms.com
👥 Сообщество: Присоединиться к Slack

Об этом репозитории

Этот репозиторий — публичный ресурс Agility CMS MCP Server. Здесь размещены документация, лицензия

и политика безопасности для размещённого сервиса по адресу https://mcp.agilitycms.com.

Сервер — это размещённый удалённый MCP-сервер: его не нужно устанавливать, и для него не требуется загружать пакет,

поэтому здесь нет сборки, которую можно было бы воспроизвести. Исходный код поддерживается Agility CMS и в настоящее время

не опубликован. Всё необходимое для использования сервера находится выше.

Лицензия

Документация в этом репозитории распространяется по лицензии Apache License 2.0.

Эта лицензия намеренно не распространяется на два объекта:

Размещённый сервис. Сервис https://mcp.agilitycms.com обслуживается Agility CMS в соответствии с собственными

условиями использования Agility. Использование сервиса и лежащего в его основе Agility CMS Management API

регулируется этими условиями и вашей подпиской Agility.

Название и товарные знаки Agility. Раздел 6 лицензии Apache 2.0 не предоставляет прав на товарные знаки. См. NOTICE.

Сообщения об уязвимостях: SECURITY.md.

Создано с ❤️ командой Agility CMS — самой быстрой headless CMS для разработчиков и маркетологов.