ClaudeとMonte Carloを連携する方法 — アラート調査と監視設定を会話で進める
Monte Carloの公式MCPサーバーをClaudeに接続する手順です。コネクタ・OAuth・APIキーの3経路、Editor以上が要る権限、書き込み系ツールの扱いまで確かめます。
Claude Monte Carlo連携とは何か
Monte Carlo連携は、データ&AIオブザーバビリティ(データの状態を継続的に監視する仕組み)のMonte Carloが提供するMCPサーバーを、Claudeにつなぐ仕組みです。アラートの調査、テーブルのリネージュ(データの流れ)の確認、モニターの作成を、Monte Carloの画面を開かずに自然文で頼めます。
Connectorsディレクトリでは「Anthropic verified」の表示つきで、カテゴリは「Data & analytics」、追加時期は2026年5月です。サインインは必須で、接続先のURLは https://mcp.getmontecarlo.com/mcp と載っています。
想定読者は、Monte Carloを使っているデータエンジニアやアナリティクスエンジニアです。Monte Carlo側の前提は1つだけで、Editor以上のロールが要ります。閲覧専用のロールでは使えません。
提供元はモデルについても書いています。多くのツールを連鎖させる作業、たとえばウェアハウスの導入や障害調査では、モデルの性能差が出やすいとして、Claude Opus 5.5以降を推奨しています。モデルを選べるClaude Code、Claude Desktop、Cursorでは、そこを意識して選ぶ価値があります。
Connector全般の仕組みはClaudeコネクタの解説にまとめています。
3つの接続経路のどれを選ぶか
Monte Carloのドキュメントは、接続経路を3つ用意しています。選び方は使うクライアントと用途で決まります。
| 経路 | 向く場面 | 認証 |
|---|---|---|
| Claudeコネクタ | 向く場面Claude(claude.ai)とClaude Desktopで個人利用 | 認証ブラウザでログインして許可 |
| OAuth | 向く場面Claude Codeなど、ほかのMCPクライアント | 認証動的クライアント登録(DCR)でOAuth 2.1 |
| APIキー | 向く場面サービスアカウント、CI、自動化 | 認証MCPサーバー専用キー |
Claudeを使う人は、コネクタを最初に選ぶのが最短です。キーの管理も設定ファイルの編集もありません。後述のとおり、読み取り専用モードのような細かい制御はコネクタでは使えないので、その点だけ頭に置いてください。
Claudeコネクタで接続する手順
手順は3ステップです。
Claudeコネクタでの接続
- 1
コネクタを開く
ディレクトリのMonte Carloのページを開くか、Claudeの設定でコネクタ一覧からMonte Carloを探します。
- 2
Connectを押す
ブラウザでMonte Carloのログインページが開きます。
- 3
Allow accessを押す
サインインしたあと、同意画面で許可すると接続が完了します。Claude(claude.ai)とClaude Desktopの両方で使えます。
OAuthアプリを作る必要も、クライアントIDやシークレットをコピーする必要もありません。Monte CarloがDCRでクライアントを登録する方式だからです。
接続できたかは、Claudeに「Test the Monte Carlo MCP connection.」と頼むと確かめられます。ツール一覧に testConnection が載っているので、それが呼ばれる想定です。
Claude CodeからOAuthで接続する
Claude Codeでは、HTTPトランスポートでURLを渡します。ドキュメントのコマンドは次の1行です。
claude mcp add --transport http monte-carlo-mcp \
https://mcp.getmontecarlo.com/mcp初回の接続時にブラウザが開き、サインインと許可を求められます。ここで付けた名前(monte-carlo-mcp)は、後で使うスラッシュコマンドの接頭辞を決めます。次の節で触れます。
CursorやVS Codeのように設定ファイルで足すクライアントは、URLを書くだけです。VS Codeは mcpServers ではなく servers というキーを使う点だけが違います。
{
"mcpServers": {
"monte-carlo": {
"url": "https://mcp.getmontecarlo.com/mcp"
}
}
}クライアントがクライアントIDとシークレットを求めてきたら、DCRの選択肢を使います。Monte Carlo側は静的なIDとシークレットを発行しないためです。Snowflake Cortex Agentから使う場合も同じ理由で、APIインテグレーションの認証は TYPE = OAUTH2 ではなく OAUTH_DYNAMIC_CLIENT を使います。
Claude Codeでデータ作業をする人は、MCPだけでなくAgent Toolkitも候補になります。提供元の説明では、MCPサーバーがツールへの接続を担い、Toolkitはその使い方を教えるスキルやフックを足すものです。コード変更ごとのリスク分析のような用途は、Toolkit側の役割とされています。
APIキーで接続する場合
サービスアカウント、CI、自動化、OAuth非対応のクライアントでは、MCPサーバー専用キーを使います。個人の対話利用では、コネクタかOAuthを選ぶようドキュメントが案内しています。
押さえておく点は3つです。
- 通常のAPIキーでは動きません。キーの種類は「MCP server」を選びます
- キーはUI(Settings → API Keys → Add)、CLI、GraphQLのいずれかで作れます
- CLIで作る場合はMC CLI v0.141.4以降が必要です
CLIでの作成は次のとおりです。
montecarlo mcp create-key --description "Automation key"発行されたKey idとKey secretは、mcp-remote 経由で Authorization: Bearer <id>:<secret> として渡します。mcp-remote にはNode.jsが要ります。ヘッダがうまく通らないクライアントでは、x-mcd-id と x-mcd-token を別々のヘッダで渡す方法も案内されています。
401や403が出たときの切り分け
401と403は原因が別です。401はキーの中身、403はクライアントの古さを先に疑います。
| 症状 | 確かめること |
|---|---|
| 接続が始まらない | 確かめることキー方式では末尾スラッシュ付きの https://mcp.getmontecarlo.com/mcp/ を指定する。npx がPATHにあるか確認する |
| 401 | 確かめることKey idとKey secretが正しいか、キーの種類が「MCP server」か、ヘッダが正しく渡っているか |
| 403(Invalid OAuth error response) | 確かめることクライアントが古い可能性が高い。最新版へ更新する。ヘッダが空になる古いクライアントもある |
| ネットワークで失敗する | 確かめること社内プロキシが mcp.getmontecarlo.com を通すか。初回の npx は registry.npmjs.org も必要 |
URLの末尾スラッシュは、OAuth用の案内には付いておらず、キー方式の案内にだけ付いています。経路ごとに書き分けられている点に注意してください。
Claudeに頼める作業と呼ばれるツール
ツール名を覚える必要はありません。やりたいことを書けば、エージェントがツールをつなげて呼びます。提供元は4つの代表的な使い方を挙げています。
代表的な4つの使い方
アラートのトリアージ
直近3日のアラートを出して、見るべき順に並べてもらいます。呼ばれるツールの例は
get_alerts、alert_assessment、update_alertです。テーブルの健全性調査
特定のテーブルの状態と、上流の依存関係を調べます。例は
search、get_table、get_asset_lineageです。監視の穴埋め
モニターが付いていない重要テーブルを探し、モニターの案を作ります。例は
get_use_case_tables、get_monitors、create_or_update_table_monitorです。AIエージェントの観測
AIエージェントの監視案を作らせます。例は
get_agent_metadata、get_agent_trace、create_agent_metric_monitorです。
頼み方の例は、提供元のプロンプトがそのまま使えます。
What Monte Carlo alerts do we have in the past 3 days?
Triage them and let me know what I need to review first.日本語で「過去3日のMonte Carloアラートを、確認すべき順に並べて」と頼んでも、同じ流れで試せます。
ガイド付きプロンプトをスラッシュコマンドで呼ぶ
MCPサーバーは、ツールのほかにプロンプト(定型ワークフロー)も配布します。プロンプトに対応したクライアント(Claude CodeやVS Code)では、スラッシュコマンドとして現れます。
| コマンド | 用途 |
|---|---|
/mcp__monte-carlo__mc-asset-health | 用途クエリを書く前にテーブルの健全性を見る |
/mcp__monte-carlo__mc-triage | 用途アラートの優先順位を付ける |
/mcp__monte-carlo__mc-incident-response | 用途トリアージから根本原因、対処までを通しで進める |
/mcp__monte-carlo__mc-proactive-monitoring | 用途監視の穴を見つけてモニターで埋める |
/mcp__ の次の部分は、設定時につけたサーバー名で決まります。前の節のコマンドで monte-carlo-mcp と名付けた場合は、/mcp__monte-carlo-mcp__mc-triage のようになります。提供元の例は monte-carlo という名前で書かれているため、そのままコピーすると動かない場合があります。
書き込み系ツールの扱い — コネクタでは絞れない
ここが運用上の分かれ目です。
ディレクトリのツール一覧には、閲覧だけでなく変更するものが並びます。アラートの更新(updateAlert)、担当者の設定(setAlertOwner)、コメントの作成・更新(createOrUpdateAlertComment)、バリデーションやメトリクスなど4種のモニター作成、カスタムダッシュボードのウィジェット作成です。
Monte Carlo側には、書き込みを止める手段があります。x-mcp-readonly: true ヘッダを付けると、読み取り系のツールだけが公開され、書き込みツールを呼ぶと「読み取り専用モードでは使えない」というエラーになります。x-mcp-tools ヘッダで、使えるツール名を明示的に絞ることもできます。どちらも、公開されるツールを減らす方向にしか働きません。
ただし、ヘッダを固定で持つClaudeコネクタでは、これらのヘッダを送れないとドキュメントに書かれています。つまり次の使い分けになります。
- 観察だけさせたいなら、ヘッダを送れるクライアントとキー方式を組み合わせる
- コネクタで使うなら、Editor以上のロールが書き込みの権限そのものになる
キー方式でのヘッダ指定は、設定ファイルに引数を足す形です。
"--header", "x-mcp-readonly: true""--header", "x-mcp-tools: get_alerts,search,get_table"コネクタ経由でモニターを作らせるときは、作成前に内容を確認してから許可する運用が無難です。
ディレクトリの一覧とドキュメントの記載がずれる点
読み比べると、気づく違いが2つあります。
1つ目は表記です。ディレクトリのツール一覧は getAlerts、getAssetLineage のようなキャメルケースで、ドキュメントは get_alerts、get_asset_lineage のようなスネークケースです。同じツールの別表記なのか、公開名が違うのかは、どちらのページにも書かれていません。Claudeに実際に呼ばせて、ツール名の表示を確かめるのが確実です。
2つ目は範囲です。ドキュメントによると、サーバーのツールは3つのツールセットに分かれています。
| ツールセット | 追加されるもの |
|---|---|
default | 追加されるもの常に有効。アラート、モニター、アセット、リネージュ、データ操作、ユーティリティ |
extended | 追加されるものdefault に加えて、ユースケースとダッシュボードウィジェットのツール |
agent_observability | 追加されるものdefault に加えて、AIエージェントの調査ツール(get_agent_metadata、get_agent_conversation、get_agent_trace) |
extended と agent_observability を有効にするには、接続時に x-mcd-toolset ヘッダを渡します。ディレクトリに表示される24件(全25件)の中には getUseCases などのユースケース系が載る一方で、get_agent_trace などエージェント調査系の名前はありません。説明文には「evaluate AI agent performance」とあるので、コネクタで「AIエージェントの観測」の使い方を試したい場合は、期待どおりに動くかを先に確認する必要があります。
接続前のチェックリスト
- Monte Carloのロールが、Editor以上になっているか
- 閲覧専用でよいなら、コネクタではなくヘッダを送れる方式を選ぶか
- キー方式なら、キーの種類が「MCP server」で、URLの末尾スラッシュが合っているか
- 社内プロキシが
mcp.getmontecarlo.comを通すか - Claude Codeのスラッシュコマンドが、自分のつけたサーバー名の接頭辞で呼べているか
IP制限が必要な組織向けには、ネットワークアクセス制御(ネットワークACL)でMCPエンドポイントをIPアドレスで絞る機能が用意されています。社内のIPからしか使わせたくない場合に、この設定を検討します。
Snowflakeのデータを同じ流れで扱うならSnowflake連携の記事、障害情報を見る別の観点ならDatadogとSentryのコネクタが参考になります。
まとめ
Claude(claude.ai)やDesktopから使うなら、コネクタが最短です。ロールはEditor以上が前提です。Claude Codeやほかのクライアントなら、URLを渡すOAuthが標準で、CIや自動化ではMCPサーバー専用キーに切り替えます。
読み取りだけに絞る設定はコネクタでは使えないので、観察用途にはヘッダを送れる経路を選びます。どの経路でも、最初の依頼は「Test the Monte Carlo MCP connection.」で接続を確かめ、そのあとアラートのトリアージから始めるのが入りやすい流れです。