本文へスキップ

ClaudeでkintoneをAI操作する方法|公式MCPで「いちばん簡単な入口」から自然文で動かす

Claude Desktop と kintone の公式MCPサーバーをつなぐと、Claudeへの自然文の指示だけでkintoneを動かせます。たとえば、次のような操作を会話で頼めます。

  • 「先月の受注レコードを金額の多い順で見せて」とレコードを検索・取得する
  • 「この内容で新しい問い合わせレコードを登録して」とレコードを追加する
  • 「今月の案件を担当者ごとに集計して要約レポートにして」と取得データをまとめる

いちばん簡単な入口は、拡張機能ファイルをClaude Desktopにドラッグ&ドロップする1手順だけです。まずはこの方法で接続し、実際に動かすところまでを先に説明します。

他の導入方法(Docker・npm)や、認証・トラブル対応・セキュリティの詳しい設定は、記事の後半にまとめました。構成を細かく管理したい方は、あわせてご覧ください。

前提(準備するもの)

  • kintone 環境(例:https://<subdomain>.cybozu.com)
  • Claude Desktop(mac/Win/Linux)※他のAI(GeminiやChatGPT)での利用は確認しておりません。
  • 認証情報:ユーザー名+パスワード もしくは APIトークン(必要最小権限でOK)
  • (Docker方式を使う場合)Docker が動く環境
  • (npm方式を使う場合)Node.js v18+(推奨 v20+)

最短の入口:拡張機能ファイルをドラッグ&ドロップするだけ(.mcpb)

Claude Desktop の「拡張機能」に .mcpb をドラッグ&ドロップするだけ。

  1. GitHubのリリースから kintone-mcp-server.mcpb をダウンロード
  2. Claude Desktop を開き、設定 → デスクトップアプリ → 拡張機能 を表示
  3. ダウンロードした .mcpb をウィンドウにドラッグ&ドロップ → インストール
  4. 表示される設定ダイアログで以下を入力して保存
    • Kintone Base URL:例 https://example.cybozu.com
    • Kintone Username / Password または API Token
  5. 新規チャットを作成し、ツールに kintone が見えればOK

※kintone公式ページはこちら

動作確認の例

  • 「kintone のアプリ一覧を取得して」
  • 「アプリID=○○ の最新5件を表示して」

Claudeに自然文で頼める主な操作

  • kintone-get-apps/kintone-get-app:アプリ情報の取得
  • kintone-get-form-fields/kintone-get-form-layout:フィールド・レイアウト取得
  • kintone-get-records/kintone-add-records/kintone-update-records/kintone-delete-records
  • kintone-update-statuses:レコードのプロセス管理ステータス更新
  • kintone-download-file:添付ファイル保存(保存先ディレクトリの指定が必要)

他の導入方法(Docker・npm)

構成ファイルで導入・管理したい場合は、次の2つの方法も使えます。各手順の中身はこれまでと同じです。

Docker(設定ファイルで管理したい人向け)

Claudeが stdio でコンテナを起動する構成。資格情報は環境変数として渡す。

  1. 画像を起動
docker run -i --rm \



  -e KINTONE_BASE_URL=https://example.cybozu.com \



  -e KINTONE_USERNAME=<username> \



  -e KINTONE_PASSWORD=<password> \



  ghcr.io/kintone/mcp-server:latest



  1. Claudeの設定ファイルを編集(mac:~/Library/Application Support/Claude/claude_desktop_config.json)
{



  "mcpServers": {



    "kintone": {



      "type": "stdio",



      "command": "docker",



      "args": [



        "run","-i","--rm",



        "-e","KINTONE_BASE_URL",



        "-e","KINTONE_USERNAME",



        "-e","KINTONE_PASSWORD",



        "ghcr.io/kintone/mcp-server:latest"



      ],



      "env": {



        "KINTONE_BASE_URL": "https://example.cybozu.com",



        "KINTONE_USERNAME": "<username>",



        "KINTONE_PASSWORD": "<password>"



      }



    }



  }



}



  1. Claude を再起動→新規チャットで kintone ツールを選ぶ

APIトークン認証も可:KINTONE_API_TOKEN を設定(カンマ区切りで最大9個)。ユーザー名/パスワードと同時指定時はパスワード認証が優先。

npm(グローバル導入して使う)

  1. インストール
npm install -g @kintone/mcp-server



  1. 手動起動(デバッグ向け)
kintone-mcp-server \



  --base-url https://example.cybozu.com \



  --username <username> \



  --password <password>



  1. Claudeの設定に command と args で同等指定(Docker例を command: "kintone-mcp-server" に置き換え)

認証・ネットワークのオプション

  • Basic認証:KINTONE_BASIC_AUTH_USERNAME / KINTONE_BASIC_AUTH_PASSWORD
  • プロキシ:HTTPS_PROXY=http://proxy.example.com:8080
  • クライアント証明書(PFX):KINTONE_PFX_FILE_PATH / KINTONE_PFX_FILE_PASSWORD
  • 添付ダウンロード先:KINTONE_ATTACHMENTS_DIR(kintone-download-file を使う際は必須)

トラブルシューティング

  • ツールが出てこない:JSONの末尾カンマやクォートを確認 → Claudeを完全再起動
  • 認証で失敗:Base URL のスペル(https://<subdomain>.cybozu.com)と認証方式(ユーザー/パス or APIトークン)を見直し
  • ゲストスペース非対応:ゲストスペースのアプリにはアクセス不可(制限仕様)
  • 添付の保存エラー:kintone-download-file は KINTONE_ATTACHMENTS_DIR の指定が必須

セキュリティと権限

  • 本番ではAPIトークン認証+最小権限を推奨(読み取り専用→書き込み系は別トークン)
  • 監査のため、kintone側に**実行ログ(日時/実行ID/操作内容)**を残す設計にすると安全

まとめ

  • ドラッグ&ドロップ(.mcpb)なら最短接続、Docker/npmなら構成管理しやすい
  • 主要操作(取得・追加・更新・削除・ステータス更新・添付DL)は標準ツールでカバー
  • 認証はユーザー/パス or APIトークン。プロキシや証明書にも対応
  • AIを通して自然言語でkintoneアプリに対する操作が行える

最後に

ライブAI開発の案内

株式会社アディエムでは、kintone × 生成AIで日々の業務改善に取り組んでいます。
今回ご紹介したような例の他にも、お客様の業務に合った改善をご提案させて頂きます。
無料相談も実施しておりますので、お気軽にお問い合わせ頂ければ幸いです。

お問い合わせはこちら

関連記事