kintone 用 MCP 服务器示例

这是一个可以用于与 kintone 集成的 Model Context Protocol (MCP) 服务器的简单示例。
这里提供的是使用生成AI自动创建的内容，按照当前状态提供。

通过使用此 MCP 服务器，可以从 Claude Desktop 应用程序访问和更新 kintone 数据。

如果要将 Claude 桌面应用程序作为客户端使用，则需要 Claude Pro 订阅计划。
也可以在 Windsurf 或 CLINE 中使用。

使用方法

1. 下载源代码

下载位置不限，但建议放在只包含半角英文数字、不含空格的路径下。

2. 安装 Node.js

请使用 Node.js 18 或更高版本。

3. 运行 npm install

npm i

4. 编辑 Claude Desktop 应用程序配置文件

找到名为 claude_desktop_config.json 的配置文件，并参考以下内容，在该文件的 "mcpServers" 条目中添加设置。

{
  "mcpServers": {
    "kintone": {
      "command": "node",
      "env": {
        "KINTONE_DOMAIN": "[あなたが使用するサブドメイン].cybozu.com",
        "KINTONE_USERNAME": "MCP接続で使用するkintoneユーザー名",
        "KINTONE_PASSWORD": "kintoneユーザーのパスワード（平文）"
      },
      "args": [
        "[kintone-mcp-serverを配置したパス]/server.js"
      ]
    }
  }
}

5. 重启 Claude Desktop 应用程序

保存对 claude_desktop_config.json 的更改后，请先关闭再重新启动 Claude Desktop 应用程序。有时即使看起来应用程序已经关闭，它也可能仍在后台运行，因此请右键点击驻留图标选择退出来确保完全关闭。

6. 功能验证

首先试着让 Claude 查询 "kintone应用「设置可访问的kintone用户名下的一个应用名示例」的应用ID是多少？"。
此处输入的 kintone 应用名称必须一字不差地准确指定。

7. 此 MCP 服务器提供的功能列表

有关各工具注释属性的详细信息，请参阅 docs/tool-annotations.md。

记录操作

• get_record: 获取 kintone 应用中的单条记录
• search_records: 在 kintone 应用中搜索记录
• create_record: 在 kintone 应用中创建新记录
• update_record: 更新 kintone 应用中的现有记录
• add_record_comment: 向 kintone 记录添加评论

文件操作

• upload_file: 向 kintone 上传文件
• download_file: 从 kintone 下载文件（注意：目前实现可能无法正常下载超过 1MB 的文件）

应用信息

• get_apps_info: 根据关键词获取多个匹配的 kintone 应用的信息
• get_form_layout: 获取 kintone 应用的表单布局
• get_app_actions: 获取 kintone 应用的应用动作设置
• get_app_plugins: 获取已添加到 kintone 应用中的插件列表

应用操作

• create_app: 创建新的 kintone 应用
• add_fields: 向 kintone 应用添加字段
• update_field: 更新现有的 kintone 字段设置
• update_form_layout: 更改 kintone 应用的表单布局
• update_app_settings: 修改应用的一般设置
• deploy_app: 开始 kintone 应用的正式运营（反映到生产环境）
• get_deploy_status: 确认应用设置反映到生产环境的状态
• move_app_to_space: 将 kintone 应用移动到指定空间
• move_app_from_space: 取消 kintone 应用的空间归属

空间操作

• get_space: 获取空间的一般信息
• update_space: 更新空间设置
• update_space_body: 更新空间正文
• get_space_members: 获取空间成员列表
• update_space_members: 更新空间成员
• add_thread: 向空间添加线程
• update_thread: 更新线程
• add_thread_comment: 向线程添加评论
• add_guests: 添加访客用户
• update_space_guests: 更新空间访客成员

用户与组信息

• get_users: 获取 kintone 的用户信息
• get_groups: 获取 kintone 的组信息
• get_group_users: 获取指定组内的用户列表

kintone 连接信息

• get_kintone_domain: 获取 kintone 的连接域名
• get_kintone_username: 获取用于连接 kintone 的用户名

8. 其他

关于如何利用这个 MCP 服务器进行更多操作，我在博客中有所介绍，请阅读参考。

此外，还有其他为 kintone 提供的 MCP 服务器可供参考，您也可以尝试自己创建原创的 MCP 服务器。

「kintone」是サイボウズ株式会社的注册商标。

此处记载的内容旨在提供信息，我们无法提供个别支持。
对于设置内容的问题或您环境中无法运行等问题的咨询，我们无法进行处理，请您理解。