Если база знаний компании живёт в Confluence, MCP Confluence соединяет её с ИИ-агентом: агент читает разрешённые пространства, ищет страницы с ответом и приводит цитату со ссылкой на источник. Доступ определяется правами авторизованной учётной записи, выданными разрешениями и настройками организации. Для персонального доступа используют OAuth, для фонового сценария возможна служебная учётная запись с API-токеном при разрешении администратора. Схема оправдана, когда поиск по базе нужен агенту ежедневно, а права на пространства разграничены по отделам.
Что получит агент
Агент может искать доступные авторизованной записи страницы. В ответе требуйте проверяемую цитату и ссылку; дату обновления показывайте как подсказку для проверки актуальности.
MCP для Confluence — канал между агентом и облачным пространством Atlassian: сервер предоставляет инструменты поиска и чтения Confluence; доступный набор зависит от метода авторизации, разрешений и настроек организации. Состав инструментов и параметры проверяйте в текущей документации Atlassian: каталог развивается. Общая схема MCP-подключений — адреса серверов, OAuth-авторизация, список инструментов — разобрана в материале о настройке MCP-подключений, здесь же разбираем контур именно для страниц базы знаний. Для поиска используются инструменты Atlassian с правами авторизованной записи. Простой сценарий обходится без отдельного поискового индекса, но качество поиска и полноту результатов всё равно проверяют на наборе вопросов. Срок подключения зависит от настроек организации и согласования доступа.
Для каких задач это удобно: ответы сотрудникам по внутренним регламентам, подготовка черновиков со ссылками на инструкции, сверка формулировок в документах с актуальной версией страницы. После чтения страницы агент использует её заголовок, текст, ссылку и доступные метаданные, включая дату обновления. Дата обновления и автор помогают ранжировать ответы: при равной релевантности владелец раздела может предпочесть утверждённый регламент черновой заметке. Правильность содержания требует проверки у владельца раздела независимо от даты правки. Настройте формат ответа так, чтобы каждый важный тезис имел ссылку; цитату проверяйте по открытой странице.
Права чтения
При интерактивном OAuth доступ ограничен правами вошедшего пользователя; фоновой сценарий со служебной учётной записью и API-токеном требует разрешения администратора. Для него выделите минимально необходимые права: общие инструкции, база знаний поддержки, внутренняя вики отдела. Пространства с персональными данными, финансовыми сводками и закрытыми проектами остаются за пределами прав служебной записи: запрос к таким страницам должен отклоняться или возвращать результат без закрытого содержимого. Проверьте это тестом с известной закрытой страницей. Доступ через служебную запись отличается от доступа сотрудника: у человека права шире, у агента — ровно набор, утверждённый для его задач.
- Создайте служебную учётную запись Atlassian и дайте ей доступ к выбранным пространствам.
- Выберите подходящий способ входа: OAuth для пользователя либо разрешённый администратором API-токен служебной записи.
- Проверьте список доступных инструментов и отключите лишние, если клиент позволяет.
- Зафиксируйте владельца служебной записи и порядок пересмотра прав.
Права пересматривайте по мере смены состава пространств: страницы переезжают, проекты закрываются, команды меняют структуру базы. По установленному владельцем графику сверяйте список доступа служебной записи с реестром пространств — так контур остаётся согласованным с реальностью. Любое расширение прав проходит через того же владельца, который утверждал исходный список: решения остаются прослеживаемыми, а лишний доступ исчезает ещё на этапе заявки.
Поиск с цитатой
Поиск строится в два хода. Сначала агент по запросу сотрудника получает список кандидатов — страниц с совпадением по тексту, с ограничением по доступному пространству, если инструмент поддерживает такой фильтр. Клиент открывает короткий список страниц и собирает ответ: тезис с цитатой из страницы, ссылка на источник, дата последней правки. Запрос сотрудника переформулируется агентом в поисковую строку с синонимами: внутренние аббревиатуры компании сопоставляются с заголовками и текстом страниц, и точность поиска растёт с качеством заголовков в базе. Требование цитаты помогает проверить происхождение ответа. Сверяйте её с содержимым открытой страницы: модель способна искажать цитаты.
- Сформулируйте запрос и ограничение: пространство, тип страницы, глубина поиска.
- Получите список кандидатов и отбросьте устаревшие версии по дате обновления.
- Откройте страницы-источники и выпишите цитаты с адресами страниц.
- Соберите ответ: тезис, цитата, ссылка, дата; противоречия источников покажите рядом.
- Передайте ответ сотруднику с пометкой о страницах, требующих проверки человеком.
Результат поиска оформляется как короткая выдача: тезис, цитата, ссылка на страницу и дата её обновления. Такой формат удобно проверять и пригоден для вставки в ответ сотруднику или в задачу на доработку документации.
Находят ли сотрудники нужную страницу в базе с первого запроса?
Устаревшие страницы
База знаний стареет: инструкции переписываются, версии продуктов сменяются, владельцы страниц уходят. Агент с доступом к метаданным помогает держать порядок: поисковый контур собирает страницы раздела и отмечает страницы с давней датой проверки. Сигналы старения комбинируются: давняя дата плюс частые вопросы сотрудников по разделу — приоритетный кандидат, потому что устаревшая инструкция в разгаре спроса создаёт больше всего путаницы. Решение о переписывании остаётся за владельцем раздела, агент готовит список кандидатов для проверки человеком.
| Сигнал | Как проверить сигнал | Что решает человек |
|---|---|---|
| Страница давно правилась | Сравнить дату с графиком ревизии раздела | Подтверждает актуальность и переписывает |
| Дублирующие инструкции | Сравнить заголовки и похожие фрагменты | Оставляет одну версию и ставит ссылки |
| Ссылки на удалённые страницы | Открыть внутренние ссылки и записать ошибки | Чинит или убирает ссылки |
| Противоречащие версии | Показать спорные фрагменты рядом | Утверждает единый текст |
Контур готовит список кандидатов по согласованному графику, а владельцы разделов фиксируют решение по каждому. Правовая сторона поиска по корпоративным документам разобрана в материале о поиске с учётом прав и источников — он дополняет этот контур со стороны политик доступа.
Тест запрета
Перед запуском для сотрудников проверьте границы контура. Составьте список закрытых пространств и попросите агента найти страницу из закрытого раздела по характерному запросу: корректный результат — отсутствие закрытого содержимого в ответе, даже если инструмент вернул ошибку доступа или пустую выдачу. Если агент привёл цитату из закрытого пространства, доступ служебной записи пересматривают до запуска. Тест повторяют после каждого изменения прав или состава пространств: граница, проверенная полгода назад, сегодня может оказаться пропуском после переезда страниц между разделами. Проверку записывают в регламент с владельцем и датой следующего прогона.
Начните с одного пространства и служебной записи с минимальными правами: пройдите авторизацию, проверьте поиск с цитатой и тест запрета на закрытом разделе. Расширять доступ проще, чем сужать, поэтому добавляйте пространства по одному после каждого успешного прогона. Журнал прогонов — часть контура: дата проверки, список запросов и результаты теста запрета хранятся рядом с настройками. Для агентов с доступом к корпоративным системам полезен разбор прав и секретов, а внедрение под ключ — на странице про ИИ-агентов для бизнеса.