# Kintone MCP Server

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

## 功能

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

## 快速開始

### 1. 安裝

```bash
npm install -g kintone-mcp-server
```

### 2. 設定

```bash
kintone-mcp-server setup
```

依照互動式引導輸入：
- Kintone 網域 URL（例：`https://example.cybozu.com`）
- API Token（多個逗號分隔）
- 傳輸模式（stdio / http）

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

### 免安裝使用（npx）

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

```json
{
  "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 網頁版）

```bash
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