New Relic MCPツールのリファレンス

New RelicのMCPサーバーは、AIエージェントがオブザーバビリティデータにアクセス・分析できるようにする特殊なツールを提供します。このリファレンスガイドでは、利用可能なすべてのツールをカテゴリ別に整理しています。

MCPツールの使い方

MCPツールは、AI開発環境において自然言語によるクエリを通じて呼び出されます。ユーザーが正確なツール名やパラメーターを覚える必要はありません。New Relicのデータについて知りたいことを具体的に説明してください。

クエリ例：

• 「私のアカウントにはどのようなエンティティが含まれていますか？」
• 「私のウェブアプリケーションに関する最新のアラートを表示してください」
• 「過去1時間で最も多かったエラーは何ですか？」
• 「NRQLを実行してパフォーマンスを分析してください」

AIツールは、適切なMCPツールを自動的に選択し、結果を適切な形式で出力します。

ツールの絞り込み include-tags

一部のツールは、複数の関連タグが付けられているため、複数のカテゴリに表示されます（例えば、analyze_deployment_impactはincident-responseとadvanced-analysisの両方に関連しています）。

requestsにinclude-tags HTTPヘッダーを送信することで、AIエージェントが受け取るツールを動的にフィルタリングできます。これにより、特定のツール群のみを要求することが可能になり、ツール群の削減やAIモデルの効率性や精度の向上に役立ちます。

フィルタリングに使用できるタグは、このリファレンスのカテゴリヘッダー（discovery、data-access、alerting、incident-response、performance-analytics、advanced-analysis）に直接対応しています。

実装例

"servers": {
    "new-relic-mcp-server": {
        "url": "https://mcp.newrelic.com/mcp/",
        "type": "http",
        "headers": {
            "api-key": "NRAK-****",
            "include-tags": "discovery,alerting"
        }
    }
}

この例では、AIエージェントには、discovery（例：get_entity）とalerting（例：list_alert_policies）に分類されたツールのみが表示され、モデルが現在のタスクに最も関連性の高い機能のみに焦点を当てるようにします。

エンティティおよびアカウント管理（タグ：discovery）

• convert_time_period_to_epoch_ms：時間範囲（例：「過去30分」）をエポックミリ秒に変換します。
• get_dashboard：特定のダッシュボードに関する詳細情報を取得します。
• get_entity：New RelicエンティティをGUIDで取得するか、名前パターンで検索します。
• list_related_entities：指定されたエンティティGUIDから1ホップ離れた（関連する）エンティティをリストします。
• list_available_new_relic_accounts：ユーザーが利用できるすべてのアカウントIDsをリストします。
• list_dashboards：New Relicアカウントのすべてのダッシュボードをリストします。
• list_entity_types：New Relicエンティティタイプの完全なカタログをドメイン／タイプ定義とともにリストします。
• search_entity_with_tag：特定のタグキーと値を使用してエンティティを検索します。

データアクセス（タグ：data-access）

• execute_nrql_query：NRDBに対してNRQLクエリを実行します。
• natural_language_to_nrql_query：自然言語リクエストをNRQLクエリに変換し、実行して結果を返すことにより、書き込みを実行します。

アラートと監視（タグ：alerting）

• list_alert_conditions：特定のアラートポリシーについてアラート条件の詳細をリストします。
• search_incident：柔軟なフィルタリング機能を使用して、すべてのアラート（開始イベントと終了イベントの両方）を一覧表示します。
• list_alert_policies：指定されたアカウントのアラートポリシーを一覧表示します。必要に応じて、ポリシー名でフィルタリングできます。
• list_recent_issues：指定されたアカウントについて、New Relicにおけるすべての未解決の問題を一覧表示します。
• list_synthetic_monitors：すべての合成モニター（サービスの可用性とパフォーマンスをチェックする自動テスト）をリストします。

アラートへの対応（タグ：incident-response）

• analyze_deployment_impact：特定のエンティティにおけるデプロイメントのパフォーマンスへの影響を分析します。
• generate_alert_insights_report：特定の問題に関するアラートインテリジェンス分析レポートを生成します。
• generate_user_impact_report：特定の問題に関するエンドユーザーへの影響分析レポートを生成します。
• list_entity_error_groups：時間枠内でErrors Inboxから特定のエンティティのエラーグループを取得します。
• list_change_events：エンティティGUIDで識別されるアプリケーションについて、New Relicからの変更イベントの履歴を一覧表示します。

パフォーマンス分析（タグ：Performance-analytics）

• analyze_entity_logs：アプリケーションログを分析して、エラーパターン、異常な動作、および繰り返し発生する問題を特定します。
• analyze_golden_metrics：ゴールデンメトリクス（主要な健全性指標：スループット、レスポンスタイム、エラー率、飽和度）を分析します。
• analyze_kafka_metrics：Kafkaメトリクス（コンシューマーラグ、プロデューサースループット、メッセージのレイテンシ、パーティションのバランスなど）を分析します。
• analyze_threads：特定のエンティティのスレッドメトリクスデータ（スレッドの状態、CPU使用率、メモリ消費量など）を分析します。
• analyze_transactions：特定の期間内における特定のエンティティのトランザクションを分析し、処理速度が遅いトランザクションやエラーが発生しやすいトランザクションを特定します。
• list_garbage_collection_metrics：指定されたアカウントとエンティティについて、ガベージコレクションとメモリメトリクスを一覧表示します。
• list_recent_logs：指定されたアカウントとエンティティGUIDについて、New Relicからの最近のログを一覧表示します。

高度な分析（タグ：advanced-analysis）

• analyze_deployment_impact：特定のエンティティにおけるデプロイメントのパフォーマンスへの影響を分析します。
• analyze_entity_logs：アプリケーションログを分析して、エラーパターン、異常な動作、および繰り返し発生する問題を特定します。
• generate_alert_insights_report：特定の問題に関するアラートインテリジェンス分析レポートを生成します。
• generate_user_impact_report：特定の問題に関するエンドユーザーへの影響分析レポートを生成します。
• natural_language_to_nrql_query：自然言語によるリクエストをNRQLクエリに変換し、実行して結果を返します。