ghl-mcp-server - GoHighLevel API v2を統合、CRMなどのツールとのMCPプロトコルサービス

Ghl MCP Server

GoHighLevel MCPサーバーは、GoHighLevel API v2との全面的な統合を提供するモデルコンテキストプロトコルサービスです。CRM、マーケティング自動化、およびビジネス管理ツールの対話をサポートし、連絡先管理、会話メッセージ、カレンダー予約、販売機会、支払い、および自動化ワークフローなどの機能を含んでいます。

顧客データプラットフォームマーケティング #CRM統合 #マーケティング自動化 #ビジネス管理 #APIサービス .JavaScript

スコア : 2ポイント

ダウンロード数 : 4.1K

更新時間 : 2025-07-24

GoHighLevel MCPサーバーとは？

GoHighLevel MCPサーバーは、Model Context Protocol (MCP)サービスで、AIアシスタントがGoHighLevel CRM、マーケティング自動化、およびビジネス管理ツールと対話できるようにします。ユーザーには、連絡先、会話、カレンダー、販売機会などを管理するための統一されたインターフェースが提供されます。

GoHighLevel MCPサーバーの使い方は？

環境変数を設定してサーバーを起動することで、GoHighLevelの機能をAIアシスタントに統合できます。簡単なコマンドで、連絡先の作成、メッセージの送信、予約のスケジューリングなど、さまざまなAPI機能を呼び出すことができます。

適用シナリオ

GoHighLevel CRMシステムと統合する必要があるAIアシスタントに適しています。例えば、顧客メッセージの自動返信、会議のスケジューリング、販売機会の管理などです。企業、エージェント、開発者が自動化プロセスを迅速に構築するのに適しています。

主要機能

全面的なAPIカバレッジGoHighLevelのすべての核心機能をサポートします。連絡先管理、会話、カレンダー、販売機会、支払い、および自動化ワークフローが含まれます。

柔軟な認証方式OAuth 2.0とプライベート統合トークンをサポートし、さまざまな規模の使用ニーズに対応します。

組み込みのレート制限自動的にリクエスト頻度を管理します（10秒間に100回のリクエスト、1日に20万回）。APIの乱用を防止します。

エラー処理詳細なエラー情報を提供し、ユーザーが問題を迅速に特定して解決できるようにします。

Vercel互換性Vercelプラットフォーム用に設計されており、MCPプロトコルをサポートし、デプロイと実行が容易です。

型安全すべてのツールは入力検証とスキーマ定義を経ており、データの正確性を保証します。

利点と制限

利点

AIアシスタントに簡単に統合でき、自動化能力を向上させます

複数の認証方式をサポートし、さまざまなシナリオに対応します

詳細なエラー情報を提供し、デバッグが容易です

組み込みのレート制限があり、APIの乱用を防止します

制限

GoHighLevelアカウントとAPIアクセス権が必要です

非技術ユーザーには一定の学習曲線が必要かもしれません

GoHighLevel APIの安定性に依存します

使い方

サーバーをインストールする

npmを使ってGoHighLevel MCPサーバーをインストールします。グローバルにインストールするか、ローカルプロジェクトにインストールすることができます。

環境変数を設定する

.env.exampleファイルをコピーし、GoHighLevelの資格情報を入力します。プライベートトークンまたはOAuth 2.0認証を使用することができます。

MCPクライアントを設定する

Claude Desktopまたは他のMCPクライアントにGoHighLevelサーバーの設定を追加し、コマンドと環境変数を指定します。

API機能を使用する

提供されているツール関数を呼び出すことで、連絡先の作成、メッセージの送信、予約のスケジューリングなど、GoHighLevel APIと対話できます。

使用例

新しい連絡先を作成する顧客がウェブサイトのフォームから情報を送信すると、自動的にGoHighLevelに連絡先を作成します。

歓迎メッセージを送信する新しい連絡先が登録されると、自動的に歓迎SMSまたはメールを送信します。

予約をスケジューリングする顧客が予約を要求すると、自動的にGoHighLevelのカレンダーに予約を作成します。

よくある質問

GoHighLevel MCPサーバーを使用するために必要なものは何ですか？

認証に失敗した場合、どうすればいいですか？

サーバーはGoHighLevelのどの機能をサポートしていますか？

このサーバーをどのようにデプロイしますか？

🚀 GoHighLevel MCP Server

このModel Context Protocol (MCP) サーバーは、GoHighLevel API v2との包括的な統合を提供します。このサーバーにより、AIアシスタントがGoHighLevelのCRM、マーケティングオートメーション、およびビジネス管理ツールとやり取りできるようになります。

✨ 主な機能

🚀 完全なAPIカバレッジ：コンタクト、会話、カレンダー、商談、支払い、ワークフローなどへのアクセス
🔐 柔軟な認証方式：OAuth 2.0とプライベート統合トークンの両方をサポート
⚡ 組み込みのレート制限：自動的なレート制限管理（10秒間に100リクエスト、1日に20万リクエスト）
🛡️ エラーハンドリング：詳細なエラーメッセージを伴う包括的なエラーハンドリング
📦 Vercel対応：MCPをサポートしたVercelへのデプロイに最適化
🎯 型安全：すべてのツールに対する完全な入力検証とスキーマ定義

