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 に渡す」という流れが実現できる。Kintone以外の外部システムとの連携パターンはClaude CodeのAPIを使った外部システム連携ガイドでも整理している。

API キーの取得方法

Kintone との連携には「API トークン」が必要だ。取得方法は次の通り。

1. Kintone 管理者アカウントでログインする
2. 対象アプリを開き、右上の「設定」をクリック
3. 「API トークン」を選択し、「追加」ボタンをクリック
4. 必要な権限（レコードの閲覧・追加・編集など）を設定して保存
5. 生成された 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 を使って定期的にデータ品質をチェックするスクリプトを作れる。

データ品質チェックスクリプト

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件のデータなら数秒で分析が完了する。営業データを扱う場合はSalesforceとの連携方法を解説したClaude CodeとSalesforce・CRM連携ガイドも参考になる。

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 で分析してメールで送る」といったフローをコードなしで構築できる場合がある。同様にノーコードで議事録・タスク管理を自動化したい場合はClaude CodeでNotionを自動操作する方法も参考になる。

Kintone と Claude の連携を検討している非エンジニアの担当者は、まずこうしたノーコードツールを試して「どんなことができるか」を確認してから、より高度な自動化（スクリプト実装）に進むのが賢明だ。

6. セキュリティとデータ管理の注意点

Kintone と Claude を連携させる際、特に注意が必要なのはデータのセキュリティだ。

Kintone に蓄積されている顧客情報・取引先情報・従業員情報などは個人情報・機密情報を含む。これらのデータを Claude API（外部サービス）に送信する場合、いくつかの点を確認する必要がある。

まず「Anthropic のデータ利用ポリシー」を確認する。Claude API（Anthropic の API）に送信したデータの取り扱いについて、Anthropic の利用規約・プライバシーポリシーを確認し、自社のデータ管理ポリシーと照合する。

次に「最小限のデータを送る」設計にする。Claude による分析に必要な情報のみを送信し、不要な個人情報は除外する設計にすることで、リスクを最小化できる。

また「社内のセキュリティポリシーとの整合性を確認する」ことも重要だ。外部 API へのデータ送信について、社内の情報セキュリティ担当者・法務担当者に確認した上で導入を進める。企業でのセキュリティ運用の考え方全般は企業でClaude Codeを使うときのセキュリティ対策にまとめている。

Claude Code道場で学ぶ

KintoneとClaude Codeの連携は、中小企業の業務データを「判断に使える分析」に変える強力な組み合わせです。Kintoneにデータがあるのに活かせていない企業にとって、Claude APIとの連携は顧客管理・案件管理・日報作成の質と効率を同時に向上させる手段になります。

Claude Code道場では、こうした実践的な連携方法を含め、プログラミングの基礎から業務自動化の実装まで全20章で解説しています。期間限定で全章無料公開中です。

今すぐ無料で学ぶ