kintone MCP Server
Официальный MCP-сервер Cybozu: агент читает и меняет приложения, записи и пространства kintone через REST API.
- 59 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Инструменты изменяют и удаляют записи, поля формы и целые пространства в рабочей среде kintone.
- Пароль или API-токен дают агенту права учетной записи на все доступные ей приложения.
Установка
- Работает в
Ручная установка
npm install -g @kintone/mcp-serverПакет npm из README. Сервер запускают командой `kintone-mcp-server` с параметрами входа.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты изменяют и удаляют записи, поля формы и целые пространства в рабочей среде kintone.
- Пароль или API-токен дают агенту права учетной записи на все доступные ей приложения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Локальный MCP-сервер Cybozu подключает агента к облачной платформе kintone. Он отдает 27 инструментов: список приложений и настройки полей, чтение, добавление, обновление и удаление записей, смена статусов процесса, комментарии к записям, скачивание вложений. Сервер умеет и администрировать. Он создает приложение в тестовой среде, добавляет поля, правит раскладку формы, переносит настройки в рабочую среду командой `kintone-deploy-app` и создает пространство из шаблона. Вход идет по логину и паролю либо по API-токену, плюс поддерживаются Basic-аутентификация, клиентский сертификат PFX и прокси.
Для кого. Администраторам и разработчикам kintone, которым проще описать правку приложения словами, чем искать нужную настройку в интерфейсе.
Подходит, если
- В приложении сотни записей, и пачку из них надо найти, обновить или удалить по условию.
- Форма приложения обросла лишними полями, и раскладку проще переставить командой агенту.
- Заявки одной выборки переводятся в следующий статус процесса за один проход.
- Из шаблона разворачивается новое пространство с набором приложений для отдела.
Не подходит, если
- Приложения лежат в гостевых пространствах: сервер их не видит.
- К записи нужно прикрепить файл: поле вложения при записи указать нельзя.
- Ждете поддержки по API от Cybozu: локальный MCP-сервер в зону API-поддержки не входит.
Пример запроса к агенту
Найди в приложении «Заявки» записи со статусом «На согласовании» старше двух недель и покажи их таблицей.MCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
KINTONE_BASE_URLобязательная- Базовый адрес среды kintone, например `https://example.cybozu.com`.
KINTONE_USERNAME- Логин. Нужен вместе с `KINTONE_PASSWORD`, если не задан API-токен.
KINTONE_PASSWORDсекрет- Пароль для входа по логину.
KINTONE_API_TOKENсекрет- API-токен, до девяти через запятую. Альтернатива логину и паролю.
KINTONE_ATTACHMENTS_DIR- Папка для скачанных вложений. Без нее `kintone-download-file` возвращает ошибку.
Ограничения
Гостевые пространства не поддерживаются, приложения в них недоступны. Поля вложений при записи указать нельзя, а поля выбора пользователей, организаций и групп заполняются только при заданных вариантах. Скачивание вложений требует `KINTONE_ATTACHMENTS_DIR`, иначе инструмент вернет ошибку. Локальный сервер не входит в зону API-поддержки: ошибки принимают через Issues. Если заданы и пароль, и API-токен, действует пароль.
Как отключить. Удалите запись `kintone` из `.mcp.json` или конфигурации клиента. Расширение Claude Desktop отключается на странице расширений. Выданный API-токен отзовите в настройках приложения kintone.
Частые вопросы
Как подключить kintone MCP Server к Claude Code?
Добавьте в `.mcp.json` запись `kintone` с командой `docker`, образом `ghcr.io/kintone/mcp-server:latest` и переменными `KINTONE_BASE_URL`, `KINTONE_USERNAME`, `KINTONE_PASSWORD`. Пример конфигурации лежит в README. После перезапуска клиента инструменты с префиксом `kintone-` появятся в списке.
Какие данные нужны для входа?
Адрес среды в `KINTONE_BASE_URL` и один из двух вариантов: логин с паролем или API-токен. Токенов можно указать до девяти через запятую. Если заданы оба варианта, сервер берет пароль.
Может ли сервер удалять записи?
Да. Есть `kintone-delete-records`, `kintone-delete-form-fields` и `kintone-delete-space`. Если агент должен только читать, создайте API-токен с правом на просмотр без прав на изменение и удаление.
Как запустить без Docker?
Выполните `npm install -g @kintone/mcp-server`, затем `kintone-mcp-server --base-url https://example.cybozu.com --api-token (token)`. Те же значения принимают переменные окружения.
Работает ли сервер с гостевыми пространствами?
Нет. Приложения внутри гостевых пространств недоступны: для них сервер вернет ошибку доступа.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Apideck: агент работает с более чем 200 бизнес-системами: бухгалтерией, HRIS, CRM и файлами через единый API
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
MCP-сервер Power Platform: 312 инструментов для потоков, приложений, Dataverse и Power Pages, управление обычными словами.
MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
Сторонний MCP-сервер дает ассистенту 101 инструмент для ERP Kingdee Cloud Star: закупки, продажи, склад, финансы и вложения
MCP-сервер и плагин SeldonFrame: агент собирает для клиента сайт, запись, CRM и ИИ-агента одним запросом
Коротко о README
README ведет на японском, есть английская версия. Установка идет тремя путями: пакет MCPB для Claude Desktop, образ Docker и пакет npm. Дальше перечислены параметры входа, 27 инструментов, ограничения и разбор типичных ошибок подключения и прав.