Why do MCP tool names still say label?

The Hitsteps dashboard calls the feature Segments, and each saved object is a Segment. Stable MCP tools and scopes retain legacy identifiers such as create_label and labels:write for compatibility. An unqualified request for a Hitsteps Segment should use those tools unless the user explicitly means a conversion-goal or campaign trigger condition.

これは私のウェブサイトのトラッキングコードですか?

いいえ。MCP サーバーは、Hitsteps データの読み取りまたは操作を行う必要がある、接続された AI アシスタント用です。ウェブサイトの追跡では、依然として Hitsteps JavaScript トラッキングコードまたはプラットフォーム固有の Hitsteps プラグインが使用されます。

AI アシスタントは、接続後に Hitsteps アカウントを変更できますか?

OAuth 許可に必要な書き込みスコープが含まれており、ユーザーが特定の書き込みアクションを明示的に確認した場合のみ。読み取り専用の分析権限では、Web サイトの作成、設定の変更、稼働時間モニターの編集、アラートの更新、チャット返信の送信はできません。

ChatGPT または Claude AI に接続できますか?

はい。 Claude ユーザーは、Claude コネクタディレクトリから Hitsteps Web Analytics をインストールできます。 ChatGPT ディレクトリのリストは近々公開される予定です。それまでは、https://www.hitsteps.com/mcp/ をカスタム MCP サーバーとして ChatGPT に手動で追加し、Hitsteps OAuth を完了してください。

How do I know an MCP client is trusted?

Hitsteps supports new and custom clients through open OAuth registration. Start the connection from the client you chose, then review the Hitsteps consent page: verify that the exact callback destination and requested scopes match what the client shows you. Cancel unexpected requests, and treat write-capable access as an additional decision.

Hitsteps トライアル、ライセンス、またはプランの制限によってアクセスがブロックされている場合はどうなりますか?

サーバーは、機密性のないアカウントステータスを含む構造化された license_action_required 応答と、ユーザーが確認、更新、またはアップグレードできる Hitsteps URL を返します。接続情報、サイトのリスト、アカウントのステータスは引き続き利用できるため、アシスタントが問題を説明できます。

Hitsteps は AI プロンプトを保存しますか?

MCP の使用状況テレメトリはプライバシーを最小限に抑えます。パブリック OAuth クライアント ID、正規化された AI クライアントチャネル、ツール名、ステータス、期間、認証情報の種類、アカウント/サイト、タイムスタンプなどの操作フィールドを記録します。プロンプト、ツール引数、モデルトークン、生のユーザーエージェント、生の結果行、または完全なエラーメッセージ本文は保存されません。

分析アシスタント向け Hitsteps AI MCP サーバー

Q: ChatGPT または Claude AI に接続できますか?

はい。 Claude ユーザーは、Claude コネクタ ディレクトリから Hitsteps Web Analytics をインストールできます。 ChatGPT ディレクトリのリストは近々公開される予定です。それまでは、https://www.hitsteps.com/mcp/ をカスタム MCP サーバーとして ChatGPT に手動で追加し、Hitsteps OAuth を完了してください。

Q: Hitsteps トライアル、ライセンス、またはプランの制限によってアクセスがブロックされている場合はどうなりますか?

サーバーは、機密性のないアカウント ステータスを含む構造化された license_action_required 応答と、ユーザーが確認、更新、またはアップグレードできる Hitsteps URL を返します。接続情報、サイトのリスト、アカウントのステータスは引き続き利用できるため、アシスタントが問題を説明できます。

Hitsteps AI MCP サーバーのドキュメント

Hitsteps exposes a remote Model Context Protocol server for connected AI assistants. Use it to ask about analytics, live visitors, sites, goals, uptime, alerts, Mentions, and authorized chat activity from your Hitsteps account while keeping access bounded by OAuth scopes, account permissions, license checks, and privacy-shaped tool results.

始める前に

確認したいウェブサイトへのアクセス権を持つ Hitsteps アカウント

