ClickStack MCPサーバー

ClickStack には、AIアシスタントがオブザーバビリティデータを操作できる組み込みの Model Context Protocol (MCP) サーバーが含まれています。接続すると、AIアシスタントは自然言語ですべて操作でき、ログ、トレース、メトリクスのクエリ実行、ダッシュボードやアラートの管理、データソースの確認、保存済み検索の利用が可能です。

これにより、Claude Code、Cursor、または任意の MCP 対応クライアントを使って、開発環境を離れることなく、インシデントの調査、ダッシュボードの作成、オブザーバビリティ環境の管理を行えます。

MCPサーバーは、以下の ClickStack のデプロイ形態で利用できます。

ClickStack on ClickHouse Cloud は、Cloud MCP エンドポイント https://mcp.clickhouse.cloud/clickstack 経由で接続し、OAuth 2.0 で認証します。このエンドポイントでは API key 認証はサポートされていません。

• ClickStack が有効になっている稼働中の ClickHouse Cloud サービス
• サービスで MCP を有効にする — Cloud コンソールを開き、Connect をクリックして Connect with MCP を選択し、トグルをオンにします

https://mcp.clickhouse.cloud/clickstack

認証には OAuth 2.0 を使用します。MCP client が初めて接続する際に、ClickHouse Cloud の認証情報でサインインするためのブラウザウィンドウが開きます。API key は必要ありません。

各クライアントは、初回接続時に OAuth フローを自動的に処理します。

claude mcp add --transport http clickstack https://mcp.clickhouse.cloud/clickstack

{
  "mcpServers": {
    "clickstack": {
      "url": "https://mcp.clickhouse.cloud/clickstack"
    }
  }
}

{
  "servers": {
    "clickstack": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/clickstack"
    }
  }
}

{
  "mcp": {
    "clickstack": {
      "type": "remote",
      "url": "https://mcp.clickhouse.cloud/clickstack"
    }
  }
}

mcpServers:
  clickstack:
    type: streamable-http
    url: https://mcp.clickhouse.cloud/clickstack

x-service-id ヘッダーがない場合、リクエストの送信先は、アカウントで最初にプロビジョニングされ使用されている ClickStack サービスにデフォルト設定されます。別のサービスを指定するには、MCP client の設定で x-service-id: <YOUR_SERVICE_ID> をヘッダーとして渡してください。

Open Source および BYOC のデプロイメントでは、ClickStack インスタンスに組み込まれた MCP エンドポイントを Bearer トークン認証で使用します。

• 稼働中の ClickStack インスタンス (セットアップ方法については デプロイメント を参照してください)
• Personal API Access Key — HyperDX の Team Settings → API Keys → Personal API Access Key で確認できます

MCPサーバーは、ClickStack のフロントエンドURLの /api/mcp パスで利用できます。たとえば、デフォルトのローカルデプロイメントでは、URLは http://localhost:8080/api/mcp です。デフォルト設定を変更している場合は、localhost:8080 をご利用のインスタンスのホスト名とポートに置き換えてください。

MCPサーバーは、Bearer token 認証で Streamable HTTP トランスポートを使用します。

<YOUR_CLICKSTACK_URL> はインスタンス URL (例: http://localhost:8080) に、<YOUR_API_KEY> は Personal API Access Key に置き換えてください。

claude mcp add --transport http hyperdx <YOUR_CLICKSTACK_URL>/api/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

{
  "mcpServers": {
    "hyperdx": {
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

{
  "servers": {
    "hyperdx": {
      "type": "http",
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

{
  "mcp": {
    "hyperdx": {
      "type": "remote",
      "url": "<YOUR_CLICKSTACK_URL>/api/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

mcpServers:
  clickstack:
    type: streamable-http
    url: <YOUR_CLICKSTACK_URL>/api/mcp
    headers:
      Authorization: "Bearer <YOUR_API_KEY>"

接続すると、AIアシスタントは ClickStack の主要な領域にわたるさまざまなツールを利用できるようになります。具体的には次のとおりです。

• データのクエリ — ClickStack のクエリビルダー、検索構文、または生の SQL を使用して、ログ、トレース、メトリクスを検索・集計できます。
• データソース — 利用可能なデータソース、データベース接続、カラムスキーマ、属性キーを一覧表示できます。
• ダッシュボード — タイルを含むダッシュボードの作成、更新、削除、確認ができます。
• アラート — 評価履歴を含むアラートの作成、更新、確認ができます。
• 保存済み検索 — 再利用可能な保存済み検索定義の作成、更新、確認ができます。
• Webhooks — アラート通知に使用できる webhook の宛先を一覧表示できます。
• チーム — 現在のユーザーが所属しているチームを一覧表示し、アクティブなチームを特定できます。

利用できるツールの内容は、今後拡張される可能性があります。MCP client は接続時に利用可能なツールを自動的に検出します。

これは Open Source と BYOC のデプロイメントにのみ適用されます。ClickStack on ClickHouse Cloud については、特定のサービスを対象にする を参照してください。

デフォルトでは、MCP リクエストはプライマリ チームのコンテキストで処理されます。複数のチームに所属している場合は、Authorization ヘッダーに加えて、チーム ID を設定した x-hdx-team ヘッダーを渡すことで、特定のチームを対象にできます。このヘッダーを省略すると、プライマリ チームが使用されます。所属していないチームを指定した場合、リクエストは 401 エラーで拒否されます。

アクセス可能なチームと現在アクティブなチームを確認するには、MCP client のチーム一覧ツールを使用してください。