HubSpot - AI Studio|HubSpotと生成AIの技術特化メディア

Claude Code × MCP連携ガイド|社内システムとAIを接続する設定手順と活用パターン | StartLink

作成者: 今枝 拓海|2026/03/10 17:40:35

「AIを導入したいが、社内システムのデータにアクセスできなければ意味がない」。多くのCTO・エンジニアが感じているこの課題を解決するのが、Claude CodeとMCP(Model Context Protocol)の連携です。

MCPはAnthropicが提唱するオープンソースの標準プロトコルで、AIアシスタントと外部ツール・データベース・APIを安全に接続するための仕組みです。Claude Codeは2026年現在、MCPサーバーとの接続を標準サポートしており、HubSpot・freee・Slack・PostgreSQLなど数百のサービスと連携できます。

本記事では、MCP連携の基本概念から具体的な設定手順、そして実務で効果を発揮する活用パターンまでを解説します。

この記事でわかること

  • MCPとは何か、従来のAPI連携とどう違うのかを理解できる
  • Claude CodeでMCPサーバーを設定する具体的な手順がわかる
  • HubSpot・freee・Slackなど主要サービスとの連携パターンを把握できる
  • MCP連携のセキュリティ上の注意点とベストプラクティスを学べる
  • 社内システムとAIの接続による業務自動化の全体像が描ける

MCPとは何か:AI連携の新しい標準プロトコル

従来のAPI連携との違い

従来、AIツールと外部サービスを連携するには、個別のAPIクライアントを開発し、認証処理・エラーハンドリング・データ変換のロジックをサービスごとに実装する必要がありました。サービスが10個あれば、10通りの連携コードを書くことになります。

MCPは、この問題を標準プロトコルで解決します。MCPサーバーがツールごとの接続処理を抽象化し、Claude Codeは統一されたインターフェースで任意のサービスにアクセスできます。新しいサービスを追加する際も、対応するMCPサーバーを登録するだけで連携が完了します。

比較項目 従来のAPI連携 MCP連携
接続方式 サービスごとに個別実装 統一プロトコルで接続
認証管理 個別のOAuth/APIキー管理 MCPサーバーが一元管理
新サービス追加 コード開発が必要 MCPサーバー登録のみ
セキュリティ 実装者依存 プロトコルレベルで制御
コンテキスト共有 手動でデータ加工 自動的にAIに提供
運用コスト 高い(保守が必要) 低い(標準化済み)

MCPの詳細な仕組みについては、「MCPとは|Model Context Protocolの基礎と活用ガイド」で詳しく解説しています。

MCPの3つの構成要素

MCPは以下の3つの要素で構成されます。

MCPホスト(Claude Code): AIアシスタント側のアプリケーションです。ユーザーの指示を受け取り、必要なツールをMCPサーバーに要求します。

MCPサーバー: 各外部サービスへのアクセスを仲介するサーバーです。HubSpot用、freee用、Slack用など、サービスごとに専用のMCPサーバーが存在します。

MCPクライアント: ホストとサーバー間の通信を管理するコンポーネントです。接続の確立、リクエストの送信、レスポンスの受信を行います。

Claude CodeでMCPサーバーを設定する手順

CLIからの基本設定

Claude CodeでMCPサーバーを追加する最もシンプルな方法は、CLIコマンドを使用することです。

HTTPトランスポート(リモートサーバー接続)の場合は、claude mcp add --transport http のコマンドで登録します。SSE(Server-Sent Events)トランスポートの場合は、claude mcp add --transport sse を使用します。

ローカルプロセスとして動作するMCPサーバー(Stdioトランスポート)は、claude mcp add [引数...] で追加できます。

設定ファイルによる管理

複数のMCPサーバーを管理する場合は、.claude.jsonファイルに設定を直接記述する方法が効率的です。プロジェクトルートに配置することで、チームメンバー全員が同じMCP設定を共有できます。

設定ファイルには、各MCPサーバーの名前、トランスポート方式、接続先URL、環境変数(APIキーなど)を定義します。環境変数は.envファイルから読み込むことで、認証情報をGitリポジトリに含めずに管理できます。

接続確認とデバッグ

MCPサーバーの設定後は、claude mcp list で登録済みサーバーの一覧を確認できます。接続に問題がある場合は、MCPサーバーのログを確認し、認証情報やURLの誤りがないかチェックしてください。

主要サービスとの連携パターン

HubSpot × MCP:CRMデータへのリアルタイムアクセス

HubSpot MCPサーバーを設定すると、Claude Codeから直接CRMデータにアクセスできます。具体的には以下のような操作が可能です。

  • コンタクト・会社・取引の検索と取得
  • パイプラインのステージ別集計
  • カスタムプロパティの参照と更新
  • ワークフローの実行状況確認

たとえば、「今月クローズ予定の取引一覧を金額順に表示して」と自然言語で指示するだけで、Claude CodeがHubSpot MCPサーバーを通じてデータを取得し、整形して表示します。

HubSpotでは公式のClaude Connectorも提供されており、Webインターフェース上でCRMデータをClaudeに接続する方法も用意されています。

freee × MCP:会計データの参照と分析

freee MCPサーバーを連携すると、会計データへのアクセスが可能になります。売上推移の分析、勘定科目別の集計、取引先別の売掛金残高確認など、経理業務で必要なデータをClaude Code上で直接操作できます。

CRMのHubSpotと会計のfreeeをMCP経由で同時に接続することで、「受注から入金までの一気通貫」のデータフローをAIが横断的に把握できるようになります。これは、フロントオフィスとバックオフィスの統合という観点で大きな価値を持ちます。

Slack × MCP:コミュニケーションデータの活用

Slack MCPサーバーを通じて、チャンネルの投稿検索、スレッドの読み取り、メッセージの送信が可能です。2026年1月にはAnthropicがSlack向けのInteractive Apps(MCP Apps)をリリースし、Claudeから直接Slackにメッセージを投稿できるようになりました。

プロジェクト管理の文脈では、Slackの過去のやり取りを参照しながら、HubSpotの取引情報を更新するといったクロスサービスの作業が、一つのClaude Codeセッション内で完結します。

データベース × MCP:社内DBへの直接接続

PostgreSQL、MySQL、Supabaseなどのデータベース用MCPサーバーを利用すれば、社内の独自データベースにもClaude Codeからアクセスできます。

たとえば、Supabase MCPサーバーを使えば、テーブル一覧の確認、SQLの実行、マイグレーションの適用をClaude Codeから直接操作できます。既存のデータベーススキーマをAIが理解した上で、クエリの生成やデータ分析を行えます。

MCP連携のセキュリティとベストプラクティス

認証情報の安全な管理

MCPサーバーに渡すAPIキーやトークンは、必ず環境変数として管理してください。設定ファイルにハードコードしたり、Gitリポジトリにコミットしたりすることは厳禁です。

チームで運用する場合は、シークレットマネージャー(AWS Secrets Manager、HashiCorp Vaultなど)と組み合わせて、認証情報のローテーションを自動化することを推奨します。

アクセス権限の最小化

MCPサーバーには、業務に必要な最小限の権限のみを付与してください。たとえば、HubSpot MCPサーバーにはデータの「読み取り」のみを許可し、「書き込み」は明示的に必要な場合のみ有効にするといった運用が安全です。

Anthropicの公式ドキュメントでも、サードパーティ製MCPサーバーの利用はリスクを伴うため、信頼できるサーバーのみを導入するよう推奨されています。

ツール検索機能によるコンテキスト最適化

Claude Code 2026では、MCPツール検索(Tool Search)機能が実装されています。この機能は、登録されたMCPサーバーのツール定義を遅延読み込み(Lazy Loading)することで、コンテキストの使用量を最大95%削減します。

多数のMCPサーバーを登録している環境では、この機能を有効にすることで、AIのレスポンス品質と速度の両方が改善されます。

実践的な活用シナリオ

シナリオ1:営業レポートの自動生成

HubSpot MCPとGoogle Sheets MCPを組み合わせて、毎週の営業レポートを自動生成するシナリオです。Claude Codeに「今週のパイプライン変動をまとめてスプレッドシートに出力して」と指示すると、HubSpotからパイプラインデータを取得し、前週との差分を計算し、Google Sheetsに整形して出力します。

Shopifyは、HubSpot CRMとの連携にMCPを活用し、顧客データと注文データを統合した分析基盤を構築しています。同様のアプローチは、規模を問わず実践可能です。

シナリオ2:経営ダッシュボードの構築

freee MCP(会計実績)+ HubSpot MCP(パイプライン予測)+ Supabase MCP(独自KPI)を統合し、Claude Codeから経営データを横断的に分析するシナリオです。「今月の売上着地予測を、確定売上と見込み案件から算出して」という自然言語の指示で、複数データソースを横断した分析が実行されます。

シナリオ3:カスタムMCPサーバーの開発

既存のMCPサーバーでカバーできない社内システムがある場合は、カスタムMCPサーバーを開発できます。MCPはオープンソースの仕様であり、Python・TypeScript・Goなどの主要言語でSDKが提供されています。

社内の基幹システムや独自APIに対するMCPサーバーを構築することで、Claude Codeから社内の全システムにアクセスする「AIハブ」を実現できます。

AI駆動開発の全体像を理解した上でMCPを導入すると、より効果的な活用が可能です。

MCP連携の導入ステップ

ステップ 内容 目安期間
1. 対象システムの選定 連携効果の高いサービスを特定 1週間
2. MCPサーバーの調査 公式/コミュニティ提供サーバーの有無を確認 2〜3日
3. 開発環境での検証 テスト環境で接続確認・動作検証 1〜2週間
4. セキュリティレビュー 認証情報の管理・権限設定の確認 1週間
5. 本番環境への展開 段階的にチームへ展開 2〜4週間
6. 運用ルールの整備 利用ガイドライン・トラブル対応手順の策定 1週間

まとめ

本記事では、Claude CodeとMCP(Model Context Protocol)を連携して社内システムとAIを接続する方法について、設定手順から活用パターンまでを解説しました。

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

  • MCPは従来のAPI個別実装を統一プロトコルで置き換え、新サービスの追加をMCPサーバー登録だけで完了させる標準規格です
  • HubSpot・freee・Slack・データベースなど主要サービスとMCPで接続することで、複数データソースを横断した分析や自動化が一つのセッション内で実現します
  • 認証情報は環境変数で管理し、MCPサーバーには最小限の権限のみを付与するセキュリティ設計が不可欠です
  • 対象システムの選定から段階的に導入し、開発環境での検証とセキュリティレビューを経てからチームに展開するステップを踏むことが成功の鍵です

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

よくある質問(FAQ)

Q1. MCPサーバーの利用に追加料金はかかりますか?

MCPプロトコル自体はオープンソースであり、無料で利用できます。ただし、Claude Code自体の利用にはAnthropicのサブスクリプション(Pro $20/月〜)が必要です。また、連携先サービス(HubSpot、freee等)のAPI利用料が別途発生する場合があります。

Q2. 自社で使っている独自システムにもMCP連携できますか?

はい。MCPはオープンソース仕様であり、任意のAPIに対するカスタムMCPサーバーを開発できます。TypeScript・Python・GoのSDKが公式に提供されています。社内の基幹システムやレガシーシステムでも、REST APIが公開されていれば連携可能です。

Q3. MCPのセキュリティは十分ですか?

MCPはプロトコルレベルで認証・認可の仕組みを備えていますが、サードパーティ製のMCPサーバーについてはAnthropicが安全性を保証していません。本番環境で利用する場合は、ソースコードのレビュー、ネットワークのアクセス制御、認証情報の暗号化を実施することを推奨します。

Q4. 複数のMCPサーバーを同時に使えますか?

はい。Claude Codeは複数のMCPサーバーに同時接続でき、一つのセッション内でHubSpot・freee・Slackなど異なるサービスのデータを横断的に操作できます。ツール検索機能により、多数のサーバーを登録してもパフォーマンスへの影響は最小限に抑えられます。

Q5. MCPの導入にエンジニアは何名必要ですか?

既存の公式MCPサーバーを利用する場合は、CLIコマンド数行で設定が完了するため、1名のエンジニアで十分です。カスタムMCPサーバーを開発する場合は、対象システムのAPIに精通したエンジニアが1〜2名必要になります。