Gohighlevel MCP

🚀 GoHighLevel MCP Server

このGoHighLevel MCP Serverは、MCP（Model Context Protocol）を通じてGoHighLevelコミュニティとAI自動化をつなぐための基盤プロジェクトです。GoHighLevel APIへのアクセスや、AIシステムとの統合を通じて、業務の効率化や新たな機能の開発を支援します。

---

🚀 クイックスタート

このプロジェクトは、GoHighLevelコミュニティとAI自動化をつなぐための基盤となるものです。以下に、主な機能や使用方法、注意事項を説明します。

🎯 このプロジェクトの概要

• 基盤レイヤー：MCPを通じて、すべてのサブアカウントレベルのGoHighLevel APIエンドポイントにアクセスできます。
• コミュニティのスターター：コミュニティが一緒にスピーディーに前進できるように構築されています。
• オープンアーキテクチャ：APIクライアントと型は、必要に応じてさらにモジュール化およびセグメント化できます。
• 教育リソース：GoHighLevelとAIシステムの統合方法を学ぶことができます。

⚠️ 重要なAIセキュリティに関する考慮事項

• メモリ/リコールシステム：適切なメモリまたはリコールメカニズムを実装しない場合、AIが意図しないアクションを実行する可能性があります。
• レート制限：APIの使用状況を監視し、GoHighLevelのレート制限に達しないようにしてください。
• 権限管理：このプロジェクトを使用すると、サブアカウントのAPIに完全なアクセス権が与えられます。
• データセキュリティ：すべてのアクションはAPI資格情報を使用して実行されるため、適切なセキュリティ対策を講じてください。

🎯 想定される使用方法

• 個人/ビジネス利用：自分のGoHighLevelアカウントをAIと統合します。
• 開発基盤：この基盤を元に、カスタムソリューションを構築します。
• 学習と実験：GoHighLevel APIのパターンを理解します。
• コミュニティ貢献：この基盤を改善および拡張するために貢献します。

🚫 想定されない使用方法

• 直接の転売：これは無料で利用できるコミュニティソフトウェアです。
• テストなしの本番環境での使用：常に開発環境で十分にテストしてから本番環境に移行してください。
• 監視なしのAI利用：適切なセーフガードと監視を実装してください。

---

🔑 重要: GoHighLevel APIのセットアップ

📋 必要なもの: プライベート統合APIキー

⚠️ 重要提示

このプロジェクトには、通常のAPIキーではなく、プライベート統合APIキーが必要です！

プライベート統合APIキーの取得方法:

1. GoHighLevelアカウントにログインします
2. 設定 → 統合 → プライベート統合に移動します
3. 新しいプライベート統合を作成します:
   • 名前: MCP Server Integration（または好きな名前）
   • Webhook URL: 空白のままにします（必要ありません）
4. 使用するツールに基づいて、必要なスコープを選択します:
   • ✅ contacts.readonly - 連絡先を表示する
   • ✅ contacts.write - 連絡先を作成/更新する
   • ✅ conversations.readonly - 会話を表示する
   • ✅ conversations.write - メッセージを送信する
   • ✅ opportunities.readonly - 商談を表示する
   • ✅ opportunities.write - 商談を管理する
   • ✅ calendars.readonly - カレンダー/予定を表示する
   • ✅ calendars.write - 予定を作成/管理する
   • ✅ locations.readonly - 拠点データを表示する
   • ✅ locations.write - 拠点設定を管理する
   • ✅ workflows.readonly - ワークフローを表示する
   • ✅ campaigns.readonly - キャンペーンを表示する
   • ✅ blogs.readonly - ブログコンテンツを表示する
   • ✅ blogs.write - ブログ記事を作成/管理する
   • ✅ users.readonly - ユーザー情報を表示する
   • ✅ custom_objects.readonly - カスタムオブジェクトを表示する
   • ✅ custom_objects.write - カスタムオブジェクトを管理する
   • ✅ invoices.readonly - 請求書を表示する
   • ✅ invoices.write - 請求書を作成/管理する
   • ✅ payments.readonly - 支払いデータを表示する
   • ✅ products.readonly - 商品を表示する
   • ✅ products.write - 商品を管理する
5. 統合を保存し、生成されたプライベートAPIキーをコピーします
6. 設定 → 会社 → 拠点から、拠点IDをコピーします

