Разработчикам неудобно переключаться между IDE и браузером, чтобы спросить runbook. MCP-сервер Adminica подключает архив и RAG к Cursor, Claude Desktop и другим MCP-клиентам: поиск по библиотеке и полноценный ответ — из чата редактора.

Инструменты MCP

search_library — гибридный поиск по записям (Qdrant + BM25).
ask_adminica — ответ через POST /api/v1/query с источниками.
get_library_entry — карточка записи по UUID.
adminica_health — проверка доступности API.

Установка за 3 шага

pip install adminica-mcp — пакет на PyPI, без зависимостей всего приложения.
API-ключ ak_… — Профиль → Безопасность → API-ключи (нужен для ask_adminica).
Конфиг MCP-клиента — команда adminica-mcp и переменные ADMINICA_API_KEY, ADMINICA_API_URL.

{
  "mcpServers": {
    "adminica": {
      "command": "adminica-mcp",
      "env": {
        "ADMINICA_API_KEY": "ak_YOUR_KEY",
        "ADMINICA_API_URL": "https://adminica.ru/api/v1"
      }
    }
  }
}

Подробности и таблица клиентов — в документации MCP и на странице API.

Когда использовать MCP, а когда веб-чат

Сценарий	MCP в IDE	Веб-чат
Код рядом с контекстом репозитория	✓	—
Файлы, графики, веб-поиск в UI	—	✓
CI / автоматизация	REST API	REST API

Практики

Для staging укажите свой ADMINICA_API_URL.
Если GUI не видит adminica-mcp в PATH — пропишите полный путь из which adminica-mcp.
Не коммитьте ключи в репозиторий — только в локальный MCP-конфиг.

Практика с библиотекой Adminica

Тема «MCP Adminica в Cursor» лучше всего раскрывается на ваших материалах: кураторская библиотека плюс документы профиля и org-библиотека (если подключена). Задайте в чате конкретный вопрос, проверьте блок источников и при необходимости уточните формулировку — так RAG даёт воспроизводимый ответ, а не общий пересказ.

Короткий чек-лист

Один главный вопрос за сообщение; контекст — во вложении или ссылке на запись архива.
После обновления документов дождитесь индексации, прежде чем сравнивать ответы.
Для командных регламентов храните master-копию в согласованном разделе базы знаний.

Тарифы и on-prem зависят от контура; начните с чата на своих данных и оцените качество по цитатам, а не только по гладкости текста.

Итог: MCP переносит библиотеку знаний Adminica в привычную среду разработки без форка продукта.