К содержимому
Интеграции

Работа через MCP

Обновлено

Что нужно установить

Плагин «База знаний для MCP» устанавливается отдельно в приложение MCP. Он даёт агенту доступ к проектам, главам, статьям, поиску и настройкам хаба.

Нужны:

  • приложение MCP версии 1.10.4 или новее;
  • «База знаний» (code) версии 2026.10.21 или новее;
  • установленный плагин «База знаний для MCP»;
  • MCP-клиент и токен с правами необходимых инструментов.

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

Плагин предоставляет агенту навык code-basics, объясняющий работу с документацией.

Инструменты чтения

Инструмент Назначение
code_list_projects Список доступных проектов
code_get_project_tree Дерево глав и статей проекта
code_get_page Полная статья с текстом, статусом и метаданными
code_search_pages Поиск статей, включая черновики; можно ограничить проектом
code_get_hub_settings Общие настройки и плитки хаба с учётом доступных проектов
code_preview_markdown HTML и оглавление для переданного Markdown без сохранения статьи

Поиск MCP использует те же поля и правила совпадения слов, что поиск витрины, но включает черновики. Принимает query, необязательные project_id и limit от 1 до 100. Возвращает total, returned, truncated, results.

Инструменты изменения

Инструмент Назначение
code_create_project Создать проект
code_update_project Изменить параметры, вступление, SEO и статус проекта
code_delete_project Удалить пустой проект
code_create_chapter Создать главу в проекте
code_update_chapter Изменить название или порядок главы
code_delete_chapter Удалить главу, оставив статьи без главы
code_sort_chapters Задать порядок глав проекта
code_create_page Создать статью
code_update_page Изменить текст, адрес, описание, SEO или статус статьи
code_set_page_status Установить статус draft или published
code_move_page Перенести статью в проект и главу; можно задать адрес и порядок
code_sort_pages Задать порядок статей в главе или группе без главы
code_delete_page Удалить статью
code_set_hub_settings Изменить тексты, SEO и список плиток хаба
code_upload_image Опубликовать подготовленное изображение и получить URL для Markdown

Для изменений существующих записей используются project_id, chapter_id или page_id соответствующего инструмента. При создании главы или статьи указывается project_id; для статьи chapter_id: 0 означает «Без главы».

Новые материалы без указанного статуса создаются черновиками. Отдельный инструмент публикации удобен для последовательности «подготовить → проверить → опубликовать», но права code_create_page и code_update_page тоже позволяют передать статус published. Чтобы оставить токену только чтение, выдайте только права чтения.

Управление тегами проектов и настройками оформления темы через эти инструменты не предусмотрено. Для тегов используйте бэкенд «Базы знаний».

Права и ограничения проектов

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

Токен можно ограничить списком ID проектов. Ограничение действует на чтение, поиск и изменения, в том числе на перенос статей. Такой токен не может создавать проекты и менять общие настройки хаба. При чтении хаба он получает только плитки разрешённых проектов.

Ограничение проектами не делает загруженное изображение приватным: code_upload_image сохраняет файл в публичном хранилище приложения.

Изображения

  1. Агент передаёт файл инструменту ядра MCP mcp_stage_file.
  2. Полученный путь передаётся в code_upload_image как source_path.
  3. Возвращённый URL вставляется в Markdown статьи.

Принимаются PNG, JPEG, GIF и WebP размером до 10 МБ. SVG и произвольные пути сервера не принимаются. Файл должен находиться в разрешённой области временной загрузки текущего токена. Токену нужны права mcp_stage_file и code_upload_image.

Удаление статьи не удаляет загруженные изображения автоматически.

Удаление

Удаление проекта, главы или статьи требует confirm: true и одноразового подтверждения, полученного инструментом ядра mcp_issue_confirm. Токен подтверждения передаётся в _meta.confirmToken и привязан к конкретному инструменту и точным аргументам запроса. Для этого токену MCP нужно право mcp_issue_confirm.

Проект можно удалить только после удаления всех его статей, включая _index, и глав. Удаление главы сохраняет статьи без главы.

Примеры просьб агенту

  • «Покажи разделы базы знаний и найди статью об установке, включая черновики».
  • «В разделе “Руководство” создай главу “Начало работы”».
  • «Подготовь статью в Markdown, покажи предпросмотр и сохрани черновиком».
  • «Проверь заголовок и описание для поиска у статьи, затем предложи правки».
  • «Опубликуй проверенную статью. Сначала проверь, опубликован ли сам раздел».
  • «Загрузи это изображение и вставь полученный адрес в статью».
  • «Покажи настройки хаба и предложи порядок плиток».

Какие данные получает агент

В MCP-клиент передаются запрошенные материалы: названия и структура проектов, тексты и метаданные статей, статусы, настройки хаба, результаты поиска и предпросмотра. При разрешённом доступе в ответы входят черновики.

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