💡 使用建议

必要に応じて、後でプライベート統合を編集することで、さらに多くのスコープを追加することができます。

---

このプロジェクトは多くの時間を費やして開発されましたが、重要なものだと感じています。ご支援いただける場合は、以下のリンクから寄付をお願いいたします。すべての寄付金はこのプロジェクトのさらなる発展に役立てられます。

🔥 Claude Desktopを、19カテゴリ以上の269以上の強力なツールを備えた完全なGoHighLevel CRMパワーハウスに変えましょう

🎯 このプロジェクトの機能

この包括的なMCP（Model Context Protocol）サーバーは、Claude Desktopを直接GoHighLevelアカウントに接続し、前例のない自動化機能を提供します。

• 👥 完全な連絡先管理：連絡先、タスク、メモ、および関係性に関する31のツール
• 💬 高度なメッセージング：SMS、メール、会話、および通話録音に関する20のツール
• 🏢 ビジネスオペレーション：拠点管理、カスタムオブジェクト、ワークフロー、および調査
• 💰 販売と収益：商談、支払い、請求書、見積もり、および請求自動化
• 📱 マーケティング自動化：ソーシャルメディア、メールキャンペーン、ブログ管理、およびメディアライブラリ
• 🛒 eコマース：ストア管理、商品、在庫、配送、および注文履行

⚡ クイックデプロイオプション

🟢 Vercel（推奨）

Vercelを選ぶ理由:

• ✅ 寛大な制限を持つ無料プラン
• ✅ 自動的なHTTPSとグローバルCDN
• ✅ ゼロコンフィグのデプロイ
• ✅ MCPサーバーに最適

🚂 Railway

Railwayを選ぶ理由:

• ✅ 月額$5の無料クレジット
• ✅ シンプルなワンクリックデプロイ
• ✅ 自動スケーリング
• ✅ 本番環境のワークロードに最適

🎨 Render

• ✅ 無料プランが利用可能
• ✅ GitHubからの自動デプロイ
• ✅ 組み込みのSSL

🌟 完全なツールカタログ（269のツール）

🎯 連絡先管理（31のツール）

基本操作:

• create_contact, search_contacts, get_contact, update_contact, delete_contact
• add_contact_tags, remove_contact_tags - タグで整理する

タスクとメモ管理:

• get_contact_tasks, create_contact_task, update_contact_task, delete_contact_task
• get_contact_notes, create_contact_note, update_contact_note, delete_contact_note

高度な機能:

• upsert_contact - スマートな作成/更新
• get_duplicate_contact - 重複検出
• bulk_update_contact_tags - 大量のタグ操作
• add_contact_to_workflow, remove_contact_from_workflow - ワークフロー自動化
• add_contact_followers, remove_contact_followers - チームコラボレーション

💬 メッセージングと会話（20のツール）

直接のコミュニケーション:

• send_sms, send_email - リッチな書式でメッセージを送信する
• search_conversations, get_conversation, create_conversation

メッセージ管理:

• get_message, get_email_message, upload_message_attachments
• update_message_status, cancel_scheduled_message

通話機能:

• get_message_recording, get_message_transcription, download_transcription
• add_inbound_message, add_outbound_call - 手動でのロギング

ライブチャット:

• live_chat_typing - リアルタイムの入力インジケーター

📝 ブログ管理（7のツール）

• create_blog_post, update_blog_post - SEO対応のコンテンツ作成
• get_blog_posts, get_blog_sites - コンテンツの発見
• get_blog_authors, get_blog_categories - 整理
• check_url_slug - SEO検証

💰 商談管理（10のツール）

• search_opportunities - パイプライン、ステージ、連絡先で高度なフィルタリング
• get_pipelines - 販売パイプライン管理
• create_opportunity, update_opportunity, delete_opportunity
• update_opportunity_status - 迅速な勝敗更新
• upsert_opportunity - スマートなパイプライン管理
• add_opportunity_followers, remove_opportunity_followers

🗓️ カレンダーと予定管理（14のツール）

カレンダー管理:

• get_calendar_groups, get_calendars, create_calendar
• update_calendar, delete_calendar

予定予約:

• get_calendar_events, get_free_slots - 空き状況の確認
• create_appointment, get_appointment, update_appointment, delete_appointment

スケジュール管理:

• create_block_slot, update_block_slot - 時間のブロッキング

