Claude Code × kintone 自動化の実務ガイド｜顧客登録・レポート・他システム連携を爆速化する
Claude Code × kintone MCPを使った業務自動化の実務ガイド。顧客情報の自動登録・月次レポート生成・freee/Salesforceとの自動連携・帳票出力など3つのアプローチと4つのユースケースを解説。
目次 クリックで開く
Claude Code × kintone 自動化の実務ガイド｜顧客登録・レポート・他システム連携を爆速化する
最終更新：2025年5月｜対象：kintoneを業務で使っている非エンジニア〜中級者
「kintoneへの入力が毎日30分かかる」「月次レポートの集計を手作業でやっている」——そんな悩みを、Claude Code × kintone MCPで解決できます。コーディング知識ゼロでも、自然文で指示するだけでkintoneを自在に操作。本記事では3つの連携アプローチと、今日から使えるユースケースを実務レベルで解説します。
Claude Code × kintone 連携でできること
kintoneはAPIが充実しており、外部ツールとの連携に向いています。Claude Codeと組み合わせることで、次のようなことが自然文の指示だけで実現できます。
3つの連携アプローチ — 難易度別に選ぶ
【推奨】kintone MCP を使った自然文操作 — セットアップ手順
最初に試すべきはkintone公式MCPです。セットアップは10分以内に完了します。
-
kintone APIトークンを発行
kintoneの「アプリ設定」→「APIトークン」からアクセス権限（レコード閲覧・追加・編集）を付与したトークンを発行。環境変数に保存しておく。 -
kintone MCP サーバーをインストール
npm install -g @kintone/mcp-server（または公式リポジトリのインストール手順に従う）。 -
Claude Codeの設定ファイルにMCPを追加
~/.claude/claude_desktop_config.jsonまたは.claude/settings.jsonにkintoneエンドポイントとAPIトークンを記載する。 -
CLAUDE.md にkintoneアプリ定義を記載
使用するアプリID・フィールドコード・必須項目をCLAUDE.mdに書いておくと、Claude Codeが毎回確認せずに正確なフィールドマッピングで操作できる。
## kintone アプリ定義
### 顧客管理アプリ（APP_ID: 1）
– 会社名: `company_name`（必須）
– 担当者名: `contact_name`
– メールアドレス: `email`
– 電話番号: `phone`
– ステータス: `status`（リード/商談中/成約/失注）
– 最終コンタクト日: `last_contact`
### 案件管理アプリ（APP_ID: 2）
– 案件名: `project_name`（必須）
– 顧客ID: `customer_id`（ルックアップ: 顧客管理APP）
– 受注金額: `amount`
– 担当営業: `sales_rep`
– 納期: `deadline`
【スクリプト】Python × kintone REST API で大量処理を自動化
MCPが自然文ベースの操作に向いているのに対し、1,000件超のCSV一括取込やバッチ更新にはPythonスクリプトが適しています。Claude Codeに「このCSVをkintoneに登録するスクリプトを書いて」と指示するだけで、以下のようなコードを自動生成してくれます。
import requests, json, os
SUBDOMAIN = os.environ[“KINTONE_SUBDOMAIN”]
APP_ID = “1”
API_TOKEN = os.environ[“KINTONE_API_TOKEN”]
headers = {
“X-Cybozu-API-Token”: API_TOKEN,
“Content-Type”: “application/json”,
}
def add_record(company, contact, email):
payload = {
“app”: APP_ID,
“record”: {
“company_name”: {“value”: company},
“contact_name”: {“value”: contact},
“email”: {“value”: email},
}
}
r = requests.post(
f”https://{SUBDOMAIN}.cybozu.com/k/v1/record.json”,
headers=headers, data=json.dumps(payload)
)
r.raise_for_status()
return r.json()[“id”]
【上級】Webhook ＋ Claude Code でイベント駆動自動化
kintoneのWebhook機能と組み合わせると、レコード保存と同時に外部処理を走らせることができます。たとえば「受注確定」ステータスに変わった瞬間、freeeに請求書を自動作成しSlackに通知、という処理がノーコードで実現できます。
| トリガー | Claude Codeの処理 | 連携先 |
|---|---|---|
| 受注ステータス変更 | 請求書データ生成・送信 | freee API |
| 新規顧客レコード追加 | Salesforceに取引先同期 | Salesforce REST API |
| 案件フェーズ変更 | Slackチャンネルに通知 | Slack Webhook |
| 月末（定期バッチ） | 月次レポートExcel生成・メール送信 | Gmail / Google Drive |
実装の落とし穴と対処法
- APIトークンの権限不足：レコード閲覧のみのトークンで登録・更新しようとしてエラー。アプリ設定でCRUD権限を付与したトークンを再発行する。
- フィールドコードのタイポ：日本語フィールド名ではなくフィールドコード（英数字）を使う必要がある。CLAUDE.mdにコード一覧を記載しておくと防止できる。
- 一括登録の上限：kintone REST APIの一括登録は1回100件まで。1,000件なら10回に分けてループ処理するスクリプトをClaude Codeに生成させる。
- Webhookの非同期タイムアウト：kintoneのWebhookは10秒でタイムアウトする。重い処理はキューに積んでバックグラウンド実行する設計にする。
よくある質問（FAQ）
/k/guest/{spaceId}/v1/）ため、CLAUDE.mdやスクリプト内でパスを明示してください。CRM・営業支援
Salesforce・HubSpot・kintoneの選定から導入・カスタマイズ・定着まで一貫対応。営業生産性を高め、商談化率を改善します。
