Macrat MCP Server Kintone

🚀 kintoneのMCPサーバ

kintone の Model Context Protocol (MCP) サーバです。このサーバを使用すると、Claude Desktop などのAIツールを使って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
            }
        }
    ]
}

設定パラメータ：

• url：（必須）kintoneドメインのURLです。
• username：（オプション）ログインユーザー名です。
• password：（オプション）ログインパスワードです。
• token：（オプション）ログインに使用するアプリトークンです。
• apps：（必須）アクセスするアプリのリストです。
  • id：（必須）アプリIDです。
  • description：（オプション）AI用のアプリの説明です。
  • permissions：（オプション）AIの権限です。
    • 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%に更新してください。”
• “予定より遅れているプロジェクトを表示してください。”