Model Context Protocol (MCP) — это открытый стандарт, позволяющий ИИ-ассистентам взаимодействовать с внешними инструментами и источниками данных через структурированный интерфейс. Вместо копирования текста в окно чата в надежде, что модель поймёт контекст, MCP даёт ассистенту прямой типизированный доступ к вашим системам — чтение файлов, выполнение поиска, создание контента — всё через чётко определённые вызовы инструментов.

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

Valoryx поставляется со встроенным MCP-сервером с 26 инструментами. Никаких плагинов для установки, никакого отдельного сервиса для запуска — если у вас работает экземпляр, MCP-сервер уже на месте. Всё, что нужно, — это API-ключ.

Что на самом деле делает MCP

MCP определяет протокол для обнаружения и вызова инструментов. ИИ-клиент (например, Claude Desktop) подключается к MCP-серверу, запрашивает доступные инструменты и вызывает их со структурированными параметрами. Сервер выполняет операцию и возвращает структурированные результаты.

Это отличается от «ИИ-функций», прикрученных к продукту. Здесь нет проприетарной интеграции. Работает любой MCP-совместимый клиент. Спецификация MCP открыта, и несколько ИИ-ассистентов уже поддерживают её.

Практический результат: вы можете попросить Claude «найти все страницы, упоминающие аутентификацию», и он действительно выполнит поиск по вашему экземпляру документации, а не сгенерирует названия страниц из обучающих данных.

26 встроенных инструментов

Каждый инструмент находится в пространстве имён docplatform_*, поэтому он никогда не конфликтует с другими MCP-серверами в вашем клиенте. Полный справочник на уровне параметров находится на странице MCP; вот полный реестр по категориям:

Контент

Создание, чтение и реорганизация страниц. Каждая запись проходит через тот же сервис контента, что и веб-редактор, поэтому изменения отслеживаются и безопасны для синхронизации.

  • docplatform_list_pages — список страниц в подключённом рабочем пространстве.
  • docplatform_read_page — чтение markdown-контента и метаданных страницы.
  • docplatform_write_page — запись страницы: создаёт её, если она не существует, и обновляет, если существует. Единая операция «просто запиши» для ИИ-агентов.
  • docplatform_update_page — обновление существующей страницы (завершается ошибкой, а не создаёт новую — полезно, когда страница обязана уже существовать).
  • docplatform_delete_page — удаление страницы.
  • docplatform_move_page — перемещение страницы по новому пути в дереве.

Обнаружение и контекст

  • docplatform_search — полнотекстовый поиск по рабочему пространству с нечётким сопоставлением и ранжированными по релевантности результатами — тот же движок Bleve, что и в веб-интерфейсе.
  • docplatform_get_context — рабочая лошадка RAG: возвращает страницу вместе с её родителем, соседними страницами и целями её wikilink-ссылок за один вызов, так что ассистент получает окружающий контекст без пяти обращений туда-обратно.
  • docplatform_get_tree — полное навигационное дерево рабочего пространства. Полезно для понимания структуры документации перед внесением изменений.
  • docplatform_list_workspaces — список рабочих пространств, доступных API-ключу.
  • docplatform_get_manifest — машиночитаемый манифест рабочего пространства.

Качество

  • docplatform_validate_links — поиск битых внутренних ссылок и wikilink-ссылок.
  • docplatform_quality_scan — сканирование контента на предмет проблем качества.

Версионирование

  • docplatform_list_versions / docplatform_create_version — список и создание именованных снимков версий.

Комментарии и активность

  • docplatform_list_comments / docplatform_add_comment — чтение обсуждений страниц и участие в них.
  • docplatform_get_activity — лента недавней активности: кто, что и когда изменил.

Управление рабочими пространствами

  • docplatform_create_workspace / docplatform_get_workspace — создание и просмотр рабочих пространств.
  • docplatform_publish_workspace — публикация рабочего пространства как публичного сайта.

Темы, экспорт, ИИ и git-синхронизация

  • docplatform_get_theme / docplatform_update_theme — чтение и изменение темы рабочего пространства.
  • docplatform_export — экспорт контента рабочего пространства.
  • docplatform_writing_assist — серверная помощь при написании (улучшение, упрощение, расширение, суммаризация, исправление грамматики, перевод), когда настроен ИИ-провайдер.
  • docplatform_resolve_sync_conflict — разрешение конфликта git-синхронизации выбором одной из сторон или передачей объединённого контента.

Настройка Claude Desktop

