适合谁
- 已在使用 kintone 平台并希望通过 AI 助手操作应用与记录的团队
- 需要批量维护 kintone 字段、表单或常规设置的管理员
- 希望用自然语言驱动 kintone REST API 操作的开发者
K
53FMRS · D
kintone MCP Server 是 Cybozu 官方维护的开源（Apache-2.0）本地 MCP 服务器，通过 kintone REST API 提供应用、字段、表单、记录、空间等约 25 个管理工具，支持 MCPB、Docker、npm 三种安装方式及多种认证方式，但不支持访客空间，且明确不在官方 API 支持范围内，问题需通过 GitHub Issues 处理。
由 Cybozu 官方维护的 kintone 本地 MCP 服务器，通过 kintone REST API 连接。提供应用与表单管理、记录的增删改查、流程管理、空间管理及附件下载等能力。支持通过 MCPB 包（Claude Desktop 扩展）、Docker 镜像或 npm 包三种方式安装，可使用用户名密码、API 令牌、Basic 认证或客户端证书进行身份验证。
工具能力
kintone-get-apps
获取多个应用的信息
kintone-get-app
获取单个应用的详细信息
kintone-get-form-fields
获取应用的字段设置
kintone-get-form-layout
获取应用的表单布局
kintone-update-form-fields
更新应用的字段设置
kintone-update-form-layout
更新应用的表单布局
kintone-delete-form-fields
删除应用的字段
kintone-get-process-management
获取流程管理设置
kintone-get-app-deploy-status
确认应用设置向正式环境的反映状态
kintone-get-general-settings
获取应用的常规设置
kintone-add-form-fields
向应用添加字段
kintone-get-records
获取多条记录
kintone-add-records
添加多条记录
kintone-update-records
更新多条记录
kintone-delete-records
删除多条记录
kintone-update-statuses
更新多条记录的状态
kintone-get-record-comments
获取记录的评论
kintone-add-record-comment
向记录添加评论
kintone-add-app
在测试环境中创建应用
kintone-deploy-app
将应用设置反映到正式环境
kintone-update-general-settings
更改应用的常规设置
kintone-download-file
保存附件字段中的文件
kintone-add-space-from-template
根据模板创建空间
kintone-update-space
更新空间设置
kintone-get-space
获取空间信息
kintone-delete-space
删除空间
安装接入
1) MCPB 方式：从 GitHub Releases 下载 kintone-mcp-server.mcpb，拖入 Claude Desktop「扩展程序」页面安装，并在弹出的配置对话框中填写 kintone 的 Base URL、用户名和密码。2) Docker 方式：需先安装 Docker，执行 docker run -i --rm -e KINTONE_BASE_URL=... -e KINTONE_USERNAME=... -e KINTONE_PASSWORD=... ghcr.io/kintone/mcp-server，或在客户端的 mcp.json 中配置 stdio 命令。3) npm 方式：npm install -g @kintone/mcp-server 后运行 kintone-mcp-server --base-url ... --username ... --password ...（也可用对应环境变量）。
claude_desktop_config.json
{"mcpServers":{"kintone":{"type":"stdio","command":"docker","args":["run","-i","--rm","-e","KINTONE_BASE_URL","-e","KINTONE_USERNAME","-e","KINTONE_PASSWORD","ghcr.io/kintone/mcp-server:latest"],"cwd":"${cwd}","env":{"KINTONE_BASE_URL":"https://example.cybozu.com","KINTONE_USERNAME":"username","KINTONE_PASSWORD":"password"}}}}
选型与风险
不适合谁
- 未使用 kintone 平台的用户
- 需要访问 kintone 访客空间（guest space）内应用的场景（不支持）
- 需要在记录中直接指定附件字段内容的批量导入场景（不支持）
所需权限
- kintone 登录用户名和密码，或 API 令牌（最多 9 个，逗号分隔）
- 可选的 Basic 认证用户名和密码
- 可选的客户端证书（PFX 文件及密码），用于安全访问域名
- 对应用的具体访问权限取决于所用账号/令牌被授予的『查看』『新增』『编辑』『删除』等 kintone 权限
风险与副作用
- 该服务器可直接调用 kintone REST API 增删改记录、字段和应用设置，操作错误可能导致业务数据丢失或应用配置被破坏
- 凭据（密码、API 令牌、客户端证书密码）通过命令行参数或环境变量传递，需妥善保管配置文件与环境变量，避免泄露
- 不支持访客空间应用，若业务依赖访客空间可能出现权限或访问异常
- 官方声明该服务器不在 kintone API 官方支持窗口范围内，出现问题需通过 GitHub Issues 反馈
常见排障
- 连接错误：检查 Base URL 是否正确（如 https://example.cybozu.com），如处于代理环境需设置 HTTPS_PROXY 环境变量，短暂无法连接可稍后重试
- 认证错误：核对用户名密码是否正确；不要同时指定用户名密码与 API 令牌，同时指定时密码认证优先；使用客户端证书时确认域名为安全访问域名（如 .s.cybozu.com）
- 权限错误：确认所用用户或 API 令牌对目标应用具备相应权限（应用管理权限或记录查看权限等）；确认目标应用不在访客空间内；使用 API 令牌时确认已授予所需的『查看』『新增』『编辑』『删除』权限
- 使用 kintone-download-file 工具前，必须通过 --attachments-dir 或 KINTONE_ATTACHMENTS_DIR 指定保存目录，否则执行会报错；若目录不存在会自动创建
使用场景
让 AI 助手查询和汇总 kintone 应用中的记录数据
批量新增、更新或删除 kintone 记录
管理 kintone 应用的字段、表单布局及常规设置
将应用配置从测试环境部署到正式环境
创建和管理 kintone 空间及记录评论
支持客户端
Claude Desktop完整支持
Claude Code部分支持
Cursor部分支持