📧 メールマーケティング（5のツール）

• get_email_campaigns - キャンペーン管理
• create_email_template, get_email_templates - テンプレートシステム
• update_email_template, delete_email_template

🏢 拠点管理（24のツール）

サブアカウント管理:

• search_locations, get_location, create_location, update_location, delete_location

タグシステム:

• get_location_tags, create_location_tag, update_location_tag, delete_location_tag

カスタムフィールドと値:

• get_location_custom_fields, create_location_custom_field, update_location_custom_field
• get_location_custom_values, create_location_custom_value, update_location_custom_value

テンプレートと設定:

• get_location_templates, delete_location_template, get_timezones

✅ メール検証（1のツール）

• verify_email - 配信可能性とリスク評価

📱 ソーシャルメディア管理（17のツール）

投稿管理:

• search_social_posts, create_social_post, get_social_post
• update_social_post, delete_social_post, bulk_delete_social_posts

アカウント統合:

• get_social_accounts, delete_social_account, start_social_oauth

大量操作:

• upload_social_csv, get_csv_upload_status, set_csv_accounts

整理:

• get_social_categories, get_social_tags, get_social_tags_by_ids

プラットフォーム: Google Business, Facebook, Instagram, LinkedIn, Twitter, TikTok

📁 メディアライブラリ（3のツール）

• get_media_files - メディアの検索とフィルタリング
• upload_media_file - ファイルのアップロードとホストURL
• delete_media_file - メディアアセットのクリーンアップ

🏗️ カスタムオブジェクト（9のツール）

スキーマ管理:

• get_all_objects, create_object_schema, get_object_schema, update_object_schema

レコード操作:

• create_object_record, get_object_record, update_object_record, delete_object_record

高度な検索:

• search_object_records - カスタムデータのクエリ

使用例: ペットの記録、サポートチケット、在庫、カスタムビジネスデータ

🔗 関連管理（10のツール）

• ghl_get_all_associations, ghl_create_association, ghl_get_association_by_id
• ghl_update_association, ghl_delete_association
• ghl_create_relation, ghl_get_relations_by_record, ghl_delete_relation
• オブジェクト間の高度な関係マッピング

🎛️ カスタムフィールドV2（8のツール）

• ghl_get_custom_field_by_id, ghl_create_custom_field, ghl_update_custom_field
• ghl_delete_custom_field, ghl_get_custom_fields_by_object_key
• ghl_create_custom_field_folder, ghl_update_custom_field_folder, ghl_delete_custom_field_folder

⚡ ワークフロー管理（1のツール）

• ghl_get_workflows - 自動化ワークフローの発見

📊 調査管理（2のツール）

• ghl_get_surveys - 調査管理
• ghl_get_survey_submissions - 回答分析

🛒 ストア管理（18のツール）

配送ゾーン:

• ghl_create_shipping_zone, ghl_list_shipping_zones, ghl_get_shipping_zone
• ghl_update_shipping_zone, ghl_delete_shipping_zone

配送料率:

• ghl_get_available_shipping_rates, ghl_create_shipping_rate, ghl_list_shipping_rates
• ghl_get_shipping_rate, ghl_update_shipping_rate, ghl_delete_shipping_rate

キャリアと設定:

• ghl_create_shipping_carrier, ghl_list_shipping_carriers, ghl_update_shipping_carrier
• ghl_create_store_setting, ghl_get_store_setting

📦 商品管理（10のツール）

商品操作:

• ghl_create_product, ghl_list_products, ghl_get_product
• ghl_update_product, ghl_delete_product

価格と在庫:

• ghl_create_price, ghl_list_prices, ghl_list_inventory

コレクション:

• ghl_create_product_collection, ghl_list_product_collections

💳 支払い管理（20のツール）

統合プロバイダー:

• create_whitelabel_integration_provider, list_whitelabel_integration_providers

注文管理:

• list_orders, get_order_by_id, create_order_fulfillment, list_order_fulfillments

取引追跡:

• list_transactions, get_transaction_by_id

サブスクリプション管理:

• list_subscriptions, get_subscription_by_id

クーポンシステム:

• list_coupons, create_coupon, update_coupon, delete_coupon, get_coupon

カスタム支払いゲートウェイ:

• create_custom_provider_integration, delete_custom_provider_integration
• get_custom_provider_config, create_custom_provider_config