📦 インストール

npm install ghl-mcp-server

または、グローバルにインストールする場合は：

npm install -g ghl-mcp-server

🚀 クイックスタート

1. 環境変数の設定

.env.example を .env にコピーし、認証情報を入力します。

cp .env.example .env

.env を開き、GoHighLevelの認証情報を入力します。

# プライベート統合トークン（最も簡単な方法）
GHL_PRIVATE_TOKEN=your_private_integration_token_here

# または、OAuthを使用する場合（複数アカウントへのアクセス用）
GHL_CLIENT_ID=your_oauth_client_id
GHL_CLIENT_SECRET=your_oauth_client_secret

2. MCPクライアントの設定

Claude Desktopまたはその他のMCPクライアントの設定に追加します。

{
  "mcpServers": {
    "ghl": {
      "command": "npx",
      "args": ["ghl-mcp-server"],
      "env": {
        "GHL_PRIVATE_TOKEN": "your_token_here"
      }
    }
  }
}

3. GoHighLevelツールの使用開始

サーバーは以下のツールを提供します。

コンタクト管理

ghl_create_contact - 新しいコンタクトを作成
ghl_search_contacts - コンタクトを検索
ghl_get_contact - コンタクトの詳細を取得
ghl_update_contact - コンタクト情報を更新
ghl_delete_contact - コンタクトを削除
ghl_add_contact_tags - コンタクトにタグを追加
ghl_remove_contact_tags - コンタクトからタグを削除

会話とメッセージング

ghl_send_message - SMS、メール、またはWhatsAppメッセージを送信
ghl_get_conversations - 会話リストを取得
ghl_get_messages - 会話内のメッセージを取得

カレンダーと予約

ghl_create_calendar - 新しいカレンダーを作成
ghl_create_appointment - 予約を作成
ghl_get_calendar_slots - 利用可能な時間枠を取得
ghl_update_appointment - 予約の詳細を更新
ghl_cancel_appointment - 予約をキャンセル

営業と商談

ghl_create_opportunity - 商談を作成
ghl_search_opportunities - 商談を検索
ghl_update_opportunity - 商談の詳細を更新
ghl_delete_opportunity - 商談を削除
ghl_get_pipelines - パイプラインリストを取得

支払い

ghl_create_order - 支払い注文を作成
ghl_get_transactions - 取引履歴を取得
ghl_get_orders - 注文リストを取得

オートメーション

ghl_add_contact_to_workflow - コンタクトをワークフローに追加
ghl_remove_contact_from_workflow - ワークフローからコンタクトを削除
ghl_get_workflows - ワークフローリストを取得

💻 使用例

コンタクトの作成

{
  "tool": "ghl_create_contact",
  "arguments": {
    "locationId": "your_location_id",
    "contactData": {
      "firstName": "John",
      "lastName": "Doe",
      "email": "john.doe@example.com",
      "phone": "+1234567890",
      "tags": ["new-lead", "website"]
    }
  }
}

メッセージの送信

{
  "tool": "ghl_send_message",
  "arguments": {
    "type": "SMS",
    "contactId": "contact_id",
    "locationId": "location_id",
    "message": "Hello! Thanks for your interest."
  }
}

予約の作成

{
  "tool": "ghl_create_appointment",
  "arguments": {
    "appointmentData": {
      "calendarId": "calendar_id",
      "locationId": "location_id",
      "contactId": "contact_id",
      "startTime": "2025-07-23T15:00:00Z",
      "endTime": "2025-07-23T16:00:00Z",
      "title": "Consultation Call"
    }
  }
}

認証方法

方法1: プライベート統合トークン（単一アカウントにおすすめ）

GoHighLevelの設定 > 統合 > プライベート統合に移動します。
新しいプライベート統合を作成します。
トークンをコピーし、.env ファイルに追加します。

方法2: OAuth 2.0（マーケットプレイスアプリ用）

GoHighLevelマーケットプレイスにアプリを登録します。
必要なスコープでOAuthを設定します。
OAuthフローを使用してアクセストークンを取得します。

開発

ローカルでの実行

# 依存関係のインストール
npm install

# 開発モードで実行
npm run dev

プロジェクト構造

ghl-mcp-server/
├── index.js              # メインサーバーのエントリーポイント
├── src/
│   ├── api-client.js     # GoHighLevel APIクライアント
│   ├── config.js         # 設定定数
│   ├── rate-limiter.js   # レート制限ロジック
│   ├── error-handler.js  # エラーハンドリングユーティリティ
│   └── tools/            # ツール定義
│       ├── contact-tools.js
│       ├── conversation-tools.js
│       ├── calendar-tools.js
│       ├── opportunity-tools.js
│       ├── payment-tools.js
│       └── workflow-tools.js
└── package.json