Macrat MCP Server Kintone

🚀 kintone 的 MCP 服務器

這是 kintone 的 Model Context Protocol (MCP) 服務器。藉助該服務器，您能夠使用 AI 工具（如 Claude Desktop）來探索和操作 kintone 數據！

中文版本：README.zh.md

🚀 快速開始

📦 安裝指南

從 發佈頁面 下載最新版本。您可以將可執行文件放在任何位置。

💻 使用示例

基礎用法

配置 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
            }
        }
    ]
}

配置參數：

⚠️ 重要提示

• 要連接到 kintone，請確保提供 username 和 password 或 token 中的至少一個。
• 請確保所有要訪問的應用都在 apps 列表中。出於安全考慮，此服務器不允許客戶端訪問未包含在 apps 列表中的應用。

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

{
    "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
            }
        }
    ]
}

配置 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 才能使更改生效。

開始使用

現在，您可以使用 AI 工具與 kintone 進行交互了！

例如，您可以這樣說：

• “客戶 A 的項目當前狀態如何？”
• “將項目 B 的進度更新為 50%。”
• “顯示滯後於計劃的項目。”