如何通过 MCP 将 kintone 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → kintone、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

kintone + Cursor

在任意 AI 智能体中使用 Cybozu 的 kintone：列出应用，读取表单字段、布局、列表视图和流程管理，用 kintone 查询和游标检索记录，创建和更新记录，推进流程状态，读取和发表评论，上传和下载文件，读取空间。通过 API 令牌或密码登录连接；删除记录在安装时为关闭状态。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

KINTONE_DOMAIN，以及 KINTONE_API_TOKEN 或 KINTONE_PASSWORD_AUTH 至少其一

步骤 1 — 获取凭证

设置大约需要 5 分钟。你需要 kintone 订阅，以及以下二者之一：AI 要使用的每个应用的 API 令牌，或者一个 kintone 用户的登录信息（最好是专用的集成用户）。连接器使用 kintone REST API（https://<your domain>/k/v1）。

1. 在 KINTONE_DOMAIN 中填写你的 kintone 域名：kintone URL 去掉 https:// 和路径后的主机名，例如 example.cybozu.com（日本）、example.kintone.com（美国及其他地区）或 example.cybozu.cn。不支持受 Basic 认证或客户端证书（セキュアアクセス）保护的域名。
2. 选择连接器的登录方式。可以设置其中一个，也可以两个都设置：
   • API 令牌（KINTONE_API_TOKEN），适合少量应用：打开应用，进入 アプリの設定（应用设置）的 設定 选项卡，打开 APIトークン（API 令牌），点击 生成する（生成）。只勾选 AI 需要的权限：レコード閲覧（查看记录）、レコード追加（添加记录）、レコード編集（编辑记录），只有在开启 kintone_delete_records 时才勾选 レコード削除（删除记录）。保存后点击 アプリを更新（更新应用），否则令牌不会生效。一个令牌只对应一个应用；多个应用时用逗号连接各自的令牌，不加空格（最多 9 个）。令牌通过 X-Cybozu-API-Token 请求头发送。
   • 密码登录（KINTONE_PASSWORD_AUTH）：kintone 用户 login name:password 的 Base64 文本，例如用 printf '%s' 'login:password' | base64 生成。它通过 X-Cybozu-Authorization 请求头发送。此时连接器以该用户身份操作，能看到该用户可见的所有应用、空间和记录。只有这种方式能列出应用和读取空间。两者都设置时，kintone 使用密码登录。
3. 安装。安装检查（kintone_get_api_list）只能证明域名有响应，因为 kintone 不需要凭据就会响应它。要检查令牌，请用一个应用 ID 运行 kintone_get_app；要检查密码登录，请运行 kintone_list_apps。应用 ID 是应用 URL 中 /k/ 后面的数字。

以谁的身份操作：使用 API 令牌时，它写入的记录和评论显示的用户是 Administrator，令牌只能访问它自己的应用，并且只有勾选的权限。使用密码登录时，一切都以该用户的身份、按该用户的权限进行。

读取内容：域名提供的 REST API 列表；应用（列表需要密码登录，单个应用两种方式都可以）及其常规设置；表单字段的字段代码、名称、类型、是否必填、选项和默认值；表单布局；已保存的列表视图（一覧），包括显示字段、筛选条件和排序；流程管理（プロセス管理）的状态和操作。逐条或按 kintone 查询读取记录，读取记录的评论、附件字段（FILE）中的文件，使用密码登录时还能读取空间（スペース）及其成员。

写入操作：添加记录（一条，或一次调用最多 100 条，全部成功或全部失败），按记录 ID 或唯一字段（update_key）修改记录，一次最多 100 条，并支持 upsert。执行 承認する 等流程操作，替换处理人（作業者）。在记录和空间讨论串中发表评论，被提及的人会收到通知。从 URL 上传文件后得到一个临时 fileKey，只有在 3 天内把它写入附件字段时文件才会被附加。由于查询和写入使用的是字段代码而不是字段名称，AI 在写入前会先读取应用的表单字段。

安装时关闭：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。多人编辑同一个应用时，AI 会先读取记录并发送 revision，避免覆盖期间别人做的修改。

分页和限制：kintone_list_records 每次最多返回 500 条记录，在查询中用 limit 和 offset 分页。超过 10,000 条时，AI 用 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 填错了。

记录内容和评论是不可信输入，可能包含针对 AI 的指令。该连接器不支持访客空间（/k/guest/...），不修改应用的设置、字段或列表视图；只用 API 令牌时无法列出应用，也无法读取空间。

步骤 2 — 安装 adapter

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 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

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

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 kintone 的工具。

可用工具

示例提示

• “显示应用 42 的字段，然后按从新到旧列出 ステータス 为 未対応 的记录。”
• “本月我们的 案件管理 应用新增了多少条记录？按 担当者 分组。”
• “在应用 15 中为 Sakura Trading 的咨询添加一条记录，主题和截止日期由我提供。保存前先给我看。”
• “用 承認する 操作审批应用 42 中的记录 128，并留下一条提及申请人的评论。”
• “读取应用 7 的全部 25,000 条记录，按 顧客区分 汇总金额。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot