ClaudeとCoralogixを連携する方法 — ログ・メトリクス・トレースの調査を会話で任せる

Claude Coralogix連携でできること

CoralogixのMCPサーバーをClaudeにつなぐと、ログ・メトリクス・トレースの検索、インシデントやアラートの確認を会話の中で進められます。Coralogixはオブザーバビリティ(可観測性)のSaaSで、MCPサーバーは完全なリモート型です。ローカルにインストールするものはありません。

つなぎ方は2通りあります。Claudeアプリのコネクタ一覧から追加する方法と、Claude Codeにclaude mcp addで登録する方法です。接続先のURLはどちらも、自分のCoralogixドメインに合わせたhttps://api.<ドメイン>.coralogix.com/mgmt/api/v1/mcpの形をとります。

この記事は、後者のClaude Code側の設定を中心に、障害調査での使い方と、会話に任せる範囲の線引きまでを扱います。同じ監視系でも、Better Stackはインシデント対応とステータスページ更新が中心でした。比べるならClaudeとBetter Stackの連携が参考になります。

接続前に決めておくこと

最初に決めるのは、リージョンと認証方式の2つです。

リージョン(ドメイン): コネクタのページには、EU1・EU2・US1・US2・US3・AP1・AP2・AP3と、Proofpoint・FactSet向けの専用URLが並んでいます。自分のCoralogixアカウントのドメインに合うものを選びます。Coralogixのセットアップ手順の例はEU2のURLで書かれているため、そのまま貼ると別リージョンのアカウントでは接続できません。

認証方式: Claude Codeでは次の2つが用意されています。

OAuthでは、SSOとMFAがログイン時に効きます。パスワードがMCPクライアントに渡ることはなく、アクセストークンの有効期限は1時間です。Claude Codeのように自動更新に対応したクライアントなら、セッションは途切れません。更新に対応しないクライアントでは、1時間で切断されて再認証が必要になります。

OAuthを使うには、クライアントが自動クライアント登録に対応している必要があります。Claude Codeは公式手順の対象に含まれています。

Claude CodeでCoralogixに接続する

OAuthの場合は、サーバーを登録してから認証します。

claude mcp add --transport http coralogix-server \
  https://api.eu2.coralogix.com/mgmt/api/v1/mcp

登録後、Claude Codeの対話セッションで/mcpを開き、coralogix-serverを選んでAuthenticateを押します。ブラウザが開くので、CoralogixにログインしてAuthorizeを押せば完了です。

APIキーで接続する場合は、--headerでBearerトークンを渡します。

claude mcp add coralogix-server \
  --transport http \
  https://api.eu2.coralogix.com/mgmt/api/v1/mcp \
  --header "Authorization: Bearer <YOUR-API-KEY>"

<YOUR-API-KEY>には、個人のCoralogix APIキーを入れます。MCPサーバーはそのキーに紐づく権限を引き継ぎます。社内ネットワークがプロキシを要求する場合は、Claude Codeを起動する前にHTTPS_PROXYを設定します。MCPクライアントはシステムのプロキシ設定を自動で拾います。

mcp-versionヘッダーの扱い

MCPサーバーは既定でv2です。そのため、上の設定例にはmcp-versionヘッダーがありません。旧版のv1に留めたいときだけ、mcp-version: v1ヘッダーを送ります。ただしv1は廃止予定で、いずれ使えなくなります。

Claude Codeでは、ヘッダーは--headerで渡す形に揃っています。v1に留める場合も、同じ書式で--header "mcp-version: v1"を足す形になります。新しく接続するなら、ヘッダーなしのv2のままで構いません。

最初の質問と、使えるツールの範囲

接続できたら、公式の手順にあるような質問から始められます。

Show me the most frequent errors for service XYZ in the past week.

日本語でも、サービス名と期間を具体的に書けば同じように聞けます。Coralogixの手順では、アシスタントが該当のログを探し、問題のある関数を特定する流れになっています。

ツール数は2つの数字がある

ここで食い違いに注意が要ります。Claudeのコネクタ一覧のページには、get_logs_v1・get_traces_v1・list_incidents_v1など16個のツールが載っています。名前に_v1が付いたものが多く、旧版の一覧に見えます。一方、CoralogixのドキュメントのツールカタログはMCPサーバーv2の現在の姿として70個のツールを載せ、「実際のサーバーのマニフェストから生成している」と説明しています。

ツール数や名前は、接続したサーバーの返す一覧が正になります。記事や一覧ページの数字で、使えるツールを決め打ちしないほうが安全です。

カタログにあるツールは、領域別に分かれています。調査に効くものを挙げます。

• DataPrime: query_dataprimeはログ・スパン・データセットにDataPrimeクエリを投げる、読み取り専用のツールです
• アラート: get_alerts_object、search_alert_definitionsで定義を探せます
• インフラ・APM: list_infrastructure_resources、get_service_map_relations_graphなどでサービスの依存関係を見られます
• メトリクス: get_metric_labels、get_metric_label_valuesでラベルを調べられます
• ドキュメント: search_docs、fetch_docでCoralogixのドキュメントを引けます