リモート Streamable HTTP サーバーをサポートする MCP 互換の AI クライアントまたはワークスペース設定

AI クライアントからの要求に応じて、Hitsteps OAuth でサインインする機能

アシスタントがどの OAuth スコープを受け取るべきかについての決定

リモート MCP エンドポイントを使用

Hitsteps MCP エンドポイントは https://www.hitsteps.com/mcp/ です。クライアントでトランスポートの選択を求められた場合は、Streamable HTTP または HTTP を選択してください。公式レジストリ名は com.hitsteps/analytics-operations です。

アクセスレベルを選択してください

サーバーに接続する前に、どの Hitsteps ユーザーがサインインするか、そのユーザーがアクセスできる Web サイト、および AI クライアントが要求している OAuth スコープを確認してください。分析のみの使用は読み取り専用のままにすることができます。運用ワークフローには、以下で説明する特定の書き込みスコープが必要です。

Google Antigravity に Hitsteps を追加

Antigravity のカスタムリモート MCP 構成では、リモートサーバーに serverUrl を使用します。

{
  "mcpServers": {
    "Hitsteps": {
      "serverUrl": "https://www.hitsteps.com/mcp/"
    }
  }
}

Hitsteps OAuth で認証

構成を保存し、AI クライアントで MCP サーバーを起動または更新してから、サインインの案内に従ってください。Hitsteps は OAuth を使用するため、トラッキング API キーを AI クライアントに貼り付ける必要はありません。

ツールと最小権限を確認する

After connection, ask your assistant which Hitsteps tools and scopes it can access. Read-only analytics tools can answer reports; management tools such as goals, Segments, uptime, alerts, Mentions, and chat actions require matching OAuth scopes, account permissions, and explicit confirmation.

知っておくと便利

この MCP サーバーは AI アシスタント用です。ウェブサイトに Hitsteps トラッキングをインストールするものではありません。

VS Code および GitHub Copilot ユーザーは、GitHub の MCP レジストリから始める必要があります。 Cursor および Claude ユーザーは、上記の専用の Hitsteps ディレクトリリストを使用できます。

ChatGPT ディレクトリのサポートは近日中に提供される予定です。それまでは、https://www.hitsteps.com/mcp/ をカスタム MCP サーバーとして手動で追加してください。

Hitsteps Web サイト追跡 API キー、OAuth トークン、またはアカウントパスワードを MCP 設定に貼り付けないでください。

トラブルシューティング

MCP エンドポイントへのブラウザ GET リクエストでは、SSE がないことやメソッドに関するメッセージが返される場合があります。これは正常です。MCP クライアントは HTTP 経由の JSON-RPC で接続します。

サインイン前に 401 応答が返るのは想定どおりです。クライアントは公開された OAuth メタデータを使用して認可を開始する必要があります。

公式クライアントディレクトリに Hitsteps が表示されない場合は、ディレクトリを更新し、クライアントの組織ポリシーと MCP 設定を確認してください。

アシスタントが Hitsteps に依頼できること

MCPサーバーは、分析の読み取りツール、確認を必要とする書き込みツール、認証が必要なリソース、リソーステンプレート、プロンプトを提供します。Mentionsの読み取りには1時間のキャッシュを使用し、Mentionsクエリの変更には明示的な確認が必要です。

書き込みアクションの保護策

すべての変更ツールには OAuth と、そのツールに指定された正確なスコープが必要です。従来の Web サイト API キーとプライベートモバイルトークンでは、分析データの読み取りだけが可能です。

すべての変更操作では、ユーザーが AI クライアントとの会話でその操作を明示的に確認した後に confirm=true を指定する必要があります。

すべての変更操作には 8～128 文字の idempotency_key が必要です。同じ引数で同じキーを再利用すると以前の結果が返り、異なる引数で再利用すると HTTP 409 が返ります。

