Hubspot Mcp Server

HubSpot MCP サーバー

HubSpot を MCP クライアント（Claude Desktop など）と連携するための MCP（Model Context Protocol）サーバーです。会話形式のツールを通じて、HubSpot のコンタクト、会社、取引にアクセスできます。

🛠️ 利用可能なツール

このサーバーは、HubSpot と包括的に連携するための 18 個のツールを提供します。

カテゴリ	ツール	説明
📋 エンティティの一覧表示	list_hubspot_contacts list_hubspot_companies list_hubspot_deals list_hubspot_engagements	ページネーションに対応し、HubSpot のエンティティを一覧表示して閲覧できます
🔧 プロパティ	get_hubspot_contact_properties get_hubspot_company_properties get_hubspot_deal_properties	各エンティティタイプのフィールドプロパティとスキーマを取得します
🔍 検索とフィルタリング	search_hubspot_contacts search_hubspot_companies search_hubspot_deals	各エンティティタイプをフィルターで高度に検索します
💼 取引管理	get_deal_by_name create_deal update_deal	取引のライフサイクルを一貫して管理します
🤖 AI を活用した検索	semantic_search_hubspot manage_hubspot_embeddings browse_hubspot_indexed_data	FAISS ベクトルデータベースを使用し、自然言語でセマンティック検索を行います
⚡ キャッシュとパフォーマンス	load_hubspot_entities_to_cache manage_hubspot_cache	一括読み込み、キャッシュ、パフォーマンスの最適化を行います

ツールの完全なドキュメントはこちらをご覧ください：ツールのドキュメント

---

⚡ 使用例

インストールと設定をすべて完了した後（インストールガイドに従ってください）、MCP クライアントで自然言語のフレーズを使用します。

🗣️ 自然言語での問い合わせ

• 「HubSpot のコンタクトを一覧表示して」
• 「テクノロジー分野の会社を探して」
• 「進行中の取引を表示して」
• 「Project X の新しい取引を作成して」
• 「「Project X」の取引を検索して」
• 「利用可能なコンタクトのプロパティは？」

🤖 AI を活用したセマンティック検索

• 「ソフトウェアエンジニアを探して」 → 「開発者」、「プログラマー」、「ソフトウェアアーキテクト」に一致します
• 「エンタープライズ顧客を検索して」 → 完全一致するキーワードがなくても大企業を見つけます
• 「パリのテクノロジー企業」 → 場所や業界の文脈を考慮して検索します

さまざまな使用方法の完全なドキュメントはこちらをご覧ください：使用例

---

📚 ドキュメントの目次

🚀 はじめに

セクション	説明
クライアント連携	MCP クライアント連携の完全ガイド
Claude Desktop との連携	Claude Desktop の stdio モードと SSE モードに関する完全ガイド

🔧 追加機能

セクション	説明
セマンティック検索	AI を活用したセマンティック検索の機能と使用方法
キャッシュシステム	共有 TTL キャッシュの仕組みと管理方法
SSE エンドポイント	ヘルスモニタリングとデータ管理のための REST API エンドポイント

🛠️ 開発とテスト

セクション	説明
開発者ガイド	テスト、品質保証、開発ワークフロー
MCP Inspector	MCP Inspector を使用した視覚的なデバッグとテスト
トラブルシューティング	よくある問題と解決方法
統合テスト	包括的なテスト手順
ローカルインストール（stdio）	ローカルへのインストールと実行
リモートデプロイ（SSE）	本番環境で使用するための Kubernetes へのデプロイ
環境設定	高度な環境設定

📋 品質保証：pre-commit フックにより、コミットごとにコードの自動フォーマット、ドキュメントのリント、リンク切れのチェックが実行されます。just install-dev でインストールしてください。

---

🤝 コントリビューション

コントリビューションガイドで、以下をご確認ください。

• 開発標準
• ツールの作成プロセス
• コードとテストの規約
• Git ワークフローとセマンティックバージョニング

---

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。