Claude Code × API連携で業務システムを自動化する方法｜freee・HubSpot・Slackの実践例

「営業がHubSpotに受注データを入力したら、freeeに自動で請求書を作成し、Slackで経理チームに通知する」。こうした部門横断のワークフロー自動化を実現するのが、Claude Code × API連携です。

従来、複数の業務システムを連携するにはiPaaS（Integration Platform as a Service）の導入や、専門エンジニアによるAPI連携開発が必要でした。Zapierやn8nといったツールは使いやすい反面、複雑なビジネスロジックの実装には限界があり、月額費用も高額になりがちです。

Claude Codeは、自然言語の指示だけでAPIを呼び出すコードを生成・実行できるため、CDOやDX推進担当者が自らシステム連携を構築できます。本記事では、freee・HubSpot・Slackを中心に、Claude Code × API連携の実践パターンを解説します。

この記事でわかること

• Claude CodeでAPIを呼び出すコードを生成・実行する基本的な流れ
• freee APIとの連携による会計業務の自動化パターン
• HubSpot APIとの連携によるCRM運用の効率化事例
• Slack APIとの連携による通知・レポートの自動化方法
• 複数APIを組み合わせたクロスサービス自動化の設計思想

Claude Code × API連携の基本アーキテクチャ

なぜClaude CodeでAPI連携を行うのか

API連携を構築する手段はいくつかありますが、Claude Codeが特に有効な場面は以下の通りです。

プロトタイプの高速構築: 「この2つのシステムを連携できるか試したい」という検証段階で、Claude Codeに日本語で指示するだけでAPIクライアントが生成され、即座に動作検証ができます。

複雑なビジネスロジックの実装: iPaaSツールでは対応しにくい条件分岐、データ変換、エラーハンドリングのロジックを、Claude Codeが適切なコードとして実装します。

既存コードの理解と拡張: レガシーシステムのAPIドキュメントが不十分な場合でも、Claude CodeがAPIのレスポンスを解析し、連携コードを生成できます。

MCP経由とAPI直接呼び出しの違い

Claude Codeから外部サービスに接続する方法は、大きく2つあります。

MCP経由: MCPサーバーを設定すると、Claude Codeが自動的にサービスのAPIを認識し、自然言語の指示だけでデータの取得・更新ができます。設定後は「HubSpotの取引一覧を取得して」と指示するだけで操作が完了します。

API直接呼び出し: Claude Codeにコードを生成させ、REST APIを直接呼び出す方法です。MCPサーバーが存在しないサービスや、MCPでは対応していない細かなAPIエンドポイントにアクセスする場合に使用します。

実務では、主要サービス（HubSpot・freee・Slack等）はMCPで接続し、MCPでカバーできない処理はAPI直接呼び出しで補完するハイブリッド構成が効果的です。

MCPの詳細な設定手順と活用パターンで、MCP連携の具体的な方法を解説しています。

freee API連携：会計業務の自動化

取引データの自動登録

freee APIを利用して、他システムの受注データから会計取引を自動登録するパターンです。HubSpotで取引が「受注」ステージに移行したタイミングで、freeeに売上取引を自動作成します。

Claude Codeに「HubSpotの受注データからfreeeの取引を作成するスクリプトを書いて」と指示すれば、以下の処理を含むコードが生成されます。

• HubSpot APIから取引データ（金額・取引先・商品）を取得
• freeeの勘定科目・取引先マスタとのマッピング
• freee APIで取引の登録（借方：売掛金、貸方：売上高）
• 登録結果のログ出力とエラーハンドリング

freeeのAPIは、事業所ID・勘定科目ID・取引先IDなどの内部IDを使用するため、事前にマスタデータの対応表を作成しておく必要があります。Claude Codeでマッピングテーブルの作成も自動化できます。

請求書の自動発行

受注データをもとに、freee APIで請求書を自動発行するパターンです。

HubSpotのQuote（見積もり）が承認されたら、その内容をfreeeの請求書フォーマットに変換し、APIで請求書を作成します。商品名・数量・単価・税率の情報はHubSpotのLine Itemsから取得し、freeeの品目マスタとマッピングします。

Sansan株式会社は、freee APIとCRMを連携させることで、請求書発行の手動作業を月40時間削減した事例を公開しています。同様の連携をClaude Codeで構築する場合、開発期間を大幅に短縮できます。

