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

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

kintone + Cursor

Работайте с 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 — Добавьте коннектор в Cursor

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

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты kintone.

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

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

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

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

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

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