このページの内容
要点
- GoHighLevelには公式のMCPサーバーがあり、Claude、Cursor、n8nなどのAIツールからアカウントの読み書きができます。
- このガイドでは、各AIツールの接続、公式とコミュニティ版の比較、セキュリティ、代理店向けの実例プロンプトを1ページにまとめています。
- どのGoHighLevelプランでも無料です。必要なのはPrivate Integration Tokenと、約5分の時間だけです。
コマンドと設定は、2026-08-10に公式のGoHighLevelドキュメントで最終確認しました。
ツールを選ぶ
- 非エンジニア向けMCP入門。MCPが初めてなら、トークンを触る前にまずこちらでやさしい説明を読んでください。
- ClaudeをGoHighLevelに接続する。Claude専用の手順です。トークンの作成から最初のプロンプトまで進みます。
- ChatGPTをGoHighLevelに接続する。多くのプランでは、公式MCPサーバーはまだありません。今使える、カスタムGPTとZapierの方法です。
GoHighLevel MCPサーバーとは
MCPは、Model Context Protocolの略です。AIツールが、名前の付いたツールを通じて外部のサービスを呼び出すための、オープンな標準規格です。GoHighLevel MCPサーバーは、その入口のGoHighLevel公式版です。接続すると、ダッシュボードをクリックしなくても、AIアシスタントがGoHighLevelのアカウントを直接操作できます。
サーバーのエンドポイントは1つで、https://services.leadconnectorhq.com/mcp/ です。アカウントの主要な部分に届きます。コンタクト、会話、カレンダー、商談、決済、ロケーション、SNS投稿、ブログ、メールです。AIにどこまで触らせるかは、トークンを作るときに自分で決めます。与えた以上の権限が、AIに渡ることはありません。
たとえば、GoHighLevelを開いてリードを探す代わりに、Claudeに「今週返信があって、まだ通話を予約していないリードを探して」と頼めます。答えは、アカウントからその場で取得されます。MCPサーバーがあるから、これができます。
何を自動化できるか
実際には、多くの人が決まった作業のためにつなぎます。具体例を挙げます。
- コンタクトの仕分け。 返信したのに予約していないリードを、パイプラインを手でスクロールせずに探します。
- パイプラインの更新。 ダッシュボードをクリックせず、普通の言葉で頼んで商談を作成したり、適切なステージに移したりします。
- 会話のダイジェスト。 1週間分のメッセージを要約し、購入に前向きな人や不満そうな人を、月曜の振り返りの前に拾い出します。
- 通話の準備。 電話をかける直前に、コンタクトの履歴をすべて短いメモにまとめます。
- リストの整理。 特定のタグが付いたコンタクトをすべて取り出し、商談がまだ開いている人を確認します。
どれも、トークンに設定したスコープの範囲内で動きます。AIが触れるのは、許可したモジュールだけです。プロンプトの詳しい例は、このページの後半にあります。
無料かどうかと、必要なもの
はい、公式MCPサーバーは、どのGoHighLevelプランでも無料です。MCPの追加料金はありません。混乱しやすいのは、接続するAIツール（Claude、Cursorなど）に別の料金があるためです。GoHighLevel側には、通常の利用料以外にかかる費用はありません。
必要なものは3つで、設定は約5分で終わります。
- GoHighLevelのアカウント（どのプランでも可）。
- 設定画面で作るPrivate Integration Token（次の手順で説明します）。
- Location ID。AIに作業させるサブアカウントを指定するIDです。
ステップ1：Private Integration Tokenを作る
GoHighLevelで、Settings、Private Integrations、Create New Integration の順に進みます。分かりやすい名前を付けてください（例：「Claude MCP, Acme client」）。必要なスコープだけを選んでから、トークンをコピーします。
重要：必ずPrivate Integration Tokenを使ってください。
トークンは pit- で始まります。通常のAPIキーや古いv1のAPIキーは使えず、401エラーの一番の原因です。トークンは1回しか表示されません。画面を閉じる前に、安全な場所にコピーしてください。
無理のない最小限のスコープ
多くの代理店業務では、読み取り専用から始め、AIに変更させたい部分にだけ書き込みスコープを足します。安全な出発点は、コンタクト、会話、商談の読み取り権限です。設定に慣れてから、コンタクトと商談の書き込み権限を足します。はっきりした理由がなければ、削除のスコープは外したままにしてください。データを消せるスコープがあるためです。
ステップ2：Location IDを調べる
Location IDは、AIが作業するサブアカウントを指定するIDです。調べ方は2つあります。
- アプリで：Settings、Company、Locations の順に進み、使いたいアカウントのIDをコピーします。
- URLから：サブアカウントを開き、アドレスバーからIDを読み取ります。
/location/の後ろにある長い文字列です。
公式ドキュメントの補足です。locationId ヘッダーは任意です。下の例のようにヘッダーで渡すこともできますし、省略してプロンプトの中でロケーションを指定することもできます。1つのアカウントだけで作業するなら、ヘッダーで設定するほうが簡単です。
ステップ3：AIツールを接続する
最近のAIツールの多くは、HTTPでMCPを使えます。そのため設定の形はどれもほぼ同じです。エンドポイント、トークンを入れたAuthorizationヘッダー、そして任意のLocation IDヘッダーです。以下は、Cursor、Windsurf、OpenAI Playgroundで使う基本設定です。
基本のHTTP設定（Cursor、Windsurf、OpenAI Playground）
{
"mcpServers": {
"ghl": {
"url": "https://services.leadconnectorhq.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_PIT_TOKEN",
"locationId": "YOUR_LOCATION_ID"
}
}
}
}Claude Code
Claude Codeは、MCPの設定を ~/.claude.json に保存します。上の ghl ブロックを mcpServers の下に追加するか、claude mcp add を実行して、聞かれたらエンドポイントとヘッダーを貼り付けます。Claude Codeを再起動し、/mcp と入力して、GoHighLevelのツールが表示されるか確認してください。
Claude Desktop
Claude Desktopは、まだHTTPで直接つなげません。そのため mcp-remote というnpxのラッパーを使います。HTTPサーバーを、Claude Desktopが期待するローカル接続につなぐ役目です。次の内容をClaude Desktopの設定に追加し、アプリを再起動してください。この部分は最も変わりやすいので、設定するときに公式ドキュメントで現在の方法を確認してください。
Claude Desktopの設定（mcp-remoteラッパー）
{
"mcpServers": {
"ghl": {
"command": "npx",
"args": [
"mcp-remote",
"https://services.leadconnectorhq.com/mcp/",
"--header",
"Authorization: Bearer YOUR_PIT_TOKEN",
"--header",
"locationId: YOUR_LOCATION_ID"
]
}
}
}CursorとWindsurf
どちらもHTTPで直接つながります。MCP設定を開き、この節の最初にある基本設定を追加して保存します。エディタを再読み込みすると、GoHighLevelのツールが一覧に表示されます。何も表示されないときは、トークンが pit- で始まっているか、もう一度確認してください。
Gemini CLI
同じサーバーのブロックを、Gemini CLIの設定ファイルのMCPサーバーの項目に追加します。エンドポイントとAuthorizationヘッダーを使います。CLIを再起動し、MCPの一覧コマンドで接続を確認してください。なお、GeminiはJavaScriptを実行できる唯一のAIクローラーでもありますが、今回のMCP接続とは関係ありません。
OpenAI Playground
PlaygroundでリモートのMCPサーバーを追加し、エンドポイントを貼り付けて、Authorizationヘッダーを Bearer YOUR_PIT_TOKEN に設定します。保存すると、そのセッションでモデルがGoHighLevelのツールを使えるようになります。
n8nに接続する
n8nは、専用プラグインなしで接続できます。ワークフローにMCP Clientノードを追加し、URLを https://services.leadconnectorhq.com/mcp/ にして、HTTP Streamableトランスポートを選び、pit- トークンを使ったヘッダー認証を設定します。n8nは新しいバージョンが必要です（執筆時点で1.104以降）。Streamableの選択肢が表示されない場合は、先にn8nを更新してください。
これで、ワークフロー内のどのAIエージェントノードからも、GoHighLevelのツールが使えます。GoHighLevelの操作を、n8nがつなげる数百のアプリと組み合わせられます。
開発者向け
自分でエージェントを作る場合、公式ドキュメントにPythonのLangChainとLangGraphの例があります。MCPアダプターがGoHighLevelのツールをすべて読み込み、エージェントはほかのツールと同じように呼び出せます。形は次のとおりです。
Python：GoHighLevel MCPサーバーを使うLangGraphエージェント
# pip install langchain-mcp-adapters langgraph langchain-openai
import asyncio
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
async def main():
client = MultiServerMCPClient({
"ghl": {
"url": "https://services.leadconnectorhq.com/mcp/",
"transport": "streamable_http",
"headers": {
"Authorization": "Bearer YOUR_PIT_TOKEN",
"locationId": "YOUR_LOCATION_ID",
},
}
})
tools = await client.get_tools()
agent = create_react_agent("openai:gpt-4.1", tools)
result = await agent.ainvoke(
{"messages": "List my 5 most recent contacts"}
)
print(result["messages"][-1].content)
asyncio.run(main())同じアダプターは、NodeやほかのLangChainランタイムでも使えます。公式サーバーがまだカバーしていないGoHighLevelのエンドポイントを包む、自作サーバーを作りたい場合は、自作MCPサーバーのレシピを見てください。
公式サーバーとコミュニティサーバー
GoHighLevelの公式サーバーが、最初の選択肢です。コミュニティも、GitHubでオープンソースのMCPサーバーを作っています。APIをより広く包んでいるので、ツールの数はずっと多いです。ただし非公式でサポートはなく、自分でホストします。正直な比較は次のとおりです。
| 項目 | 公式サーバー | コミュニティサーバー |
|---|---|---|
| ツール数 | 約36個で、250個以上を目指して増加中 | ずっと多い（520個以上のものや269個以上のものがある） |
| サポート | GoHighLevelがサポート | コミュニティのみ。公式サポートなし |
| ホスティング | GoHighLevelが運用。自分で動かすものはなし | 自分でホストして保守する |
| 費用 | プランに含まれ無料 | コードは無料。ホスティングと保守は自己負担 |
| 向いている人 | ほぼ全員。初日から使える | 公式にないツールが必要な人 |
目安は、まず公式から始めることです。本当に足りないものがあって初めて、コミュニティサーバーを検討してください。その場合は、ホスティングと運用上のセキュリティを自分で負うことになります。
組み込みのAsk AIと外部のMCPサーバー
GoHighLevelのアプリ内には、Ask AIがあります。ダッシュボードで作業しながら、手早く助けてもらうのに向いています。MCPサーバーは別のものです。自分のAIツールが、外からアカウントに触れるようにします。アプリ内の質問にはAsk AIを使います。GoHighLevelを、自分で管理するより大きなAIワークフローの一部にして、ほかのツールとつなげたいときは、MCPサーバーを使います。
実例のプロンプト
接続したら、普通の言葉でアカウントに話しかけられます。次の5つのプロンプトは、代理店の実際の仕事に使えます。
- 見込みの高いリードを探して、フォローアップを下書きする。 「過去7日間に返信があって、予約がないコンタクトを探して、それぞれに短いフォローアップ文を下書きして」。うまくいくと、リードごとに合わせた文面が付いた短いリストが返り、そのまま送れます。
- 商談を作成する。 「Jane DoeのSalesパイプラインで、Proposalステージ、金額2,500ドルの商談を新しく作って」。ステージと金額が正しく設定された新しい商談が返ります。
- 1週間の会話を要約する。 「今週の会話をすべて要約して、不満そうな人に印を付けて」。ダイジェストと、注意が必要な人の短いリストが届きます。
- タグを整理する。 「trial-expiredタグが付いたコンタクトを一覧にして、商談がまだ開いている人を教えて」。再アプローチの前に役立ちます。
- 通話の準備をする。 「このメールアドレスのコンタクトの履歴をすべて取り出して、通話前に3行でまとめて」。コンタクト、会話、商談を読み、要約を渡してくれます。
サブアカウントが複数ある代理店へ
代理店からいちばんよく聞かれる質問です。クライアントのサブアカウントごとに、Private Integration Tokenを1つ使ってください。トークンは1つのロケーションに紐づくので、クライアントごとに分ければ、データが完全に分かれます。1社だけ無効にしても、ほかに影響しません。
取り違えないよう、トークンにはクライアント名を付けます。特定のクライアント向けにAIツールを接続するときは、そのクライアントのトークンとLocation IDを使います。クライアントが契約をやめたら、そのトークンを無効にすればアクセスは消えます。1つのトークンを複数のクライアントで共有すると、この分離が崩れます。避けてください。
MCPサーバーを使うには、GoHighLevelのアカウントが必要です。私たちのリンクから、30日間のトライアルを始められます。
セキュリティとトークンの更新
不安は本物です。AIがコンタクトを削除したり、クライアントのアカウントを壊したりしないか、心配する人は多いです。解決策は信頼ではなく、アクセス制御です。AIができるのは、トークンのスコープが許すことだけです。
- 最小限の権限にする。 必要なスコープだけを選びます。本当に必要でなければ、削除のスコープは外します。読み取り専用のトークンでは、何も変更できません。
- 90日ごとに更新する。 新しいトークンを作り、設定を更新し、接続を確認してから、古いトークンを手放します。ローテーション機能では、切り替え中も古いトークンが7日間使えるので、止まることはありません。
- クライアントごとに1つのトークン。 トークンを分けておけば、1回の無効化で、1社のアクセスだけをきれいに外せます。
- 漏れたらすぐ無効にする。 トークンが漏れたときは、次の更新まで待たずに、すぐ無効にします。
古いv1のAPIキーは非推奨になっています。これも、Private Integration Tokenが必須になった理由の1つです。
MCPとZapierの違い
解決する問題が違います。Zapierのようなツールは、決まった流れで動く自動化に向いています。Xが起きたらYをする、という形です。MCPサーバーは、頼まれた内容をもとにアシスタントが取る行動を決める、自由度の高いAIの作業に向いています。両方を使う人も多いです。決まった流れにはZapier、AI主導の作業にはMCPです。
自動化の手段として、Zapier、Make、n8n、直接APIのどれにするか迷っている場合は、Zapier、Make、n8n、直接APIの比較レシピで詳しく説明しています。
トラブルシューティング
- キーの種類が違って401になる。 トークンは
pit-で始まる必要があります。通常のAPIキーや古いAPIキーでは401になります。Private Integrationsでトークンを作り直してください。 - 非推奨のv1キー。 古いv1のAPIキーは、MCPではもう使えません。Private Integration Tokenに切り替えてください。
- Location IDがない、または間違っている。 操作が別のアカウントに行く、または失敗する場合は、
locationIdヘッダーを確認するか、プロンプトでロケーションを指定してください。 - レート制限。 短時間に集中すると、制限に当たることがあります。繰り返しの呼び出しを減らすか、作業をまとめて行ってください。
- 古いセッション。 ツールが反応しなくなったら、AIツールを再起動してセッションをクリアし、つなぎ直してください。