経費データの集計・分析

freee APIから取引データをエクスポートし、Claude Codeで分析するパターンです。「今月の経費を勘定科目別に集計して、前年同月比を計算して」と指示すれば、APIからデータを取得し、集計表とグラフを生成します。

月次決算のスピードアップや、予算実績対比レポートの自動生成に活用できます。

HubSpot API連携：CRM運用の効率化

コンタクト・取引の一括操作

HubSpot APIを活用して、大量のコンタクトや取引を一括で操作するパターンです。

たとえば、「過去6ヶ月間アクティビティのないリードのステータスを"休眠"に変更して」と指示すれば、Claude Codeが以下の処理を自動実行します。

• HubSpot Search APIで条件に合致するコンタクトを検索
• 対象コンタクトのプロパティを一括更新
• 更新結果のサマリーを出力

HubSpotの管理画面では、フィルタリング → 選択 → 一括編集の手順で数十回のクリックが必要な作業が、自然言語の1指示で完了します。

カスタムレポートの生成

HubSpotの標準レポート機能ではカバーできない複雑な分析も、API経由でデータを取得しClaude Codeで処理すれば実現できます。

「パイプライン別・担当者別の受注率を、過去12ヶ月の推移で表示して」「リードソース別のLTV（顧客生涯価値）を算出して」など、複数のオブジェクトを横断する分析が可能です。

ワークフローの補完

HubSpotのワークフローでは実現しにくい処理を、Claude Code + APIで補完するパターンです。外部APIとの連携、複雑な条件分岐、データの変換・計算などは、ワークフローのカスタムコードアクションよりも、Claude Codeで生成したスクリプトの方が柔軟に対応できます。

AIコードレビューガイドで紹介しているように、生成されたコードの品質はAIレビューでさらに向上させることができます。

Slack API連携：通知・レポートの自動化

業務イベントの自動通知

特定のビジネスイベント（受注、解約、大口リードの獲得など）が発生した際に、Slackの適切なチャンネルに自動通知するパターンです。

HubSpotのWebhookをトリガーとして、Claude Codeで生成したスクリプトがSlack APIを呼び出し、カスタムフォーマットのメッセージを投稿します。Block Kit（Slackのリッチメッセージ形式）を使えば、ボタン付きの通知やインタラクティブなメッセージも送信可能です。

定期レポートの自動投稿

毎朝9時に、前日の営業活動サマリーをSlackに投稿するパターンです。HubSpot APIから前日のアクティビティデータを取得し、新規リード数・商談数・受注金額をまとめた日次レポートをSlackチャンネルに投稿します。

Claude Codeの2026年3月アップデートで追加された/loopコマンドを活用すれば、セッション内で定期的にプロンプトを実行するスケジューリングも可能です。

チャンネルデータの分析

Slack APIからチャンネルの投稿データを取得し、チームのコミュニケーションパターンを分析するパターンです。「先月のサポートチャンネルで最も多かった問い合わせトピックを分類して」と指示すれば、メッセージデータを取得し、トピック分類と頻度分析を自動実行します。

クロスサービス連携のアーキテクチャ

Quote-to-Cash（見積もりから入金まで）の自動化

CRM × 会計 × コミュニケーションの3システムを横断する、Quote-to-Cashプロセスの自動化は、Claude Code × API連携の最も価値が高いユースケースの一つです。

この一連のフローをClaude Codeで構築する場合、各ステップのスクリプトを個別に生成し、Webhookやcronでトリガーするアーキテクチャが推奨されます。

エラーハンドリングとリトライ設計

API連携では、ネットワークエラー・レート制限・認証エラーなどが必ず発生します。Claude Codeで生成するスクリプトには、以下のエラーハンドリングを含めてください。

• リトライ（指数バックオフ）: APIのレート制限（429エラー）に対して、待機時間を徐々に延ばしながらリトライ
• べき等性の確保: 同じリクエストを複数回送信しても結果が変わらない設計
• エラー通知: 致命的なエラー発生時にSlackやメールで管理者に通知
• ログの記録: 全API呼び出しのリクエスト・レスポンスをログに記録

Claude Codeに「エラーハンドリングとリトライを含めて」と指示すれば、これらのロジックを含むコードが生成されます。