MCP-сервер общается по stdio через сам бинарный файл docplatform — никаких пакетов-обёрток. Добавьте запись в файл конфигурации (на macOS — ~/Library/Application Support/Claude/claude_desktop_config.json; на Windows — %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "docplatform": {
      "command": "docplatform",
      "args": ["mcp", "--workspace", "my-docs", "--api-key", "dp_live_abc123"]
    }
  }
}

Создайте API-ключ в Workspace Settings → API Keys. Он начинается с dp_live_ и показывается только один раз. Ключи несут области действия (read, write, delete — admin включается отдельно), и каждый вызов MCP дополнительно проверяется по роли действующего пользователя в рабочем пространстве, поэтому ключ редактора (Editor) не может выполнять административные операции, какие бы области он ни заявлял.

Для удалённых и облачных экземпляров также есть транспорт Streamable HTTP (эндпоинт /mcp) — матрица транспортов и настройка по клиентам (Claude Code, Cursor, VS Code) описаны на странице MCP.

Практические примеры

После подключения вот конкретные вещи, которые можно делать:

Аудит согласованности

"Search all pages for references to our old API endpoint
api.example.com/v1 and list them"

Это вызывает docplatform_search со строкой старого эндпоинта. Вы получаете список каждой страницы, всё ещё ссылающейся на устаревший URL. Никакого ручного grep по репозиторию документации.

Написание и обновление контента

"Read the current authentication guide, then update it to include
the new passkey login flow. Keep the existing structure."

Ассистент вызывает docplatform_read_page для чтения текущего контента, готовит обновление и вызывает docplatform_update_page для его применения. Если настроена git-синхронизация, правка появляется как коммит в вашем репозитории с указанием действующего пользователя в качестве автора.

Обзор недавних изменений

"Show me everything that changed this week in this workspace"

Вызывает docplatform_get_activity. Возвращает, что изменилось, кто изменил и когда. Полезно для еженедельных обзоров документации без входа в веб-интерфейс.

Проверка качества перед релизом

"Validate all internal links in this workspace and list anything broken"

Вызывает docplatform_validate_links и возвращает битые цели вместе со страницами-источниками — такого рода проверка утомительна вручную и мгновенна при структурированном доступе.

Что это значит для обслуживания документации

Традиционный рабочий процесс обслуживания документации: кто-то замечает, что документация неверна, создаёт тикет, кто-то другой в конце концов обновляет страницу. Разрыв между «заметил» и «исправил» обычно составляет недели.

С MCP рабочий процесс становится: попросить ИИ провести аудит раздела, проверить результаты, одобрить изменения. Разрыв сокращается до минут. Не потому что ИИ пишет лучшую документацию — он не пишет, по крайней мере не надёжно — а потому что узким местом всегда было найти, что неправильно, и внести правку, а не сочинить текст.

Это особенно хорошо работает для механических обновлений: изменения URL, переименование терминологии, обновление номеров версий, уведомления об устаревании. Тот тип изменений, который утомителен для людей и прост для ИИ со структурированным доступом к контенту.

Подробнее об использовании MCP для поддержания документации в актуальном состоянии — в статье Как поддерживать документацию в актуальном состоянии.

Ограничения, о которых стоит знать

MCP-инструменты оперируют отдельными страницами. Нет инструмента «перепиши весь сайт документации» — по замыслу. Масштабная реструктуризация всё ещё требует человеческого суждения об информационной архитектуре.

Инструменты записи вносят реальные изменения. Если выдать ассистенту ключ с областями write и delete, он сможет изменять и удалять страницы. Начните в режиме «только чтение»: создайте ключ только с областью read для аудита и выдавайте области записи, когда начнёте доверять циклу проверки. Области действия применяются на стороне сервера — вместе с ролью действующего пользователя в рабочем пространстве.

Качество поиска зависит от вашего контента. Если ваша документация использует непоследовательную терминологию, ИИ найдёт непоследовательные результаты. MCP делает поиск быстрым, но не исправляет проблемы с качеством контента.

Начало работы

  1. Установите Valoryx — один бинарный файл, без зависимостей, запуск менее чем за 2 минуты
  2. Создайте API-ключ в Workspace Settings → API Keys
  3. Добавьте конфигурацию MCP-сервера в Claude Desktop
  4. Начните с рабочего процесса только для чтения: поиск и аудит до того, как включите запись

Документация MCP содержит полный справочник по всем 26 инструментам, включая типы параметров и схемы ответов.

Обслуживание документации не обязательно должно быть ручным процессом. Со структурированным протоколом между вашим ИИ-ассистентом и платформой документации утомительные части — поиск устаревшего контента, проверка согласованности, механические обновления — становятся тем, что можно делегировать с уверенностью.