Jepto

Jepto MCP

Google Ads、Google Analytics 4（GA4）、Search Console、Meta Ads、Google Business Profile のデータを、Claude、ChatGPT、Cursor、Gemini CLI、Antigravity など、MCP（Model Context Protocol）に対応するあらゆるアプリで利用できます。キャンペーン、KPI、予算、クライアントについて自然な英語で質問すると、最新のデータに基づく回答を得られます。チャットから離れることなく、Jepto のレポートを一式作成できます。

https://mcp.jepto.com

Jepto はこれをホスト型のリモート MCP サーバーとして提供しているため、インストールや実行は不要です。このリポジトリはドキュメントです。少なくとも1つのデータソースを接続した Jepto アカウントが必要です。アカウントをお持ちでない場合は、14日間の無料トライアルを開始してください。

対象ユーザー

• マーケティングチーム：5つのダッシュボードを使い分ける代わりに、1つの会話で Google Ads、GA4、Search Console、Meta Ads の情報を知りたい方。
• 多数のブランドを管理する代理店やコンサルタント：Jepto アカウント内のすべてのブランドを、1つの接続で利用できます。
• 複数拠点を持つビジネス：拠点ごとの Google Business Profile の通話、ルート検索リクエスト、クチコミを追跡できます。
• エージェントを開発する開発者：OAuth、文書化されたデータモデル、変更ごとの確認ステップを備えたホスト型サーバーが必要な方。

接続

サーバー URL	https://mcp.jepto.com
トランスポート	Streamable HTTP
認証	PKCE を使用した OAuth です。接続時に Jepto に一度サインインします。
アクセス	Jepto アカウント：アプリでログインユーザーが閲覧できるすべてのクライアント

Claude

アプリディレクトリを開いて「Jepto」を検索するか、https://claude.ai/directory/jepto にアクセスしてください。

ChatGPT

サイドバーの Plugins を開いて「Jepto」を検索するか、https://chatgpt.com/plugins/jepto にアクセスしてください。

Claude Code

サーバーと、Claude がデータを見つけやすくするスキルを追加する Jepto プラグインをインストールします。

/plugin install jepto --marketplace jepto/mcp

2.1.275 より前のバージョンの Claude Code では、/plugin marketplace add jepto/mcp を実行してから、/plugin install jepto@jepto を実行してください。

サーバーのみを追加するには、次を実行します。

claude mcp add --transport http --callback-port 8787 jepto https://mcp.jepto.com

どちらの場合も、/mcp を実行し、jepto を選択してサインインしてください。Jepto のサインインはこのポートにのみ戻るため、--callback-port 8787 はそのままにしてください。

Gemini CLI

gemini extensions install https://github.com/jepto/mcp

その後、/mcp auth jepto を実行してサインインしてください。サインイン時にはお使いのコンピューターでブラウザーが開くため、SSH 経由ではなくローカルで実行してください。

Antigravity

agy plugin install https://github.com/jepto/mcp

その後、サインインしてください。CLI では、/mcp を開き、jepto を選択して Authenticate を選びます。Antigravity アプリでは、Agent settings を開き、Customizations に移動して、jepto の横にある Authenticate をクリックします。Jepto のログイン情報でサインインしたら、表示されたコードを Antigravity に貼り付けてください。

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "jepto": {
      "url": "https://mcp.jepto.com"
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "jepto": {
      "type": "http",
      "url": "https://mcp.jepto.com"
    }
  }
}

その他の MCP クライアント

「Add custom connector」または「リモートサーバー」を探し、URL を貼り付けてサインインしてください。クライアントは PKCE を使用した OAuth に対応している必要があります。API キーによる接続には対応していません。

質問できること

ツールを指定する必要はありません。質問すれば、アシスタントが適切なツールを選びます。クライアント、プラットフォーム、期間を明確にすると、より良い回答が得られます。

すべてを確認する

• 「アカウント全体で、重要またはリスクにさらされている KPI や予算はどれですか？」
• 「利用中のプランと、クライアント数を教えてください。」
• 「Google Ads と Facebook Ads を利用しているクライアントはどれですか？」

パフォーマンスを分析する

• 「Homer's Donuts の今四半期のコンバージョン率を、前四半期とチャネル別に比較してください。」
• 「Homer's Donuts の今月の日別の広告費と目標を表示してください。」
• 「四半期末までの Homer's Donuts の ROAS を予測してください。」

会議の準備をする

• 「Homer's Donuts について教えてください。何を販売していて、どのチャネルを運用していますか？」
• 「Homer's Donuts のターゲット層とブランドのトーンを教えてください。」
• 「Homer's Donuts の最新の戦略メモを表示してください。」

レポートを作成する

• 「先月分の Homer's Donuts の月次レポートを、Executive Overview、Paid Search、Organic Search のタブ構成で作成してください。」
• 「Paid Search タブにキャンペーンテーブルを追加し、広告費のグラフを縦棒グラフに切り替えてください。」
• 「ブランドテーマを適用し、このレポートのエグゼクティブサマリーを作成してください。」

変更を加える（必ず最初にプレビューします）