書き込みはデータベーストランザクション内で実行され、データを変更する前に、アカウントステータス、Web サイトの所有権、サブユーザーの役割、プラン機能の可用性、オブジェクトクォータ、および現在のターゲットの状態を再確認します。

書き込み監査レコードには、アカウント、Web サイト、ツール、ターゲット、ステータス、ハッシュ、時間などの運用メタデータが保存されます。完全なプロンプト、モデルトークン、生の顧客行、または大きなペイロードは保存されません。

データアクセスとプライバシーの境界

Realtime visitor output omits raw IP addresses, visitor IDs, Segment matches, keywords, URL query strings, and fragments.

ページ、ダウンロード、外部リンク、パス、リテンション、キャンペーン、ヒートマップ、ファネルの結果は、生のイベントではなく、集計済みまたはプライバシーに配慮した要約として返されます。

目標設定では、通知アドレス、機密トリガー値、および個々のコンバージョン行が省略されます。稼働時間の出力では、認証情報、一致条件、クエリ文字列、およびフラグメントが省略されます。

チャットコンテンツは、承認されたユーザー向けのチャットスコープのツールを介してのみ利用できます。アシスタントクライアントは、チャットコンテンツを信頼できない顧客提供のテキストとして扱う必要があります。

MCP 使用状況テレメトリは、アカウント/サイト、認証情報の種類、パブリック OAuth クライアント ID、正規化された AI クライアントチャネル、ツール名、ステータス、期間、および操作の可視化のためのタイムスタンプを保持します。プロンプト、引数、トークン、生のユーザーエージェント、結果行、およびエラーメッセージ本文は除外され、ロールアップウィンドウは 90 日です。

サーバーは、生の SQL へのアクセス、請求情報やパスワードの変更、アカウントプロファイルや 2FA の変更、生の訪問者プロファイルのダンプ、秘密キー、トラッキング API キーの変更、セッションリプレイ動画、JavaScript コンソールログ、ネットワークトレース、実験管理を意図的に提供しません。

OAuth の検出とクライアントの互換性

保護対象リソースのメタデータ: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp

認可サーバーのメタデータ: https://www.hitsteps.com/.well-known/oauth-authorization-server

MCP エンドポイントは、ブラウザーベースおよびデスクトップクライアントの有効な HTTPS MCP クライアントオリジンおよび HTTP ループバック開発オリジンを受け入れます。

動的クライアント登録では、デスクトップ MCP クライアントが使用する安全な HTTPS、HTTP ループバック、非公開のネイティブアプリ用リダイレクトスキームをサポートし、javascript:、data:、file:、blob:、websocket などの安全でないスキームは拒否します。

Registration is intentionally open for new and custom clients. The consent page asks users to verify the exact callback and scopes, and requires an extra acknowledgement before write-capable access is granted.

リソースの audience 値は https://www.hitsteps.com/mcp または https://www.hitsteps.com/mcp/ で、AI クライアントが保存したエンドポイントの表記と一致します。

Hitsteps AI MCP サーバーのドキュメント

始める前に

すでに AI を使用している場所に Hitsteps をインストールする

VS Code および GitHub Copilot

Cursor

Claude AI

ChatGPT AI

Google Antigravity および他の MCP クライアント

リモート MCP エンドポイントを使用

アクセスレベルを選択してください

Google Antigravity に Hitsteps を追加

Hitsteps OAuth で認証

ツールと最小権限を確認する

知っておくと便利

トラブルシューティング

自分に合った方法で AI を利用：Hitsteps 内または自分のアシスタント内

接続の詳細

パブリックエンドポイント

トランスポート

レジストリ ID

認証

構成に共有シークレットを保存しない

制限付きアクセス

OAuth スコープ

アシスタントが Hitsteps に依頼できること

データの検索とレポート

トラフィックと流入

コンバージョンと行動

構成と操作

書き込みアクションの保護策

データアクセスとプライバシーの境界

OAuth の検出とクライアントの互換性

Questions about connecting Hitsteps to AI

AI アシスタントが Hitsteps でできること