🧾 請求書と請求管理（39のツール）

請求書テンプレート:

• create_invoice_template, list_invoice_templates, get_invoice_template
• update_invoice_template, delete_invoice_template
• update_invoice_template_late_fees, update_invoice_template_payment_methods

定期請求書:

• create_invoice_schedule, list_invoice_schedules, get_invoice_schedule
• update_invoice_schedule, delete_invoice_schedule, schedule_invoice_schedule
• auto_payment_invoice_schedule, cancel_invoice_schedule

請求書管理:

• create_invoice, list_invoices, get_invoice, update_invoice
• delete_invoice, void_invoice, send_invoice, record_invoice_payment
• generate_invoice_number, text2pay_invoice

見積もり:

• create_estimate, list_estimates, update_estimate, delete_estimate
• send_estimate, create_invoice_from_estimate, generate_estimate_number

見積もりテンプレート:

• list_estimate_templates, create_estimate_template, update_estimate_template
• delete_estimate_template, preview_estimate_template

💻 使用例

📞 顧客コミュニケーションワークフロー

"30日間連絡がない'VIP'タグ付きの連絡先を検索し、新しいプレミアムサービスの提供についてパーソナライズされたSMSを送信する"

💰 販売パイプライン管理

"連絡先のJohn Smithに対して、価値$5000のプレミアムパッケージの商談を作成し、'Enterprise Sales'パイプラインに追加し、来週の火曜日にフォローアップの予定を設定する"

📊 ビジネスインテリジェンス

"前四半期のすべての請求書を取得し、支払いパターンを分析し、生涯価値を含む上位の支払い顧客のレポートを作成する"

🛒 eコマースオペレーション

"在庫が少ないすべての商品をリストアップし、在庫補充通知キャンペーンを作成し、'inventory-manager'タグ付きの連絡先に送信する"

📱 ソーシャルメディア自動化

"ブラックフライデーセールを告知するソーシャルメディア投稿を作成し、接続されているすべてのプラットフォームにスケジュールし、エンゲージメントメトリクスを追跡する"

🎯 マーケティング自動化

"最後のメールキャンペーンを開いたが購入しなかったすべての連絡先を見つけ、'warm-leads'ワークフローに追加し、フォローアップシーケンスをスケジュールする"

🔧 ローカル開発

前提条件

• Node.js 18以上（最新のLTSを推奨）
• APIアクセスを持つGoHighLevelアカウント
• 有効なAPIキーと拠点ID
• Claude Desktop（MCP統合用）

インストールとセットアップ

# リポジトリをクローンする
git clone https://github.com/mastanley13/GoHighLevel-MCP.git
cd GoHighLevel-MCP

# 依存関係をインストールする
npm install

# 環境ファイルを作成する
cp .env.example .env
# .envファイルにGHLの資格情報を設定する

# プロジェクトをビルドする
npm run build

# サーバーを起動する
npm start

# ホットリロードで開発する
npm run dev

環境構成

# 必要な環境変数
GHL_API_KEY=your_private_integrations_api_key_here  # プライベート統合から取得したキー、通常のAPIキーではない
GHL_BASE_URL=https://services.leadconnectorhq.com
GHL_LOCATION_ID=your_location_id_here              # 設定 → 会社 → 拠点から取得
NODE_ENV=production

# オプションの構成
PORT=8000
CORS_ORIGINS=*
LOG_LEVEL=info

利用可能なスクリプト

npm run build          # TypeScriptのコンパイル
npm run dev            # ホットリロードで開発サーバーを起動する
npm start              # 本番用のHTTPサーバーを起動する
npm run start:stdio    # Claude Desktop用のCLI MCPサーバーを起動する
npm run start:http     # Webアプリ用のHTTP MCPサーバーを起動する
npm test               # テストスイートを実行する
npm run test:watch     # ウォッチモードでテストする
npm run test:coverage  # カバレッジレポートを生成する
npm run lint           # TypeScriptのリントを実行する

テストと検証

# API接続をテストする
curl http://localhost:8000/health

# 利用可能なツールをリストする
curl http://localhost:8000/tools

# MCP SSEエンドポイントをテストする
curl -H "Accept: text/event-stream" http://localhost:8000/sse

🌐 デプロイメントガイド

🟢 Vercelデプロイメント（推奨）