• 「Homer's Donuts の CPA KPI を作成してください。目標は 50 ドル未満、期間は月次です。」
• 「Homer's Donuts の予算を作成してください。65 日間で 1,500 ドル、すべての Google Ads キャンペーンが対象です。」
• 「Homer's Donuts の Google Ads アカウントで、ブランドキャンペーンを一時停止してください。」

プラットフォーム別の質問例

Google Search Console

• 「過去 90 日間で、平均掲載順位が 5 位から 15 位の間、表示回数が 1,000 回を超えるクエリを表示してください。」
• 「先月と比較して、今月クリック数が最も減少したページはどれですか？」
• 「過去 28 日間のクリック数と CTR を、デバイス別、国別に内訳表示してください。」

Google Analytics 4 (GA4)

• 「先月、最も多くのコンバージョンを獲得したランディングページはどれですか？」
• 「今四半期と前四半期のセッション数とコンバージョン率を、デフォルトのチャネルグループ別に比較してください。」
• 「過去 30 日間のセッションソース別の購入収益を教えてください。」

Google Ads

• 「先週、コンバージョン単価が最も高かったキャンペーンはどれですか？」
• 「過去 30 日間で、広告費が 100 ドルを超え、コンバージョンがなかった検索語句を表示してください。」
• 「今月のキャンペーンタイプ別の ROAS を教えてください。」

Meta Ads (Facebook and Instagram)

• 「過去 14 日間の Facebook と Instagram の広告費、CPM、リンククリック数を比較してください。」
• 「今月、フリークエンシーが最も高い広告はどれですか？」
• 「見込み顧客の獲得キャンペーンのリーチを、年齢別、性別別に内訳表示してください。」

Google Business Profile

• 「先月、電話とルート検索のリクエストが最も多かった店舗はどこですか？」
• 「すべての店舗の返信していないクチコミを表示してください。」
• 「今月、どの検索キーワードからビジネスプロフィールが見つかりましたか？」

プラットフォーム横断

• 「先月の Google Ads、Meta Ads、Microsoft Ads を合わせた広告費、クリック数、コンバージョン数を教えてください。」
• 「今月の広告予算の目標達成に向けて、順調に進んでいますか？」

ツール

読み取りツールはデータを返すだけで、変更は行いません。KPI、予算、プラットフォーム操作ツールはまずプレビューを表示します。チャットで確認するまで、Jepto に保存されたり、広告プラットフォームが変更されたりすることはありません。確認待ちの操作は約10分で期限切れになります。レポートツールは変更をすぐに保存するため、Jepto でレポートが完成していく様子を確認できます。

サーバーには43個のツールがあります。

ツール	機能	モード
account_info	アカウント名、プラン、ステータス、タイムゾーン、週の開始曜日、クライアント、KPI、予算の件数	読み取り
client_list	すべてのクライアントと、それぞれの clientId、名前、ドメイン	読み取り
client_info	クライアントのプロフィール：業種、所在地、製品とサービス、連絡先、ビジネスモデル	読み取り
client_knowledgebase	クライアントの保存済みメモ、ブリーフ、ブランドガイドラインを検索	読み取り
datasource_list	クライアントの接続済みデータソース、または Jepto がサポートするすべてのソースタイプ	読み取り
analytics_schema	クライアントが利用できる指標とディメンション	読み取り
analytics_query	指標、ディメンション、フィルター、日付範囲、期間比較、並べ替えを指定してライブデータをクエリ	読み取り
kpi_forecasting	KPI とその予測の一覧表示、読み取り、作成、更新、削除	読み取り＋書き込み（まずプレビュー）
budget_tracker	広告費予算の一覧表示、読み取り、作成、更新、削除	読み取り＋書き込み（まずプレビュー）
actions_list	実行可能なプラットフォーム操作の一覧と、その入力項目およびリスクレベル	読み取り
actions_execute	確認後にプラットフォーム操作を実行	書き込み（まずプレビュー）
skills_list	Jepto のスキル一覧：アシスタントが従うことのできるタスクガイド	読み取り
skills_get	1つのスキルの全手順	読み取り
help_article	Jepto ヘルプセンターを検索、または記事を取得	読み取り
web_search	外部情報を得るために公開ウェブを検索	読み取り
web_fetch	URL で指定した公開ウェブページを読み取り	読み取り

レポートツール

