DocsMint MCP
DocsMint дает агентам искать, читать и править документы базы знаний через 22 инструмента MCP, облако или свой Docker
- 81 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Ключ с правом записи позволяет агенту менять документы базы знаний
- Глобальный ключ открывает все документы владельца, поэтому для агента лучше брать ключ категории
- Облачный вариант отправляет содержимое документов на сервер docsmint.com
Установка
- Работает в
Ручная установка
codex mcp add docsmint --url https://docsmint.com/mcp --bearer-token-env-var HIAI_DOCS_API_KEYОблачный DocsMint. Ключ API создается в браузере и хранится в переменной окружения.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ключ с правом записи позволяет агенту менять документы базы знаний
- Глобальный ключ открывает все документы владельца, поэтому для агента лучше брать ключ категории
- Облачный вариант отправляет содержимое документов на сервер docsmint.com
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
DocsMint — база знаний для людей и ИИ-агентов с визуальным редактором, Markdown, папками, категориями и тегами. Поиск гибридный, дополнительно есть GraphRAG. К тем же документам агент обращается через MCP, REST, типизированный SDK или CLI. Репозиторий содержит само приложение на SvelteKit с бэкендом и сервер MCP. Сервер MCP отдает 22 инструмента, два промпта и три ресурса, а в наборе есть готовый скилл document-manager. Подключиться можно тремя способами. Облако DocsMint доступно по адресу `https://docsmint.com/mcp` (Streamable HTTP) с входом через OAuth или ключом API. Свой экземпляр поднимается через Docker Compose, и тогда MCP работает по пути `/mcp` вашего домена с заголовком `Authorization: Bearer`. Третий вариант — stdio-мост `docsmint-mcp` из пакета `@hiai-gg/docsmint`, которому нужен Bun 1.4.4 или новее. Ключи API бывают глобальными и привязанными к категории. Ключ категории ограничивает документы и операции, доступные агенту, отдельно для чтения, правки и записи, так что агенту можно открыть только нужную папку знаний.
Для кого. Командам и одиночным разработчикам, которые ведут заметки и документацию в одном месте и хотят дать Claude Code, Cursor или Codex доступ к ним без выдачи доступа к файловой системе и базе.
Подходит, если
- Документация проекта лежит в базе знаний, и агенту нужно находить в ней ответы гибридным поиском
- Агент должен записывать итоги работы в документ, а доступ нужен только к одной категории
- Вы разворачиваете собственный сервер документации через Docker и подключаете к нему Codex по Bearer-ключу
- В вашей базе накоплено много связанных заметок, и пригодится поиск через GraphRAG
- Облачный сервис удобнее: подключение идет через OAuth без установки сервера
Не подходит, если
- Хватает обычных Markdown-файлов в репозитории, которые агент и так читает
- Нужен только доступ к локальной папке заметок, а ставить сервер с базой данных избыточно
- Нет Docker Compose v2 и нет желания пользоваться облаком
- Вы ищете приложение для личных заметок без интеграции с агентами
Пример запроса к агенту
Найди в DocsMint документ про деплой и допиши в него раздел с откатом релизаMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
HIAI_DOCS_URLобязательная- Адрес вашего API DocsMint для моста stdio
HIAI_DOCS_API_KEYобязательная, секрет- Глобальный ключ или ключ категории из Settings, раздел API
Ограничения
- Для своего сервера нужны Docker Compose v2 и создание ключа API в настройках приложения, мост stdio сам приложение не ставит.
- Мост `docsmint-mcp` запускается через Bun 1.4.4 или новее, а Node.js тут не подходит.
- OAuth и обновляемые токены есть только в DocsMint Cloud, в самостоятельной установке вход идет по ключу в заголовке Bearer, а сеанс браузера как ключ не принимается.
- Рабочие области и тарифные ограничения облака зависят от плана, подробности в руководстве по подключению на сайте.
Как отключить. Уберите запись `docsmint` из настроек MCP вашего агента, а ключ отзовите в разделе Settings, раздел API приложения. Самостоятельный экземпляр останавливает `docker compose down`.
Частые вопросы
Как подключить DocsMint к Codex или Claude Code?
Для облака подходит `codex mcp add docsmint --url https://docsmint.com/mcp --bearer-token-env-var HIAI_DOCS_API_KEY`. Клиенты с поддержкой OAuth подключаются через браузер и согласие на доступ к выбранным рабочим областям.
Можно ли обойтись без облака?
Да. Поднимите приложение через Docker Compose, создайте ключ в Settings, раздел API и укажите адрес вида `https://docs.example.com/mcp`. Для stdio-моста понадобятся Bun 1.4.4 и переменные `HIAI_DOCS_URL` и `HIAI_DOCS_API_KEY`.
Какие права получает агент?
Права ключа. Глобальный ключ открывает все документы, а ключ категории ограничивает документы и операции, причем чтение, правка и запись настраиваются независимо.
Сколько инструментов у сервера MCP?
Двадцать два, плюс два промпта и три ресурса. Инструменты покрывают все 31 операцию приложения и пакетные действия.
Что умеет поиск в DocsMint?
Поиск гибридный, а для связанных заметок есть GraphRAG. Документы ведут в визуальном редакторе или в Markdown и раскладывают по папкам, категориям и тегам.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальная база заметок в Markdown с MCP-сервером и скиллами: Claude Code, Cursor, Codex и Gemini CLI читают один и тот же контекст
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Roam Research MCP и CLI
Roam Research MCP and CLI
Агент ищет, читает и пишет в граф Roam Research через локальный API настольного приложения, есть CLI и скилл с синтаксисом
Google Docs MCP — Docs, Sheets, Drive, Gmail и Calendar
Google Docs MCP
MCP-сервер дает агенту Google Docs, Sheets, Drive, Gmail, Calendar и Apps Script: чтение, правка, письма и события; вход через OAuth
Официальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| DocsMint (эта карточка) | да | API-ключ | 81 | |
| knowledge-rag | нет | не нужна | 301 | локальный RAG по файлам, без визуального редактора и облачного сервиса |
| Docs MCP Server | нет | не нужна | 1 860 | индексирует чужую документацию библиотек и не ведет вашу базу знаний |
Коротко о README
README начинается с подключения облака, затем описывает самостоятельную установку через Docker, историю релизов и причины выбрать DocsMint. Отдельные разделы посвящены клиентам MCP, REST, SDK и CLI, ключам по категориям и настройке адреса, происхождения запросов и CORS.