オプション1: ワンクリックデプロイ

オプション2: 手動デプロイ

# Vercel CLIをインストールする
npm i -g vercel

# デプロイする
vercel --prod

# Vercelダッシュボードで環境変数を設定する
# 追加する: GHL_API_KEY, GHL_BASE_URL, GHL_LOCATION_ID, NODE_ENV

Vercel構成（vercel.json）:

{
  "version": 2,
  "builds": [
    {
      "src": "dist/http-server.js",
      "use": "@vercel/node"
    }
  ],
  "routes": [
    {
      "src": "/(.*)",
      "dest": "/dist/http-server.js"
    }
  ]
}

🚂 Railwayデプロイメント

# Railway CLIをインストールする
npm install -g @railway/cli

# ログインしてデプロイする
railway login
railway init
railway up

# Railwayダッシュボードを通じて環境変数を追加する

🎨 Renderデプロイメント

1. GitHubリポジトリを接続する
2. ビルドコマンドを設定する: npm run build
3. 起動コマンドを設定する: npm start
4. Renderダッシュボードで環境変数を追加する

🐳 Dockerデプロイメント

# イメージをビルドする
docker build -t ghl-mcp-server .

# コンテナを実行する
docker run -p 8000:8000 \
  -e GHL_API_KEY=your_key \
  -e GHL_BASE_URL=https://services.leadconnectorhq.com \
  -e GHL_LOCATION_ID=your_location_id \
  ghl-mcp-server

🔌 Claude Desktop統合

MCP構成

Claude Desktopのmcp_settings.jsonに以下を追加します。

{
  "mcpServers": {
    "ghl-mcp-server": {
      "command": "node",
      "args": ["path/to/ghl-mcp-server/dist/server.js"],
      "env": {
        "GHL_API_KEY": "your_private_integrations_api_key",
        "GHL_BASE_URL": "https://services.leadconnectorhq.com",
        "GHL_LOCATION_ID": "your_location_id"
      }
    }
  }
}

HTTP MCP統合

WebベースのMCPクライアントでは、以下のHTTPエンドポイントを使用します。

https://your-deployment-url.vercel.app/sse

📋 プロジェクトアーキテクチャ

ghl-mcp-server/
├── 📁 src/                    # ソースコード
│   ├── 📁 clients/            # APIクライアントの実装
│   │   └── ghl-api-client.ts  # コアのGHL APIクライアント
│   ├── 📁 tools/              # MCPツールの実装
│   │   ├── contact-tools.ts   # 連絡先管理（31のツール）
│   │   ├── conversation-tools.ts # メッセージング（20のツール）
│   │   ├── blog-tools.ts      # ブログ管理（7のツール）
│   │   ├── opportunity-tools.ts # 販売パイプライン（10のツール）
│   │   ├── calendar-tools.ts  # 予定管理（14のツール）
│   │   ├── email-tools.ts     # メールマーケティング（5のツール）
│   │   ├── location-tools.ts  # 拠点管理（24のツール）
│   │   ├── email-isv-tools.ts # メール検証（1のツール）
│   │   ├── social-media-tools.ts # ソーシャルメディア（17のツール）
│   │   ├── media-tools.ts     # メディアライブラリ（3のツール）
│   │   ├── object-tools.ts    # カスタムオブジェクト（9のツール）
│   │   ├── association-tools.ts # 関連管理（10のツール）
│   │   ├── custom-field-v2-tools.ts # カスタムフィールド（8のツール）
│   │   ├── workflow-tools.ts  # ワークフロー（1のツール）
│   │   ├── survey-tools.ts    # 調査管理（2のツール）
│   │   ├── store-tools.ts     # ストア管理（18のツール）
│   │   ├── products-tools.ts  # 商品管理（10のツール）
│   │   ├── payments-tools.ts  # 支払い管理（20のツール）
│   │   └── invoices-tools.ts  # 請求書と請求管理（39のツール）
│   ├── 📁 types/              # TypeScriptの型定義
│   │   └── ghl-types.ts       # 包括的な型定義
│   ├── 📁 utils/              # ユーティリティ関数
│   ├── server.ts              # CLI MCPサーバー（Claude Desktop用）
│   └── http-server.ts         # HTTP MCPサーバー（Webアプリ用）
├── 📁 tests/                  # 包括的なテストスイート
│   ├── 📁 clients/            # APIクライアントのテスト
│   ├── 📁 tools/              # ツール実装のテスト
│   └── 📁 mocks/              # テストモックとフィクスチャ
├── 📁 api/                    # Vercel APIルート
├── 📁 docker/                 # Docker構成
├── 📁 dist/                   # コンパイルされたJavaScript（自動生成）
├── 📄 ドキュメントファイル
│   ├── DEPLOYMENT.md          # デプロイメントガイド
│   ├── CLAUDE-DESKTOP-DEPLOYMENT-PLAN.md
│   ├── VERCEL-DEPLOYMENT.md
│   ├── CLOUD-DEPLOYMENT.md
│   └── PROJECT-COMPLETION.md
├── 📄 構成ファイル
│   ├── package.json           # 依存関係とスクリプト
│   ├── tsconfig.json          # TypeScriptの構成
│   ├── jest.config.js         # テスト構成
│   ├── vercel.json            # Vercelデプロイメント構成
│   ├── railway.json           # Railwayデプロイメント構成
│   ├── Dockerfile             # Dockerコンテナ化
│   ├── Procfile               # プロセス構成
│   └── cursor-mcp-config.json # MCP構成
└── 📄 README.md               # この包括的なガイド