ツール	機能	モード
report_list	アカウント、または指定したクライアントのレポートを一覧表示します	読み取り
report_get	レポートを読み込みます。タブ、レイアウト、カード、エディター、プレビュー、公開リンクが含まれます	読み取り
report_create	レポートとすべてのタブを作成します（カードを追加できる空の状態）	書き込み
report_update	レポートのタイトル、説明、日付範囲、テーマを変更します	書き込み
report_delete	レポートを削除します	書き込み
report_page_get	1つのタブとそのレイアウトを読み込みます	読み取り
report_page_create	レポートにタブを追加します	書き込み
report_page_update	タブのタイトル、説明、レイアウトを変更します	書き込み
report_page_delete	タブを削除します	書き込み
report_card_get	1つのカードの設定を読み込みます	読み取り
report_card_generate	データモデルのフィールドまたは自然言語のプロンプトから、データを確認したうえでグラフまたは表カードを作成します	書き込み
report_card_create	Markdown、HTML、画像、分析、日付フィルターのカードを作成します	書き込み
report_card_update	カードの指標、グラフの種類、比較、パレット、タブを変更します	書き込み
report_card_delete	カードを削除します	書き込み
report_analysis_run	Jepto のレポート分析エージェントでレポートの分析を作成します	書き込み
report_analysis_list	レポートに保存された分析を一覧表示します	読み取り
report_analysis_save	分析テキストをレポートに保存します	書き込み
report_theme_list、report_theme_get	テーマを一覧表示するか、1つ読み込みます	読み取り
report_theme_create、report_theme_update、report_theme_delete	テーマを作成、変更、削除します	書き込み
report_palette_list、report_palette_get	カラーパレットを一覧表示するか、1つ読み込みます	読み取り
report_palette_create、report_palette_update、report_palette_delete	パレットを作成、変更、削除します	書き込み

ページ、カード、レポートの更新時には、最後に保存されたバージョンを確認するため、アシスタントが他のユーザーの変更を上書きすることはありません。グラフの種類は、数値、折れ線、面、棒、縦棒、ドーナツ、散布図です。マップカードは、まだ MCP 経由では利用できません。Jepto MCP でレポートを作成するをご覧ください。

プラットフォームアクション

現在、カタログには2つの Google Ads アクションがあります。どちらもリスクは中程度で、元に戻すことができます。

• googleAdsPauseCampaign：キャンペーンを一時停止します。広告配信は直ちに停止します。
• googleAdsEnableCampaign：一時停止中のキャンペーンを再開します。広告配信は直ちに再開します。

今後、さらにアクションが追加される予定です。利用可能なアクションは、常に actions_list で確認できます。

アシスタントがデータを見つける方法

通常は、client_list → datasource_list → analytics_schema → analytics_query の順に使用します。レポートを作成する場合は、続けて report_create を呼び出し、report_card_generate でカードを追加し、report_page_update で配置します。最後に report_analysis_run を実行して仕上げることもできます。フィールド名には、Jepto Reports や Data Chat と同じものを使用します。たとえば、googleAds.spend や googleAds.campaignName です。日付には last30days、yesterday、30DaysAgo などのトークンのほか、ISO 形式の日付を指定できます。データモデルとデータクエリをご覧ください。

データソース

MCP では、Jepto アカウントに接続されているデータソースを利用できます。

• 広告： Google Ads、Facebook Ads、Instagram Ads、Microsoft Ads、LinkedIn Ads、TikTok Ads、X (Twitter) Ads
• アナリティクスと検索： Google Analytics 4、Google Search Console
• ローカル： Google Business Profile
• E コマース： Shopify (beta)
• 財務： Xero
• AI 検索： Jepto AI Visibility
• 独自データ： Jepto に接続した BigQuery テーブル

各データソースのページには、質問例と Jepto のデータモデルに含まれるすべての指標およびディメンションが記載されています。

データソース	指標	ディメンション	フィールドリファレンス
Google Ads	12	69	google-ads/
Google Analytics 4	30	28	google-analytics-4/
Google Search Console	4	6	google-search-console/
Google Business Profile	29	70	google-business-profile/
Facebook Ads	17	19	facebook-ads/
Instagram Ads	20	18	instagram-ads/
LinkedIn Ads	98	26	linkedin-ads/
Microsoft Ads	85	41	microsoft-ads/
TikTok Ads	203	55	tiktok-ads/
X Ads	3	3	x-ads/
Xero	20	55	xero/
AI Visibility	50	87	ai-visibility/

MCP にサインインしても、新しいプラットフォームは接続されません。まず Jepto でデータソースを接続してください。

セキュリティと権限

• Jepto のログイン情報でサインインします。すべてのツール呼び出しは、アプリで付与されているものと同じ権限で実行されます。
• 接続は特定のクライアントではなく、Jepto アカウント全体を対象とします。clientId を指定しない場合、一覧表示ツールはログインユーザーがアクセスできるすべての情報を返します。
• アクセストークンの有効期間は 60 分、リフレッシュトークンの有効期間は 30 日で、リフレッシュのたびにローテーションされます。
• Google、Meta などのプラットフォームの認証情報は Jepto 内に保持されます。AI クライアントや会話に送信されることはありません。
• KPI、予算、プラットフォームのアクションの変更には、プレビューと確認の手順があります。レポートの変更はすぐに保存され、Jepto 内に保持されます。
• Claude では、各ツール呼び出しの前に承認を求めるよう設定できます。

詳しくは、OAuth と認証をご覧ください。

リンク

• Jepto MCP
• Jepto MCP サーバーの概要
• Jepto MCP でレポートを作成する
• Jepto データモデル
• Jepto データクエリ
• OAuth と認証
• 料金
• サポートを受ける

ライセンス

このリポジトリのドキュメントは MIT ライセンスで提供されています。Jepto MCP サーバーの利用には、Jepto 利用規約が適用されます。