導入のロードマップ

フェーズ1：単一サービスの連携（1〜2週間）

まずは1つのサービス（HubSpotまたはfreee）とClaude Codeの連携を構築します。MCP経由の接続を設定し、基本的なデータ取得・更新が動作することを確認します。

フェーズ2：2サービス間の連携（2〜4週間）

HubSpot → freee、またはHubSpot → Slackの片方向の連携を構築します。Webhookの設定、データマッピング、エラーハンドリングを含めた本番品質のスクリプトを開発します。

フェーズ3：クロスサービス連携（1〜2ヶ月）

3つ以上のサービスを横断するワークフロー（Quote-to-Cashなど）を構築します。エラーハンドリング、リトライ、ログ記録、監視アラートを含む本番運用に耐える設計にします。

フェーズ4：運用の安定化と拡張（継続）

運用開始後は、エラーログの監視、処理速度の改善、新しい連携パターンの追加を継続的に行います。Claude Codeのスキルとして定型化したワークフローを蓄積し、チーム全体の業務効率を向上させます。

Claude Codeの使い方ガイドで基本操作を確認してから、API連携の構築に取り掛かることをお勧めします。

まとめ

本記事では、Claude Code × API連携によるfreee・HubSpot・Slackの業務システム自動化について、基本アーキテクチャから実践パターンまでを解説しました。

ポイントを振り返ります。

• Claude Codeは自然言語の指示だけでAPIクライアントを生成・実行でき、iPaaSでは対応しにくい複雑なビジネスロジックも柔軟に実装できます
• freee APIとの連携で取引登録・請求書発行・経費分析を自動化し、HubSpot APIでコンタクト一括操作やカスタムレポート生成が可能になります
• Quote-to-Cash（見積もりから入金まで）のようなクロスサービス連携では、MCP経由とAPI直接呼び出しのハイブリッド構成が効果的です
• エラーハンドリング・指数バックオフによるリトライ・べき等性の確保を含めた本番品質の設計が、安定運用の鍵です

CRMを活用した業務効率化やAIとの連携に関するご相談は、CRM特化型コンサルティングのStartLinkまでお気軽にお問い合わせください。

よくある質問（FAQ）

Q1. Claude Codeで生成したAPI連携スクリプトは本番運用に使えますか？

使えます。ただし、本番運用に耐えるためには、エラーハンドリング・リトライ・ログ記録・監視の仕組みを追加する必要があります。Claude Codeに「本番品質で」と指示すれば、これらの要素を含むコードが生成されます。デプロイ前にはテスト環境での十分な検証を行ってください。

Q2. APIのレート制限に引っかかりませんか？

各サービスにはAPIのレート制限があります（HubSpotは10秒あたり100リクエスト、freeeは5分あたり300リクエスト等）。Claude Codeで生成するスクリプトに指数バックオフのリトライロジックを含めることで、レート制限を回避できます。大量データの処理には、バッチ処理やキューイングの設計が必要です。

Q3. iPaaS（Zapier等）とClaude Codeのどちらを使うべきですか？

シンプルな「AサービスのイベントでBサービスを更新する」程度の連携であれば、Zapierの方が設定が簡単です。一方、複雑な条件分岐、データ変換、エラーハンドリング、3サービス以上の横断的な連携にはClaude Codeが適しています。両者を併用するケースも多く、基本的な連携はZapierで、高度な処理はClaude Codeで対応するハイブリッド構成も有効です。

Q4. freee × HubSpotの連携に必要なAPIキーの取得方法は？

freeeはfreeeアプリストアでアプリを作成し、OAuth 2.0の認証フローでアクセストークンを取得します。HubSpotは開発者アカウントでPrivate Appを作成し、アクセストークンを取得します。いずれも無料で取得でき、Claude Codeに認証フローの実装を依頼することも可能です。

Q5. セキュリティ面でAPIキーの管理はどうすればよいですか？

APIキー・トークンは環境変数（.envファイル）で管理し、Gitリポジトリにはコミットしないでください。Claude Codeの設定ファイル（.claude.json）にも直接書き込まず、環境変数から読み込む設計にします。チーム運用ではシークレットマネージャー（AWS Secrets Manager等）の利用を推奨します。