Claude CodeとKintone連携ガイド【顧客管理・案件管理・日報を自動化する方法】
「Kintoneにデータは入っているのに、分析できていない」
Kintone を導入している多くの中小企業で聞かれる声だ。顧客情報・案件の進捗・日報・在庫管理——データはあるのに、それを「判断に使えるレポート」に変換する仕組みがない。Kintone のレポート機能でグラフを作っているものの、「なぜこうなっているか」という分析は人間が手作業でやっている。
Claude Code と Kintone を連携させると、このギャップを埋められる。Kintone に蓄積されたデータを Claude API に送り、自然言語での分析・要約・提案を生成する。この記事では、その具体的な実装方法を解説する。
1. Kintone REST API の基礎——Kintoneのデータをプログラムで取得する
Kintone REST API とは
Kintone は REST API という仕組みを通じて、外部プログラムからデータの取得・追加・更新ができる。「外部プログラムから Kintone のデータベースを操作する扉」が API だと理解すれば良い。
この API を使うことで「Kintone のデータを取得して Claude に渡す」という流れが実現できる。
API キーの取得方法
Kintone との連携には「API トークン」が必要だ。取得方法は次の通り。
- Kintone 管理者アカウントでログインする
- 対象アプリを開き、右上の「設定」をクリック
- 「API トークン」を選択し、「追加」ボタンをクリック
- 必要な権限(レコードの閲覧・追加・編集など)を設定して保存
- 生成された API トークンをコピーして安全な場所に保管する
このトークンは厳重に管理する。コードに直接書かず、環境変数として管理することが必須だ。
基本的なデータ取得コマンド
以下のコマンドで、Kintone アプリからレコードを取得できる。
curl -X GET \
"https://your-subdomain.cybozu.com/k/v1/records.json?app=1&query=更新日時%20%3E%20%222026-05-01%22" \
-H "X-Cybozu-API-Token: あなたのAPIトークン" \
-H "Content-Type: application/json"
your-subdomain は自社の Kintone サブドメイン、app=1 の 1 はアプリの ID(アプリ設定から確認できる)に置き換える。
2. Kintone と Claude の連携スクリプト
顧客データを取得して Claude に分析させる Python スクリプト
以下のスクリプトは「顧客管理アプリのデータを取得して Claude に渡し、分析コメントを生成する」という処理を実行する。
import os
import requests
import anthropic
import json
# 環境変数から認証情報を取得(コードに直書きしない)
KINTONE_SUBDOMAIN = os.environ["KINTONE_SUBDOMAIN"]
KINTONE_API_TOKEN = os.environ["KINTONE_API_TOKEN"]
KINTONE_APP_ID = os.environ["KINTONE_APP_ID"]
ANTHROPIC_API_KEY = os.environ["ANTHROPIC_API_KEY"]
def get_kintone_records(query=""):
"""Kintone からレコードを取得する"""
url = f"https://{KINTONE_SUBDOMAIN}.cybozu.com/k/v1/records.json"
headers = {
"X-Cybozu-API-Token": KINTONE_API_TOKEN,
"Content-Type": "application/json"
}
params = {
"app": KINTONE_APP_ID,
"query": query,
"totalCount": True
}
response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
return response.json()
def analyze_with_claude(data_text, analysis_prompt):
"""Claude でデータを分析する"""
client = anthropic.Anthropic(api_key=ANTHROPIC_API_KEY)
message = client.messages.create(
model="claude-opus-4-5",
max_tokens=1024,
messages=[
{
"role": "user",
"content": f"{analysis_prompt}\n\n【データ】\n{data_text}"
}
]
)
return message.content[0].text
def main(): # 今月の受注データを取得 records = get_kintone_records( query='更新日時 >= "2026-05-01" and ステータス in ("受注", "商談中")' )
# データをテキスト形式に変換
data_text = json.dumps(records["records"], ensure_ascii=False, indent=2)
# Claude で分析
analysis = analyze_with_claude(
data_text,
"以下は営業管理システムの今月の案件データです。"
"受注状況の傾向・注目すべき案件・営業チームへの提案を箇条書きで分析してください。"
"数値が含まれる場合は具体的な数値を引用してください。"
)
print("=== 今月の案件分析レポート ===")
print(analysis)
if name == "main": main()
このスクリプトを実行すると、Kintone の受注データが取得され、Claude が分析した結果がターミナルに表示される。
---
## 3. 顧客データの自動整理——重複・不整合を検出する
### Kintone の顧客マスタは「汚れやすい」
Kintone を長期間運用していると、顧客マスタの品質が低下していく。担当者が変わるたびに入力の方法が変わり「株式会社」と「(株)」が混在する。同じ会社が名前を少し変えて重複登録される。電話番号・住所が古いまま更新されない——こうした問題が積み重なる。
Claude Code を使って定期的にデータ品質をチェックするスクリプトを作れる。
### データ品質チェックスクリプト
```python
def check_data_quality(records):
"""顧客データの品質問題を Claude に検出させる"""
# レコードのサマリーテキストを作成(個人情報は最小限に)
summary_lines = []
for record in records["records"]:
company = record.get("会社名", {}).get("value", "")
phone = record.get("電話番号", {}).get("value", "")
updated = record.get("更新日時", {}).get("value", "")
summary_lines.append(f"会社名: {company} | 電話: {phone} | 更新日: {updated}")
summary_text = "\n".join(summary_lines)
analysis_prompt = (
"以下は顧客マスタのリストです。"
"以下の観点でデータ品質の問題を検出してください:\n"
"1. 重複していると思われる企業名(例:「株式会社〇〇」と「〇〇株式会社」など)\n"
"2. 電話番号の形式が統一されていない箇所\n"
"3. 1年以上更新されていないレコード(古い情報の可能性)\n"
"具体的な修正候補を箇条書きで出力してください。"
)
return analyze_with_claude(summary_text, analysis_prompt)
このスクリプトを毎月実行することで、データ品質の問題を早期に発見して修正できる。100件のデータなら数秒で分析が完了する。
4. レポート自動生成の実装
日次・週次・月次レポートを自動生成する
営業チームの日報・週次の案件進捗・月次の業績レポートを、Kintone のデータから Claude が自動生成する仕組みを作れる。
import datetime
def generate_daily_report():
"""日次レポートを生成して Kintone に保存する"""
today = datetime.date.today().strftime("%Y-%m-%d")
# 今日の活動データを取得
activities = get_kintone_records(
query=f'日付 = "{today}"'
)
if not activities["records"]:
print("今日の活動データがありません")
return
# データを整形
data_text = format_activities(activities["records"])
# Claude でレポート生成
report = analyze_with_claude(
data_text,
f"{today}の営業活動日報を作成してください。"
"形式:①本日の活動サマリー(3行以内)"
"②商談状況の変化(受注・失注・進展した案件)"
"③明日のアクション提案"
"ビジネスレポートとして読みやすい形式で書いてください。"
)
# レポートを Kintone の日報アプリに保存
save_to_kintone(report, today)
print(f"日報を自動生成しました:{today}")
def save_to_kintone(report_text, date):
"""生成したレポートを Kintone に保存する"""
url = f"https://{KINTONE_SUBDOMAIN}.cybozu.com/k/v1/record.json"
headers = {
"X-Cybozu-API-Token": KINTONE_API_TOKEN,
"Content-Type": "application/json"
}
data = {
"app": "日報アプリのID",
"record": {
"日付": {"value": date},
"AI生成レポート": {"value": report_text},
"ステータス": {"value": "AI生成(要確認)"}
}
}
response = requests.post(url, headers=headers, json=data)
response.raise_for_status()
このスクリプトを定期実行(毎日18時などに cron で実行)すると、営業データから日報が自動生成されて Kintone に保存される。担当者が確認・修正して承認するだけで良い状態になる。
5. 非エンジニアが最初に試すべきこと
「データを貼り付けて Claude に渡す」から始める
スクリプトの実装が難しい場合、まず「Kintone からデータをエクスポートして Claude に渡す」という手動連携から始めることを推奨する。
Kintone では、アプリの一覧画面から CSV 形式でデータをエクスポートできる。このファイルの内容(テキスト)をコピーして Claude に貼り付けて「このデータを分析してください」と依頼するだけで、Claude の分析機能は活用できる。
自動化(スクリプト実装)は「手動でやっていたことを自動で回す」ための次のステップだ。まず手動で「これは使える」と確認してから、自動化に進むのが無駄のない進め方だ。
Kintone のプラグインやノーコードツールとの組み合わせ
プログラミングなしで Kintone と外部サービスを連携する方法として、Make(旧 Integromat)や Zapier などのノーコード連携ツールを使う方法もある。
Make や Zapier には Claude API との連携テンプレートが用意されており、「Kintone に新しいレコードが追加されたら、Claude で分析してメールで送る」といったフローをコードなしで構築できる場合がある。
Kintone と Claude の連携を検討している非エンジニアの担当者は、まずこうしたノーコードツールを試して「どんなことができるか」を確認してから、より高度な自動化(スクリプト実装)に進むのが賢明だ。
6. セキュリティとデータ管理の注意点
Kintone と Claude を連携させる際、特に注意が必要なのはデータのセキュリティだ。
Kintone に蓄積されている顧客情報・取引先情報・従業員情報などは個人情報・機密情報を含む。これらのデータを Claude API(外部サービス)に送信する場合、いくつかの点を確認する必要がある。
まず「Anthropic のデータ利用ポリシー」を確認する。Claude API(Anthropic の API)に送信したデータの取り扱いについて、Anthropic の利用規約・プライバシーポリシーを確認し、自社のデータ管理ポリシーと照合する。
次に「最小限のデータを送る」設計にする。Claude による分析に必要な情報のみを送信し、不要な個人情報は除外する設計にすることで、リスクを最小化できる。
また「社内のセキュリティポリシーとの整合性を確認する」ことも重要だ。外部 API へのデータ送信について、社内の情報セキュリティ担当者・法務担当者に確認した上で導入を進める。
Claude Code道場で学ぶ
KintoneとClaude Codeの連携は、中小企業の業務データを「判断に使える分析」に変える強力な組み合わせです。Kintoneにデータがあるのに活かせていない企業にとって、Claude APIとの連携は顧客管理・案件管理・日報作成の質と効率を同時に向上させる手段になります。
Claude Code道場では、こうした実践的な連携方法を含め、プログラミングの基礎から業務自動化の実装まで全19章で解説しています。期間限定で全章無料公開中です。


