Kibela MCP Server
Официальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом
- 16 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Токен доступа Kibela дает агенту читать заметки и комментарии команды в пределах прав его владельца
- Инструменты создают заметки, папки и комментарии и заменяют содержимое заметок, поэтому ошибки агента попадают в общую вики
Установка
- Работает в
Ручная установка
{
"mcpServers": {
"kibela": {
"command": "docker",
"args": ["run", "-i", "-e", "KIBELA_ORIGIN", "-e", "KIBELA_ACCESS_TOKEN", "ghcr.io/kibela/kibela-mcp-server"],
"env": {
"KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
"KIBELA_ACCESS_TOKEN": "***"
}
}
}
}Файл `claude_desktop_config.json`. Docker должен быть запущен.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Токен доступа Kibela дает агенту читать заметки и комментарии команды в пределах прав его владельца
- Инструменты создают заметки, папки и комментарии и заменяют содержимое заметок, поэтому ошибки агента попадают в общую вики
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер работает локально по STDIO и подключается к клиентам MCP, например к Claude Desktop или VS Code. Он отдает агенту 17 инструментов: шесть для заметок (поиск, чтение по Relay ID, адресу или папке, создание и замена содержимого), семь для папок (поиск, чтение, создание, перенос заметки между папками, привязка заметки к папке), два для комментариев и ответов на них и два для групп и лент. Поиск заметок принимает фильтры по группам, папкам, датам обновления, авторам лайков и архиву. Кроме инструментов, у сервера четыре готовых промпта: проверка заметки по адресу, поиск по теме, поиск связанных заметок и перенос комментариев в текст заметки. Описания инструментов и тексты промптов переопределяются JSON-файлом, который монтируют в контейнер.
Для кого. Командам, которые ведут внутреннюю вики в Kibela и хотят искать в ней и дописывать заметки из Claude Desktop или VS Code.
Подходит, если
- Сотрудник спрашивает ассистента про регламент, и тот ищет ответ в заметках Kibela и называет источник
- Нужно разложить разрозненные заметки по папкам, и агент переносит их `move_kibela_note_to_another_folder`
- Черновик заметки готовит агент: `create_kibela_note` с флагом черновика кладет его в нужные группы
- Под заметкой накопились комментарии, и промпт Reflect Comment вносит их в текст
- Перед публикацией текста заметки просят проверить по промпту Review
Не подходит, если
- Нужен размещенный сервер без установки: доступен только локальный запуск по STDIO
- Docker не установлен, и собирать сервер из исходников не хочется
- Вам нужны функции Kibela вне публичного GraphQL API: сервер реализует только подходящую для MCP часть
Пример запроса к агенту
Найди в Kibela заметки про процесс релиза за последний месяц и составь по ним краткую памятку, ничего в вики не меняяMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
KIBELA_ORIGINобязательная- Адрес вашей команды в Kibela, например https://your-subdomain.kibe.la.
KIBELA_ACCESS_TOKENобязательная, секрет- Токен доступа, который выпускается на странице настроек токенов Kibela.
Ограничения
- Доступен только локальный запуск по STDIO.
- Для запуска нужны Docker и токен доступа Kibela. Вариант без Docker требует запустить `bin/cli.mjs` по абсолютному пути.
- Реализована только часть публичного GraphQL API.
- Сервер работает с одной командой Kibela: ее адрес задает переменная `KIBELA_ORIGIN`.
- Удаления заметок и папок среди инструментов нет, но `update_kibela_note_content` заменяет содержимое заметки.
- Последний коммит в репозитории сделан в марте 2026 года.
Как отключить. Удалите блок `kibela` из `claude_desktop_config.json` или другого файла настроек клиента и перезапустите клиент. Токен доступа отзовите на странице токенов в Kibela.
Частые вопросы
Как подключить Kibela к Claude Desktop?
Добавьте в `claude_desktop_config.json` блок `kibela` с командой `docker`, аргументами `run -i -e KIBELA_ORIGIN -e KIBELA_ACCESS_TOKEN ghcr.io/kibela/kibela-mcp-server` и значениями обеих переменных в `env`. Затем перезапустите клиент.
Где взять токен доступа?
На странице токенов доступа в настройках Kibela: `https://my.kibe.la/settings/access_tokens`. Токен вместе с адресом вашей команды вида `https://your-subdomain.kibe.la` кладут в переменные `KIBELA_ACCESS_TOKEN` и `KIBELA_ORIGIN`.
Можно ли запустить сервер без Docker?
Да. Укажите в конфигурации клиента абсолютный путь к скрипту `bin/cli.mjs` из репозитория в поле `command`. Те же две переменные окружения передаются в `env`.
Можно ли изменить описания инструментов и промптов?
Да. Подготовьте JSON с ключами `tools` и `prompts`, например новое описание для `search_kibela_note`, и смонтируйте его в контейнер как `/usr/src/app/kibela-mcp-server-config.json`. Ключи перечислены в `src/lib/server.ts`.
Перезапишет ли агент заметку случайно?
Для замены содержимого `update_kibela_note_content` принимает новый и исходный текст вместе, поэтому правка опирается на прежнюю версию. Удаления заметок среди инструментов нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыObsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
Подключает агента к Nextcloud: заметки, календарь, контакты, файлы, почта и доски Deck через 110 с лишним инструментов MCP
MCP-сервер к базе знаний, которую Beever Atlas строит из чатов Slack, Discord, Teams и Mattermost: ответы с цитатами, вики по каналам, граф связей
Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
Minutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Kibela MCP Server (эта карточка) | да | API-ключ | 16 | |
| Notion MCP Server | да | API-ключ | 4 698 | официальный сервер Notion с базами данных и страницами в Markdown, а здесь вики Kibela с заметками, папками и комментариями |
| ya-wiki-mcp | нет | API-ключ | 1 | сервер для Yandex Wiki со страницами, гридами и вложениями, а этот работает с другой вики, Kibela |
Коротко о README
Страница коротко представляет сервер и его случаи применения, перечисляет требования и дает два примера конфигурации: через Docker и без него. Основная часть описывает параметры каждого инструмента и четыре промпта, а в конце объяснены настройка описаний и запуск разработки.