MCP 経由で Dynatrace を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Dynatrace をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Dynatrace + Gemini

Environment API v2 による Dynatrace のオブザーバビリティ：根本原因と影響付きの Davis の問題、監視対象エンティティとタグ、メトリクスクエリ、ログ検索、イベント、セキュリティ問題、SLO、設定、監査ログ。AI は問題へのコメント、デプロイイベントやカスタムイベントの送信、エンティティへのタグ付けもできます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

DYNATRACE_ENVIRONMENT_URL, DYNATRACE_API_TOKEN

ステップ 1 — 認証情報を取得

設定は約 3 分です。Dynatrace の SaaS 環境または Managed 環境が必要です。

1. DYNATRACE_ENVIRONMENT_URL は従来の環境アドレスです。SaaS なら https://<environment-id>.live.dynatrace.com、Managed なら https://<your-domain>/e/<environment-id> で、/api も末尾のスラッシュも付けません。プラットフォームのアドレス（<environment-id>.apps.dynatrace.com）ではこの種類のトークンが使えないため、同じ環境の live アドレスを使います。
2. Dynatrace で Access tokens（Manage、Access tokens、Generate new token）を開き、ツールに必要なスコープを選びます: problems.read、entities.read、metrics.read、logs.read、events.read、securityProblems.read、slo.read、settings.read、auditLogs.read。書き込みには problems.write（コメント、クローズ）、events.ingest、entities.write（タグ）も必要です。パーソナルアクセストークンも同じように使えます。
3. トークン（dt0c01.XXXX.YYYY、前に Api-Token は付けない）を DYNATRACE_API_TOKEN に貼り付け、dynatrace_list_problems を実行して確認します。プラットフォームトークン（dt0s16）はこの API では使えません。

問題: dynatrace_list_problems に problem_selector: status("OPEN") を指定すると、Davis AI が検出した問題が一覧できます。dynatrace_get_problem に fields: evidenceDetails,impactAnalysis を指定すると、根拠、根本原因、影響、影響を受けたエンティティがわかります。dynatrace_list_problem_comments でコメントを読み、dynatrace_add_problem_comment で見つけた原因や起票したチケットなどのコメントを追加します。

トポロジー: dynatrace_list_entity_types と dynatrace_get_entity_type はエンティティの種類とそのプロパティを説明します。dynatrace_list_entities はエンティティセレクター（例: type("SERVICE"),entityName.contains("checkout")）でホスト、サービス、プロセス、アプリケーション、Kubernetes ワークロード、クラウドリソースを探し、dynatrace_get_entity はプロパティ、タグ、管理ゾーン、関係を表示します。dynatrace_list_tags はカスタムタグを読み、dynatrace_add_tags は一致するすべてのエンティティにタグを追加します。既存のタグは残ります。

メトリクスとログ: dynatrace_list_metrics（text で検索）と dynatrace_get_metric でメトリクスキー、単位、ディメンションを調べ、dynatrace_query_metrics で 1 つのセレクターにつき最大 10 個のメトリクスのデータポイントを読みます。dynatrace_aggregate_logs は時間帯と属性ごとにログレコードを数えてエラーが集中している箇所を示し、その後 dynatrace_search_logs が 1 回あたり最大 1000 件のレコードを返します。

イベント、セキュリティ、SLO、監査: dynatrace_list_events、dynatrace_get_event、dynatrace_list_event_types でイベントを読み、dynatrace_ingest_event でデプロイ、設定変更、注釈をエンティティに記録します。dynatrace_list_security_problems に status("OPEN"),riskLevel("CRITICAL","HIGH") を指定し、dynatrace_get_security_problem と合わせて、CVE、リスク評価、影響を受けたエンティティ付きで脆弱性を確認できます。dynatrace_list_slos に evaluate: true を指定し、dynatrace_get_slo と合わせて、ステータス、エラーバジェット、バーンレートを確認できます。dynatrace_list_audit_logs は誰が何を変更したかを示します。設定は読み取り専用です: dynatrace_list_settings_schemas、dynatrace_get_settings_schema、dynatrace_list_settings_objects、dynatrace_get_settings_object。

書き込みの前に: 送信したアラート、エラー、可用性のイベントは問題を開いて通知を送ることがあり、コメントとタグは環境の全員に見えます。そのため AI は変更内容を示し、あなたの了承を待ちます。

インストール時はオフ: dynatrace_close_problem。クローズした問題は再オープンできない（障害が再発すると Dynatrace は新しい問題を開きます）ため、チームに必要なときにワークスペース管理者がオンにします。

セレクター: エンティティセレクターは type("HOST"),tag("env:prod"),mzName("Production") のような形式です。カンマでつないだ条件は AND を意味し、値は大文字と小文字を区別します。問題、イベント、SLO、セキュリティ問題のセレクターも同じように動作します。メトリクスセレクターは変換をつなげます: builtin:service.response.time:splitBy("dt.entity.service"):avg:sort(value(avg,descending)):limit(10)。

データ形式: 時刻は 1970 年からの UTC ミリ秒です（startTime、endTime、timestamp。-1 はまだ継続中）。期間には相対値（now-2h、now-7d）、ミリ秒、ISO 8601 が使え、既定は多くの場合直近 2 時間、監査ログでは直近 2 週間です。応答時間はマイクロ秒、CPU とメモリの使用率はパーセント、バイト数はバイトで、単位は dynatrace_get_metric でわかります。エンティティ ID は HOST-1234ABCD5678EF90 のような形式で、問題の ID は表示用 ID（P-2410123）とは異なります。

ページング: 一覧は nextPageKey を返し、AI はそれがなくなるまで、ほかのフィルターをすべて外して next_page_key だけを指定して呼び出します。ログ検索は nextSliceKey でページングしますが、これは従来のログストレージだけです。Grail 環境では AI が期間を狭めます。期間を短くすると応答も小さくなります。

よくあるエラー: 401 はトークンが間違っている、期限切れ、取り消し済み、またはプラットフォームトークンであること、403 は呼び出しに必要なスコープがトークンにないこと（メッセージにスコープ名が出ます）、404 は不明な ID か環境アドレスの誤り、400 はセレクターの書式誤り（メッセージに位置が出ます）、429 はレート制限なので、待ってから再試行します。

このコネクタは Grail や DQL のクエリを実行しません。これらにはアクセストークンではなくプラットフォームトークンか OAuth クライアントが必要で、Dynatrace Remote MCP サーバーが対応しています。設定の変更やタグの削除も行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Dynatrace のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「本番環境でいま開いている問題はどれですか？Davis は根本原因を何と見ていますか？」
• 「直近 24 時間で平均応答時間が最も長いサービスを 5 つ見せてください。」
• 「直近 1 時間に checkout のログでエラーの急増はありましたか？サンプルのレコードをいくつか見せてください。」
• 「checkout サービスにバージョン 1.4.2 のデプロイを記録してください。送信前にイベントの内容を見せてください。」
• 「重大度が Critical または High のセキュリティ問題でまだ開いているものと、影響を受けるエンティティを教えてください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続