🔐 セキュリティとベストプラクティス

環境セキュリティ

• ✅ APIキーをバージョン管理システムにコミットしないでください
• ✅ すべての機密データに環境変数を使用してください
• ✅ 適切なCORSポリシーを実装してください
• ✅ 定期的にAPIキーをローテーションしてください
• ✅ APIの使用状況とレート制限を監視してください

本番環境での考慮事項

• ✅ 適切なエラーハンドリングとロギングを実装してください
• ✅ 監視とアラートを設定してください
• ✅ すべてのデプロイメントにHTTPSを使用してください
• ✅ リクエストのレート制限を実装してください
• ✅ 定期的なセキュリティ更新を行ってください

APIレート制限

• GoHighLevel APIにはレート制限があります
• 指数バックオフを実装してください
• 頻繁にリクエストされるデータをキャッシュしてください
• 利用可能な場合はバッチ操作を使用してください

🚨 トラブルシューティングガイド

一般的な問題と解決策

ビルド失敗:

# キャッシュをクリアして再インストールする
rm -rf node_modules package-lock.json dist/
npm install
npm run build

API接続問題:

# API接続をテストする（プライベート統合APIキーを使用する）
curl -H "Authorization: Bearer YOUR_PRIVATE_INTEGRATIONS_API_KEY" \
     https://services.leadconnectorhq.com/locations/YOUR_LOCATION_ID

一般的なAPI問題:

• ✅ プライベート統合APIキーを使用していること（通常のAPIキーではない）
• ✅ プライベート統合で必要なスコープが有効になっていること
• ✅ 拠点IDがGoHighLevelアカウントと一致していること
• ✅ 環境変数が正しく設定されていること

Claude Desktop統合:

1. MCP構成の構文を検証する
2. ファイルパスが絶対パスであることを確認する
3. 環境変数が設定されていることを確認する
4. 変更後にClaude Desktopを再起動する

メモリ問題:

# Node.jsのメモリ制限を増やす
node --max-old-space-size=8192 dist/server.js

CORSエラー:

• CORS_ORIGINS環境変数を構成する
• 適切なHTTPヘッダーが設定されていることを確認する
• ドメインホワイトリストを確認する

パフォーマンス最適化

• 読み取り操作にレスポンスキャッシュを有効にする
• 大規模なデータセットにはページネーションを使用する
• コネクションプーリングを実装する
• メモリ使用量を監視し、適切に最適化する

📊 技術仕様

システム要件

• ランタイム: Node.js 18以上（最新のLTSを推奨）
• メモリ: 最小512MB RAM、推奨1GB以上
• ストレージ: アプリケーション用に100MB、ログ用に追加
• ネットワーク: API呼び出しに安定したインターネット接続

テクノロジースタック

• バックエンド: Node.js + TypeScript
• HTTPフレームワーク: Express.js 5.x
• MCP SDK: @modelcontextprotocol/sdk ^1.12.1
• HTTPクライアント: Axios ^1.9.0
• テスト: Jest with TypeScript support
• ビルドシステム: TypeScriptコンパイラ

API統合

