Это обновление представляет MCP-сервер Документерры для управления документацией с помощью ИИ, расширяет API Документерры и добавляет точечные улучшения для виджетов ИИ Помощника и рабочих процессов с форматом Markdown.
Управляйте документацией на платформе Документерра из ИИ-агентов
MCP-сервер Документерры помогает превращать знания о продукте в структурированный контент Документерры на более ранних этапах жизненного цикла документации. Спецификации, изменения в коде, исходные файлы и обсуждения внутри команды могут становиться черновиками страниц, обновлениями дерева страниц и изменениями рабочих процессов, при этом Документерра сохраняет контроль над правами доступа, структурой, процессом рецензирования и публикацией.
Теперь всю эту работу можно начинать прямо в ИИ-инструментах, таких как Claude Desktop и Cursor. Разработчик может превратить спецификацию, изменение кода или исходный файл в черновик страницы в том же рабочем пространстве, где уже находится исходный материал. Технический писатель может использовать тот же процесс, чтобы перестроить структуру раздела, обновить владельцев страниц или подготовить набор неопубликованных страниц к рецензированию. Больше примеров — в вариантах использования MCP-сервера.
Для подключения используется стандартная процедура входа в Документерру, включая SSO и 2FA. После входа ИИ-инструменты работают с теми же правами, что и авторизованный пользователь. Пользователь с доступом только для чтения, включая авторизованных читателей, может читать публикации, доступные его учетной записи; пользователь с правами автора может использовать инструменты редактирования в рамках своих разрешений на платформе Документерра. Работа с помощью ИИ становится частью того же жизненного цикла документации, а не отдельным этапом копирования и вставки. Инструкции по настройке — в разделе подключения к MCP-серверу.
Первая версия охватывает этап от черновика до рецензирования: создание проектов, подготовку и редактирование обычных страниц, обновление полей исполнителя, владельца и статуса, а также внесение поддерживаемых изменений в структуру страниц. Публикация и администрирование портала остаются в Документерре, чтобы владельцы документации сохраняли контроль над тем, что будет опубликовано. Некоторые расширенные функции, включая удаление, импорт проектов и настройки на уровне портала, пока не поддерживаются. Страницы API-документации нельзя редактировать через MCP, а в переводных проектах доступны только обновления полей рабочего процесса.
Более удобный API для автоматизации и ИИ-процессов
API v2 для Документерры использует более понятные REST-шаблоны и более согласованную структуру ответов. Действия с проектами, которые раньше выполнялись через один endpoint, в API v2 разделены на отдельные операции, что делает API проще для чтения, документирования, тестирования и использования в инструментах разработчика.
API v1 по прежнему поддерживается и сохраняет обратную совместимость. Мы также расширили API v1 новыми методами для создания проектов, публикаций проектов и пользовательских статусов и переходов в рабочем процессе, чтобы существующие интеграции могли использовать эти возможности без перехода на API v2.
Мы также переносим публичную API-документацию в OpenAPI. Команды разработки получают структурированное описание API, которое можно использовать в инструментах разработчика, сгенерированных клиентах и сценариях интеграции с ИИ-поддержкой.
Команды могут переходить на API v2, когда им нужна новая структура, более структурированные поля ответов или вывод в Markdown.
API v2 может возвращать содержимое страниц, сниппеты поиска и ответы ИИ Помощника в формате Markdown. Это упрощает использование контента Документерры в ИИ-процессах, внутренних инструментах, репозиториях кода и других системах, уже работающих с форматом Markdown.
Мы также упростили создание черновиков страниц и добавили метаданные языков проекта для многоязычных интеграций.
Выбирайте источники для внешних виджетов ИИ Помощника
Внешний виджет ИИ Помощника теперь имеет собственный выбор источников. Вы можете указать, какие открытые публикации он может использовать, чтобы ответы во встроенном помощнике ограничивались только тем контентом, который вы выбрали для конкретного сайта или приложения.
Копируйте страницы в формате Markdown
Авторы теперь могут копировать страницу в формате Markdown прямо из редакторского интерфейса. Можно использовать, когда нужен чистый, структурированный контент страницы для ИИ-запроса, задачи, pull request, обсуждения рецензирования или быстрой передачи разработчику без полного экспорта.
Улучшения
Страницы функций для недоступных аддонов теперь объясняют, что делает определенная функция и как запросить доступ — прямо на том же экране.
В шаблон читательского интерфейса Next добавлен выбор языка для многоязычных порталов. Читатели могут переключаться между локализованными версиями, а Документерра сохраняет выбранный язык на домашних страницах, в результатах поиска и статьях.
Пользовательские скрипты портала теперь могут анонимно читать данные открытых публикаций, что упрощает создание брендированных переключателей публикаций, переключателей языков и элементов домашней страницы.