Как подключить kintone к ChatGPT через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → kintone, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

kintone + ChatGPT

Работайте с kintone от Cybozu из любого AI-агента: список приложений, поля формы, макеты, представления и управление процессами, поиск записей запросами kintone и курсорами, создание и изменение записей, перевод записей по статусам процесса, чтение и публикация комментариев, загрузка и скачивание файлов, чтение пространств. API-токен или вход по паролю; удаление записей при установке выключено.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

KINTONE_DOMAIN и хотя бы одна из KINTONE_API_TOKEN или KINTONE_PASSWORD_AUTH

Шаг 1 — Получите учётные данные

Настройка занимает около 5 минут. Нужна подписка kintone и либо API-токен для каждого приложения, с которым будет работать ИИ, либо логин пользователя kintone, лучше отдельного пользователя для интеграции. Коннектор использует kintone REST API (https://<your domain>/k/v1).

1. Укажите домен kintone в KINTONE_DOMAIN: хост вашего URL kintone без https:// и без пути, например example.cybozu.com (Япония), example.kintone.com (США и другие регионы) или example.cybozu.cn. Домены за Basic-аутентификацией или клиентскими сертификатами (セキュアアクセス) не поддерживаются.
2. Выберите способ входа. Можно задать один или оба:
   • API-токен (KINTONE_API_TOKEN), удобен для нескольких приложений: откройте приложение, アプリの設定 (настройки приложения), вкладка 設定, APIトークン (API-токен), 生成する (создать). Отметьте только то, что нужно ИИ: レコード閲覧 (просмотр записей), レコード追加 (добавление), レコード編集 (изменение) и レコード削除 (удаление), только если вы включите kintone_delete_records. Сохраните и затем нажмите アプリを更新 (обновить приложение), иначе токен останется неактивным. Один токен действует для одного приложения; для нескольких приложений перечислите токены через запятую без пробелов (до 9). Токен передаётся в заголовке X-Cybozu-API-Token.
   • Вход по паролю (KINTONE_PASSWORD_AUTH): строка Base64 от login name:password пользователя kintone, например из printf '%s' 'login:password' | base64. Передаётся в заголовке X-Cybozu-Authorization. Коннектор тогда действует от имени этого пользователя и видит все приложения, пространства и записи, доступные ему. Только так можно получить список приложений и читать пространства. Если заданы оба способа, kintone использует вход по паролю.
3. Установите коннектор. Проверка при установке (kintone_get_api_list) лишь подтверждает, что домен отвечает, потому что kintone отвечает на неё без учётных данных. Чтобы проверить токен, вызовите kintone_get_app с ID приложения, а для входа по паролю kintone_list_apps. ID приложения это число после /k/ в URL приложения.

От чьего имени он действует: с API-токеном записи и комментарии, которые он создаёт, показывают пользователя Administrator, а токен достаёт только до своего приложения и только с отмеченными правами. При входе по паролю всё происходит от имени этого пользователя и с его правами.

Что он читает: REST API, которые предлагает домен; приложения (список требует входа по паролю, отдельное приложение доступно обоими способами) и их общие настройки; поля формы с кодом, названием, типом, обязательностью, вариантами и значениями по умолчанию; макет формы; сохранённые представления (一覧) с полями, фильтром и сортировкой; управление процессами (プロセス管理) со статусами и действиями. Записи по одной или по запросу kintone, комментарии к записи, файлы из полей FILE, а при входе по паролю пространства (スペース) и их участников.

Что он записывает: добавляет записи (одну или до 100 за один вызов по принципу «всё или ничего») и меняет записи по ID или по уникальному полю (update_key), до 100 за раз и с upsert. Выполняет действия процесса, например 承認する, и заменяет исполнителей (作業者). Публикует комментарии к записям и в ветках пространств, с упоминаниями, которые уведомляют упомянутых. Загружает файл по URL и получает временный fileKey, который прикрепляется, только если в течение 3 дней записать его в поле FILE. Перед записью ИИ читает поля формы приложения, потому что запросы и запись используют коды полей, а не названия.

Выключено при установке: kintone_delete_records. В kintone нет корзины, удалённые записи и их комментарии восстановить нельзя. Администратор включает инструмент, когда он нужен команде; токену тогда нужно и право レコード削除.

Запросы: коды полей, а не названия, с =, !=, >, <, >=, <=, in ("a", "b"), not in и like "text" (текстовые поля), соединённые через and / or, затем order by field asc|desc, limit n (не больше 500) и offset n (не больше 10 000). Даты выглядят как "2026-10-30", дата и время указываются в UTC как "2026-10-30T00:00:00Z", работают функции TODAY(), THIS_MONTH(), LAST_WEEK() и LOGINUSER(). Значения выпадающих списков, переключателей и статусов должны точно совпадать с текстом варианта, например ステータス in ("完了"). Фильтр сохранённого представления можно повторно использовать как запрос.

Форматы данных: каждое поле приходит как {"type": ..., "value": ...}. Числа и вычисляемые значения передаются строками, дата и время в UTC, $id это ID записи, $revision её версия. Значения USER_SELECT и CREATOR имеют вид {code, name} с логином в code. Значения FILE содержат fileKey, name, contentType и size. Если одно приложение редактируют несколько человек, ИИ сначала читает запись и передаёт revision, чтобы не затереть чужое изменение.

Пагинация и лимиты: kintone_list_records возвращает до 500 записей за вызов, с limit и offset внутри запроса. Для более чем 10 000 записей ИИ открывает курсор через kintone_create_cursor, читает через kintone_get_cursor_records, пока next не станет false, и при необходимости закрывает его раньше через kintone_delete_cursor. Курсор живёт 10 минут, на домен одновременно допускается 10 курсоров. kintone разрешает 10 000 запросов на приложение в день и 100 параллельных запросов на домен; массовая запись и удаление принимают до 100 записей, комментарии приходят по 10 за вызов, kintone_list_apps возвращает до 100 приложений за вызов.

Частые ошибки: kintone отвечает полями code, message и, при ошибках ввода, errors по каждому полю. CB_VA01 означает неверный ввод, например неверный код поля, неправильную дату или пустое обязательное поле: errors укажет, какое. CB_NO02 значит, что у токена или пользователя нет права или токен принадлежит другому приложению. CB_WA01 это неудачный вход по паролю. Токен, после создания которого никто не нажал アプリを更新, не активен. HTML-страница 404 обычно означает неверный KINTONE_DOMAIN.

Содержимое записей и комментариев является недоверенным вводом и может содержать инструкции для ИИ. Коннектор не работает с гостевыми пространствами (/k/guest/...), не меняет настройки, поля и представления приложений, а с одними API-токенами не может получить список приложений и читать пространства.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в ChatGPT

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.

1. Перейди на chatgpt.com/plugins, нажми Add, затем Add custom MCP server.
2. Введи название, например Name: kintone.
3. В разделе Connection укажи в поле Server URL адрес https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID и оставь Authentication на OAuth.
4. Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
5. Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.

Доступные инструменты

Примеры запросов

• «Покажи поля приложения 42, а затем список записей со ステータス 未対応, сначала новые.»
• «Сколько записей добавлено в этом месяце в наше приложение 案件管理? Сгруппируй их по 担当者.»
• «Добавь в приложение 15 запись по запросу от Sakura Trading с темой и сроком, которые я дам. Покажи её до сохранения.»
• «Утверди запись 128 в приложении 42 действием 承認する и оставь комментарий с упоминанием заявителя.»
• «Прочитай все 25 000 записей приложения 7 и посчитай общую сумму по 顧客区分.»

FAQ

Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot