MCP server for kintone

kintone 的 MCP 服务

用于 kintone 的 Model Context Protocol (MCP) 服务。 该服务允许你使用 Claude Desktop 等 AI 工具探索和操作 kintone 数据！

日语版本：日语说明请参阅 README.ja.md。

2025-08-28 公告 / お知らせ

Cybozu 已发布 官方 kintone MCP 服务！ :tada:
我认为本项目的使命已经完成，因此不会再添加新功能。 请使用并为官方 MCP 服务贡献力量！

サイボウズが公式のkintone MCPサーバーをリリースしました！ :tada:
本プロジェクトの役割は果したと考えますので、今後は新規の機能追加は行いません。 ぜひ公式のMCPサーバーを利用してください！

使用方法

1. 安装

从发布页面下载最新版本。 你可以将可执行文件放在任意位置。

2. 配置 MCP 客户端，例如 Claude Desktop

配置客户端以连接到服务。

对于 Claude Desktop，请编辑以下文件：

• MacOS/Linux: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

将以下配置添加到 mcpServers 部分：

{
  "mcpServers": {
    "kintone": {
      "command": "C:\\path\\to\\mcp-server-kintone.exe",
      "env": {
        "KINTONE_BASE_URL": "https://<domain>.cybozu.com",
        "KINTONE_USERNAME": "<your username>",
        "KINTONE_PASSWORD": "<your password>",
        "KINTONE_API_TOKEN": "<your api token>, <another api token>, ...",
        "KINTONE_ALLOW_APPS": "1, 2, 3, ...",
        "KINTONE_DENY_APPS": "4, 5, ..."
      }
    }
  }
}

环境变量：

• KINTONE_BASE_URL：（必填） kintone 的基础 URL。
• KINTONE_USERNAME：kintone 的用户名。
• KINTONE_PASSWORD：kintone 的密码。
• KINTONE_API_TOKEN：kintone 的 API 令牌，以逗号分隔。 你需要设置 KINTONE_USERNAME 和 KINTONE_PASSWORD，或设置 KINTONE_API_TOKEN。
• KINTONE_ALLOW_APPS：允许访问的应用 ID 列表，以逗号分隔。默认情况下，允许访问所有应用。
• KINTONE_DENY_APPS：禁止访问的应用 ID 列表，以逗号分隔。禁止规则的优先级高于允许规则。

你可能需要重启 Claude Desktop 才能应用更改。

3. 开始使用

现在，你可以使用自己的 AI 工具与 kintone 交互！

例如，你可以这样提问：

• “客户 A 的项目目前最新状态是什么？”
• “将项目 B 的进度更新为 50%。”
• “显示进度落后的项目。”