• GoHighLevel API: v2021-07-28（連絡先）、v2021-04-15（会話）
• 認証: ベアラートークン
• レート制限: GHL APIの制限を尊重する
• エラーハンドリング: 包括的なエラー回復

パフォーマンスメトリクス

• コールドスタート: 2秒未満
• APIレスポンス: 平均500ms未満
• メモリ使用量: 基本的に約50-100MB
• ツール実行: 平均1秒未満

🤝 コントリビューション

GoHighLevelコミュニティからのコントリビューションを歓迎します！

開発ワークフロー

# リポジトリをフォークしてクローンする
git clone https://github.com/your-fork/GoHighLevel-MCP.git

# 機能ブランチを作成する
git checkout -b feature/amazing-new-tool

# テストを含めて変更を加える
npm test

# コミットしてプッシュする
git commit -m "Add amazing new tool for [specific functionality]"
git push origin feature/amazing-new-tool

# 詳細な説明付きでプルリクエストを作成する

コントリビューションガイドライン

• ✅ 新しいツールには包括的なテストを追加してください
• ✅ TypeScriptのベストプラクティスに従ってください
• ✅ 新しい機能についてドキュメントを更新してください
• ✅ すべてのリントチェックを通過させてください
• ✅ PRの説明に使用例を含めてください

コード標準

• TypeScriptのstrictモードを使用してください
• 既存の命名規則に従ってください
• すべての公開メソッドにJSDocコメントを追加してください
• 適切なエラーハンドリングを実装してください
• 統合テストを含めてください

📄 ライセンス

このプロジェクトは、ISCライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

🆘 コミュニティとサポート

ドキュメント

• 📖 完全なAPIドキュメント
• 🎥 ビデオチュートリアル
• 📋 ツールリファレンスガイド
• 🔧 デプロイメントガイド

ヘルプを得る方法

• 問題報告: GitHub Issues
• ディスカッション: GitHub Discussions
• APIリファレンス: GoHighLevel API Docs
• MCPプロトコル: Model Context Protocol

コミュニティリソース

• 💬 Discordコミュニティに参加する
• 📺 YouTubeチャンネルを購読する
• 📰 開発ブログをフォローする
• 🐦 Twitterで最新情報を得る

🎉 成功指標

この包括的なMCPサーバーは、以下の成果を達成します。

✅ 19カテゴリにわたる269のオペレーショナルツール

✅ 完全なAPIカバレッジを持つリアルタイムのGoHighLevel統合

✅ 複数のプラットフォームでの本番環境でのデプロイ可能

✅ 包括的なエラーハンドリングを備えたエンタープライズグレードのアーキテクチャ

✅ 完全な型定義を持つFull TypeScriptサポート

✅ 信頼性を保証する広範なテストカバレッジ

✅ Multi-Platform Deployment (Vercel, Railway, Render, Docker)

✅ MCPプロトコルに準拠したClaude Desktop統合

✅ 包括的なドキュメントを備えたコミュニティ主導の開発

---

🚀 GoHighLevelの自動化を革命的に変えましょう！

今すぐデプロイして、AIパワードのCRM管理の完全な可能性を解き放ちましょう！

---

💝 このプロジェクトをサポートする

このプロジェクトは、GoHighLevelコミュニティを支援するために何百時間もの開発作業を費やしています。もしこのプロジェクトがあなたの時間を節約し、ビジネスに役立っている場合は、その継続的な開発を支援することをご検討ください。

🎁 支援の方法:

• ⭐ このリポジトリにスターをつける - 他の人がこのプロジェクトを発見しやすくなります
• 🍕 ピザを奢ってくれる - Stripeを通じて寄付する
• 🐛 バグを報告する - みんなのためにこのプロジェクトを改善しましょう
• 💡 機能提案をする - 改善のアイデアを共有してください
• 🤝 コードをコントリビュートする - プルリクエストはいつでも歓迎です！

🏆 表彰:

• コントリビューターはプロジェクトに掲載されます
• 重要なコントリビューションには特別な表彰が与えられる場合があります
• このプロジェクトはコミュニティ主導で、コミュニティによってサポートされています

すべてのコントリビューションは、大きくても小さくても、このプロジェクトを生き続け、成長させる助けになります！ 🚀

---

自動化の力を理解する開発者によって、GoHighLevelコミュニティのために愛情を込めて作られました。