障害調査での使い方

障害調査では、範囲を狭める順に質問を並べると進めやすくなります。次は例です。

1. 「過去1時間でエラー率が上がったサービスはどれか」で、疑う範囲を絞る
2. 「そのサービスの直近のエラーログを種類別に数えて」で、主なエラーを特定する
3. 「最初にエラーが出た時刻はいつか」で、変更履歴と突き合わせる材料を得る
4. 「そのエラーに関連するトレースを見て、遅い呼び出し先を教えて」で、原因の候補に当たる

3番目は、公式手順が例に挙げているWhen did the issue start?と同じ型の質問です。この例の手順書はCursor向けですが、Claude Codeなら、原因が分かったあとに同じ会話で修正を依頼できます。

調査の型をClaude Code側に覚えさせておくと、毎回の指示が短くなります。CLAUDE.mdに次のような断片を置く例です。

## Coralogixでの調査手順
- 障害調査では、まず該当サービスの直近1時間のエラーログを種類別に集計する
- クエリを投げる前に、対象のスキーマを確認する
- 結論には、根拠にしたクエリと時間範囲を必ず添える
- アラートやパースルールの変更は、実行前に変更内容を提示して確認を取る

最後の行が、次の節の線引きにつながります。

先に知っておく制約と、書き込みの線引き

検索対象はアーカイブストレージだけ

Coralogixの制限事項として最初に載っているのが、MCPのクエリはアーカイブストレージにのみ実行される点です。高頻度検索(Frequent Search)の階層だけを使う環境には対応しません。

その結果、画面では見えているログが、「直近10分のログ」のような質問では0件になることがあります。最近のログを対象にした自然言語の質問が空振りに見えるのは、非アーカイブのデータにMCPが届かないためです。使う前に、アカウントでアーカイブ(S3)を設定し、対象のログがアーカイブされているかを確認します。

書き込み系のツールがある

読み取りだけのサーバーではありません。manage_alertsやmanage_parsing_rulesのように、作成・更新・削除ができるmanage_*ツールが含まれます。必要な権限はCoralogixのロールで決まります。たとえばアラートはalerts:ReadConfigとalerts:UpdateConfig、パースルールはPARSING-RULES:READCONFIGとPARSING-RULES:UPDATECONFIGです。

調査だけに使うなら、次の2段階で絞れます。

Coralogix側: 調査用のAPIキーかロールには、ログ・メトリクス・スパンの読み取り権限だけを付けます。読み取りの権限は、ログ・メトリクス・スパンごとに分かれています。書き込み権限がなければ、manage_*ツールは作成や更新に失敗します。

Claude Code側: 書き込み系のツールを、権限ルールで拒否できます。ツール名の指定はmcp__<サーバー名>__<ツール名>の形です。

{
  "permissions": {
    "deny": [
      "mcp__coralogix-server__manage_alerts",
      "mcp__coralogix-server__manage_parsing_rules"
    ]
  }
}

サーバー名はclaude mcp addで付けた名前です。上の例ではcoralogix-serverにあたります。manage_*ツールは他にもあるので、.claude/settings.jsonには実際に接続して表示されたツール名を確認したうえで並べます。

Ollyツールは既定で隠れる

CoralogixのAI観測エージェント「Olly」を呼ぶツール(olly_askなど)は、既定で非表示です。Coralogixは長いエージェントワークフローを走らせるため、コストがかかる機能として扱っています。使うにはx-allow-costly-use: trueヘッダーを足します。

claude mcp add --transport http coralogix-server \
  https://api.eu2.coralogix.com/mgmt/api/v1/mcp \
  --header "x-allow-costly-use: true"

APIキーで認証している場合は、Authorizationヘッダーを残したまま足します。olly_askは読み書き可能なツールとして分類されているので、有効にするかは調査の目的で決めます。

接続できないときの切り分け

OAuth接続に失敗したときや、途中で動かなくなったときは、上から順に確かめます。

アクセスを止めたいときは、MCPクライアントの切断オプションを最初に使います。Coralogix側では、ユーザーをチームから外す、ロールを絞る、サポートに依頼して特定のインテグレーションのトークンを失効させる、の3つの方法があります。

まとめ

Coralogixは、OAuthでClaude Codeにつなぐと、個人のログイン権限の範囲で障害調査を会話に任せられます。つなぐ前に確認するのは、リージョンのURL、アーカイブストレージの設定、書き込み権限の3点です。調査用の権限は読み取りに絞り、manage_*の作成・更新は人が内容を見てから実行する運用にすると、会話に任せる部分と人が押す部分を分けられます。同じ観点の連携設計は監視ツール連携による障害対応ワークフローにもまとめています。