Kintone MCP Server

透過 Claude Desktop 或 claude.ai 以自然語言直接操作 Kintone 資料。

功能

• 列出所有 App
• 取得欄位定義
• 查詢記錄（關鍵字 / Query 語法）
• 統計記錄筆數
• 新增記錄
• 批次更新記錄

快速開始

1. 安裝

npm install -g kintone-mcp-server

2. 設定

kintone-mcp-server setup

依照互動式引導輸入：

• Kintone 網域 URL（例：https://example.cybozu.com）
• API Token（多個逗號分隔）
• 傳輸模式（stdio / http）

設定完成後重新啟動 Claude Desktop 即可使用。

免安裝使用（npx）

不安裝也能直接使用，在 Claude Desktop 設定檔中填入：

{
  "mcpServers": {
    "kintone": {
      "command": "npx",
      "args": ["-y", "kintone-mcp-server"],
      "env": {
        "KINTONE_BASE_URL": "https://your-domain.cybozu.com",
        "KINTONE_API_TOKEN": "your-api-token"
      }
    }
  }
}

使用方式

設定完成後，在 Claude 對話中直接用自然語言操作：

• 「列出所有 Kintone App」
• 「查看 App 10 的欄位結構」
• 「搜尋客戶名稱包含『台灣』的記錄」
• 「在 App 10 新增一筆記錄」

HTTP 模式（claude.ai 網頁版）

kintone-mcp-server setup   # 選擇 http 模式
npm run start:http          # 啟動伺服器

在 claude.ai 設定 MCP Server URL：http://your-server:3100/mcp

系統需求

• Node.js 18+
• Kintone API Token（需有對應 App 權限）

環境變數

變數	說明	預設值
KINTONE_BASE_URL	Kintone 網域 URL（必填）	—
KINTONE_API_TOKEN	API Token（必填）	—
MCP_TRANSPORT	傳輸模式：stdio / http	stdio
MCP_HTTP_PORT	HTTP 埠號	3100

License

MIT