适用于 kintone 的 MCP 服务器

适用于 kintone 的 模型上下文协议 (MCP) 服务器。 此服务器允许您使用诸如 Claude Desktop 之类的 AI 工具来探索和操作 kintone 数据！

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

用法

1. 安装

从 发布页面 下载最新版本。 您可以将可执行文件放置在您喜欢的任何位置。

2. 配置 mcp-server-kintone

创建一个如下所示的配置文件：

{
    "url": "https://<your-domain>.cybozu.com",
    "username": "<your-username>",
    "password": "<your-password>",
    "token": "<your-app-token-1>, <your-app-token-2>, ...",
    "apps": [
        {
            "id": "<your-app-id>",
            "description": "<your-app-description>",
            "permissions": {
                "read": true,
                "write": false,
                "delete": false
            }
        }
    ]
}

配置参数：

• url：（必需）您的 kintone 域的 URL。

• username：（可选）用于登录的用户名。

• password：（可选）用于登录的密码。

• token：（可选）用于登录的 App Token。

• apps：（必需）您想要访问的 App 列表。

  • id：（必需）App ID。
  • description：（可选）用于 AI 的 App 描述。
  • permissions：（可选）用于 AI 的权限。
    • read：（可选）读取权限。默认为 true。
    • write：（可选）写入权限。默认为 false。
    • delete：（可选）删除权限。默认为 false。

注意：

• 要连接到 kintone，至少需要 username 和 password 或 token 之一。

• 请确保您要访问的所有 App 都包含在 apps 列表中。 出于安全原因，此服务器不允许客户端访问未包含在 apps 列表中的 App。

例如，您的配置文件应如下所示：

{
    "url": "https://example.cybozu.com",
    "username": "alice",
    "password": "password",
    "apps": [
        {
            "id": "1",
            "description": "一个存储客户信息的应用程序。它包含负责人姓名和联系方式。",
            "permissions": {
                "read": true,
                "write": false,
                "delete": false
            }
        },
        {
            "id": "2",
            "description": "一个存储项目信息的应用程序。它包含项目的概述及其进度。",
            "permissions": {
                "read": true,
                "write": true,
                "delete": false
            }
        }
    ]
}

3. 配置 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",
      "args": [
        "C:\\path\\to\\configuration.json"
      ]
    }
  }
}

您可能需要重新启动 Claude Desktop 才能应用更改。

4. 开始使用

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

例如，您可以说：

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