mttrly - AI-powered incident management and server monitoring via MCP.

mttrly MCP Server

サーバーの健全性、診断、プレイブック、承認、監査履歴に対応する AI SRE エージェント mttrly に、リモート MCP 経由でアクセスできます。

対象範囲

mttrly MCP は、リモートの Streamable HTTP コネクターです。すべてのツール呼び出しは、まず mttrly Central API に到達し、その後 Central が既存のセキュアなエージェントチャネル経由で接続済みエージェントと通信します。スタンドアロンエージェントは、ローカル MCP インターフェースを公開しません。

Variant A は、意図的にリモート優先の設計です。公開カタログはホストされたエンドポイントを参照し、OAuth がユーザー認証を処理するため、通常のクライアント設定に npm パッケージは不要です。

接続

Claude.ai と Claude Desktop

コネクター UI を使用します。

1. Settings -> Connectors を開きます。
2. Add custom connector を選択します。
3. https://api.mttrly.com/mcp を入力します。
4. OAuth サインインのフローを完了します。

リモート URL を claude_desktop_config.json に入力しないでください。このファイルはローカルの stdio MCP サーバー用です。

Claude Code

claude mcp add --transport http mttrly https://api.mttrly.com/mcp

OpenAI Codex

~/.codex/config.toml に以下を追加します。

[mcp_servers.mttrly]
url = "https://api.mttrly.com/mcp"

次に、OAuth ログインを完了します。

codex mcp login mttrly

Cursor

https://api.mttrly.com/mcp をリモート MCP サーバーの URL として追加します。Cursor はサーバーのチャレンジから保護リソースのメタデータを検出し、OAuth を開始します。

認証

• リモートトランスポートでは、https://app.mttrly.com に対して PKCE S256 を使用する OAuth 2.1 を使用します。
• 保護リソースのメタデータ URL は https://api.mttrly.com/.well-known/oauth-protected-resource/mcp です。
• ブラウザーオリジンの MCP クライアントは、MCP_ALLOWED_ORIGINS で明示的に許可リストに登録する必要があります。
• Origin ヘッダーのないリクエストには、通常の 401 OAuth チャレンジが返されます。
• 信頼されていない Origin ヘッダーを含むリクエストは、仕様上 403 で拒否されます。

ツール

利用可能なツールは 40 個で、読み取りツールが 21 個、実行ツールが 19 個です。現在のプランと制限を確認するため、必ず最初に mttrly_get_capabilities を呼び出してください。

読み取りツール（21）

ツール ID	タイトル	プラン	説明
mttrly_get_capabilities	プランの機能を取得	watchdog	現在のプラン、利用可能なツール、制限付きツール、プランの上限を取得します。他のツールを使用する前に、最初に呼び出してください。
mttrly_list_servers	サーバー一覧を取得	watchdog	オンライン／オフラインのステータス、サーバー ID、名前、最終確認時刻、エージェントのバージョンとともに、接続済みのすべてのサーバーを一覧表示します。サーバーごとの CPU、RAM、ディスク、アクティブなアラート数については、mttrly_get_server_status を使用してください。
mttrly_get_server_status	サーバーのステータスを取得	watchdog	CPU、RAM、ディスク使用量、アクティブなアラート数など、サーバーの詳細な健全性情報を取得します。
mttrly_get_alerts	サーバーのアラートを取得	watchdog	重要度とステータスで絞り込んで、サーバーのアラートを取得します。プランに基づく保持期間の上限が適用されます。
mttrly_quick_triage	サーバーを簡易トリアージ	watchdog	Watchdog の安全なデータから、ステータス、アクティブなアラート、リソース使用率を含む、簡易的な読み取り専用の診断概要を取得します。
mttrly_run_diagnostic	サーバー診断を実行	deployment_bro	サーバーに対して非破壊的な診断を実行します。問題を説明すると、システムが調査します。サーバーごとに 30 秒のクールダウンがあります。Deployment Bro+ 専用です。Watchdog で利用できるのは、読み取り専用の調査ツール（ステータス、アラート、list_playbooks）のみです。
mttrly_list_playbooks	プレイブック一覧を取得	watchdog	利用可能な修復用プレイブックを一覧表示します。ID、名前、説明、カテゴリ、requires_approval フラグ、任意のパラメーター配列を返します。server_id またはカテゴリで絞り込めます。
mttrly_get_service_reality	サービスの実態を取得	deployment_bro	サーバーの最新のキャッシュ済み、またはライブ更新されたサービス実態のスナップショットを取得します。検出結果、サービス、ランタイム、現在の健全性情報が含まれます。
mttrly_refresh_reality	実態を更新	deployment_bro	サーバーのサービス実態をライブ更新し、新しいスナップショットが取得されるまで待機します。サーバーごとに厳格なクールダウン期間があります。
mttrly_get_server_timeline	サーバーのタイムラインを取得	deployment_bro	インシデント、デプロイ、監査イベントを統合し、時系列順に並べたサーバーの最近のタイムラインを取得します。
mttrly_run_deploy_verifier	デプロイ検証を実行	deployment_bro	サーバーの汎用デプロイ検証を実行します。ヘルスチェックの結果、アクティブなインシデントの状況、最新のデプロイステータスを返します。
mttrly_read_file	ファイルを読み取る	deployment_bro	共通の秘匿化処理を適用しながら、許可リストに登録されたログ、Docker ログ、Docker イメージ、または管理対象の環境ファイルをサーバーから読み取ります。
mttrly_read_privileged_file	特権ファイルを読み取る	deployment_bro	sudoers のオーバーライドや root の authorized_keys など、拡張許可リストに登録された特権ファイルを、共通の秘匿化処理を適用して読み取ります。
mttrly_search_files	ファイルを検索	deployment_bro	任意の glob フィルタリングと共通の秘匿化処理を適用して、サーバー上の許可リストに登録されたファイルをリテラル文字列で検索します。
mttrly_diff_file	ファイルを比較	deployment_bro	サーバー上の許可リストに登録された 2 つのファイルを比較し、共通の秘匿化処理を適用した統合差分を返します。
mttrly_compare_source_to_dist	ソースと dist を比較	deployment_bro	正規の読み取り専用比較機能を通じて、サーバー上のソースツリーと dist 出力を比較します。
mttrly_get_install_health	インストールの健全性を取得	deployment_bro	正規の復旧バックエンド経路を通じて、インストーラーが管理する健全性状態、ドリフト、修復計画を読み取ります。
mttrly_search_knowledge	ナレッジを検索	deployment_bro	全文検索を使用して、保存済みの事後分析、レシピ、メモを検索します。任意でサーバーを絞り込めます。
mttrly_get_morning_brief	朝の概要を取得	deployment_bro	新たに検出された異常や最近のナレッジアーティファクトを含む、ユーザー向けの現在のプロアクティブな概要を取得します。
mttrly_get_investigation_bypass	調査バイパスを取得	deployment_bro	調査の現在のバイパス状態を読み取ります。アクション枠を消費せずにバイパスが引き続き有効か確認するには、exec 呼び出しの間に使用します。
mttrly_acknowledge_proactive_event	プロアクティブイベントを確認	deployment_bro	ユーザーに代わって、プロアクティブイベントを承認済み、または誤検知としてマークします。誤検知の予算に反映され、ノイズの多い検出器がミュートされます。

Execute tools (19)

ツール ID	タイトル	プラン	説明
mttrly_run_playbook	プレイブックを実行	deployment_bro	サーバー上でプレイブックを実行します。読み取り専用のプレイブックはすぐに実行され、承認が必要なプレイブックは pending_approval を返します。
mttrly_execute_command	シェルコマンドを実行	deployment_bro	サーバー上で任意のシェルコマンドを実行するよう要求します。読み取り専用コマンドとアクティブな調査による承認バイパスはすぐに実行できます。それ以外の場合は pending_approval を返します。
mttrly_get_pending_actions	保留中のアクションを取得	deployment_bro	mttrly_run_playbook または mttrly_execute_command によって作成された、承認待ちのアクションを一覧表示します。action_id、サーバー、タイプ、説明、有効期限を返します。アクションは30分後に期限切れになります。承認するには mttrly_approve_action、却下するには mttrly_cancel_action を使用します。
mttrly_get_action_result	アクションの結果を取得	deployment_bro	mttrly_run_playbook または mttrly_execute_command によって作成されたアクションの現在の結果または最終結果を取得します。
mttrly_approve_action	アクションを承認または却下	deployment_bro	保留中のアクションを承認または却下します。ユーザーの明示的な確認後にのみ呼び出してください。実行が完了するまで待機します。
mttrly_cancel_action	アクションをキャンセル	deployment_bro	保留中のアクションを却下してキャンセルします。ユーザーの明示的な確認後にのみ呼び出してください。
mttrly_get_audit_log	監査ログを取得	deployment_bro	サーバーの時系列の監査記録を取得します。コマンドの実行、プレイブックの実行、アラートのトリガー、エージェントによる修正と、ソースの属性（mcp/telegram/dashboard/api）および結果が含まれます。
mttrly_write_file	ファイルを書き込む	deployment_bro	管理対象のサーバーファイルに、Base64 エンコードされたコンテンツを書き込みます。必ず承認待ちのアクションを返します。
mttrly_cleanup_file	ファイルをクリーンアップ	deployment_bro	許可リストに登録された管理対象のサーバーファイルを削除します。必ず承認待ちのアクションを返します。
mttrly_execute_script	スクリプトを実行	deployment_bro	正規のスクリプト機能を通じて、許可リストに登録された管理対象のスクリプト、またはインラインのバッチスクリプトをサーバー上で実行します。アクティブな調査による承認バイパスではすぐに実行できます。それ以外の場合は pending_approval を返します。
mttrly_bootstrap_recover	ブートストラップを復旧	deployment_bro	サーバーとインストールトークン用の正規のブートストラップ復旧ワンライナーを生成します。
mttrly_repair_install	インストールを修復	deployment_bro	問題に基づく修復、インストール状態の完全な収束、ラッパーの再プロビジョニング、エージェントのアンインストールなど、正規のインストール復旧戦略を実行します。必ず承認待ちのアクションを返します。
mttrly_regenerate_install_token	インストールトークンを再生成	watchdog	既存のオフラインサーバー用に、新しい再インストールコマンドを生成します。承認が必要です。エージェントの認証情報をローテーションし、サーバーの履歴を保持しますが、ホストのクリーンアップは行いません。
mttrly_decommission_server	オフラインサーバーを削除	watchdog	オフラインまたは停止中のサーバーを Central レジストリからのみ削除します。承認が必要です。ホスト上のファイル、ユーザー、systemd はクリーンアップしません。
mttrly_update_agent	エージェントを更新	deployment_bro	正規のコア更新機能を通じて、サーバー上の mttrly エージェントを更新します。必ず承認待ちのアクションを返します。
mttrly_start_investigation	調査を開始	deployment_bro	現在の MCP セッションに紐付けられたサーバー調査を開始または再開します。有効期間の短い MCP セッションが必要です。
mttrly_generate_retrospective	振り返りを生成	deployment_bro	現在のサーバーのタイムライン、検証状態、保存されたナレッジから、決定論的な振り返りを生成します。事後分析の記録を保存します。
mttrly_acquire_investigation_bypass	調査の承認バイパスを取得	deployment_bro	進行中の調査で、セッション全体に適用される承認バイパスを取得します。2FA が必要です。以降、調査対象サーバーでの execute_command/execute_script は、有効期限、アクション上限への到達、または取り消しまで、コマンドごとの承認をスキップします。
mttrly_revoke_investigation_bypass	調査の承認バイパスを取り消す	deployment_bro	有効な調査の承認バイパスをただちに取り消します。以降の exec では、コマンドごとの承認が再び必要になります。冪等です。すでに取り消されたバイパスを取り消すと、エラーではなく現在の状態を返します。

Errors

コード	説明	推奨される対応
ACTION_EXPIRED	保留中のアクションが30分のTTLを超過したため、自動的にキャンセルされました。	元のコマンドまたはプレイブックを再実行して、新しい保留中のアクションを作成してください。
ACTION_NOT_FOUND	保留中のアクションが見つかりませんでした。	保留中のアクションを再度一覧表示し、新しい action_id を使用してください。
AUTH_FAILED	認証に失敗したか、指定された認証情報が無効です。	認証情報を更新し、有効な API キーまたは OAuth トークンで再試行してください。
CONNECTION_ERROR	MCP サーバーからバックエンド API に接続できませんでした。	接続が復旧した後、リクエストを再試行してください。
CONTRACT_VERSION_UNSUPPORTED	クライアントが、サポートされていない MCP コントラクトのメジャーバージョンを要求しました。	MCP クライアントをアップグレードするか、現在サポートされているメジャーバージョンのコントラクトを使用してください。
DIAGNOSTIC_COOLDOWN	サーバーごとの診断クールダウン期間がまだ終了していません。	クールダウン期間が終了するまで待ってから再試行してください。
DOCKER_NOT_AVAILABLE	対象サーバーに Docker がインストールされていないため、Docker プレイブックを利用できません。	Docker プレイブックをスキップするか、先にサーバーに Docker をインストールしてください。
FORBIDDEN	要求された MCP リソースは、別のユーザーまたはプランのコンテキストに属しています。	現在のアカウントで、最新のサーバー、プレイブック、またはアクション ID を再取得してください。
INTERNAL_ERROR	バックエンドで予期しない内部エラーが発生しました。	1回再試行してください。引き続き失敗する場合は、バックエンドのログを確認するか、サポートにお問い合わせください。
NOT_FOUND	要求された MCP リソースが見つかりませんでした。	該当するリストエンドポイントを更新し、有効な識別子で再試行してください。
PLAN_REQUIRED	要求されたツールには、より上位のサブスクリプションプランが必要です。	プランの制限をユーザーに伝え、アップグレード URL を提示してください。
POLICY_DENIED	実行前に、既知の Central 側の安全ポリシーによってリクエストが拒否されました。	許可された対象パスまたは操作を選択して再試行してください。
PLAYBOOK_NOT_AVAILABLE	選択したプレイブックは、対象サーバーで現在利用できません。	そのサーバーのプレイブック一覧を更新し、表示されたプレイブックから選択してください。
PLAYBOOK_NOT_FOUND	指定されたプレイブック ID は存在しません。	mttrly_list_playbooks を呼び出し、有効な playbook_id を選択してください。
RATE_LIMITED	リクエストが現在の MCP レート制限ウィンドウを超過しました。	レート制限ウィンドウがリセットされるまで待ってから再試行してください。
SERVER_NOT_FOUND	指定されたサーバー ID が存在しないか、現在のユーザーに属していません。	mttrly_list_servers を呼び出して、利用可能なサーバー ID を確認してください。
SERVER_OFFLINE	対象サーバーのエージェントは現在接続されていません。	サーバー上で mttrly エージェントが実行されているか確認してください。
SERVER_ONLINE	対象サーバーはオンラインのため、レジストリのみの削除はブロックされています。	まず「削除」を使用してエージェントをアンインストールするか、サーバーがオフラインになるまで待ってからレジストリレコードを削除してください。
TIMEOUT	リクエストが設定されたタイムアウトを超過しました。	リクエストを再試行するか、処理コストが高い場合は対象範囲を絞ってください。
UNKNOWN_ERROR	MCP サーバーで不明なエラーが発生しました。	リクエストを再試行し、問題が続く場合はエラーの詳細情報を確認してください。
VALIDATION_ERROR	リクエストのスキーマまたはパラメーターの検証に失敗しました。	リクエストのパラメーターが、提示されたツールスキーマに適合しているか確認してください。
APPROVAL_NOTIFICATION_FAILED	保留中のアクションは作成されましたが、承認プロンプトをユーザーに配信できなかったため、アクションはフェイルクローズされました。	エラーの詳細情報にある action_id を確認して、アクションが保留中ではなくなったことを確かめてから、元のリクエストを再試行し、新しいアクションを作成してください。
INVESTIGATION_CLOSED	調査はすでに終了しており、バイパスを取得できません。	バイパスを要求する前に、mttrly_start_investigation で新しい調査を開始してください。
BYPASS_ALREADY_ACTIVE	この調査には、すでに有効で取り消されていないバイパスがあります。	現在のバイパスを使用してください。異なる制限が必要な場合は、mttrly_revoke_investigation_bypass を呼び出してから再取得してください。
BYPASS_ACQUIRE_FAILED	調査のバイパスを取得できませんでした。確認と更新の間に調査の状態が変化しました。	調査のステータスを再読み込みして再試行してください。調査が終了している場合は、新しい調査を開始してください。

Plans

Limits

Plan	Servers	Log lines	Log retention (days)	Scheduled checks
watchdog	1	50	7	0
deployment_bro	3	500	30	5
deployment_crew	9	500	30	Unlimited

Access matrix

Tool	Watchdog	Deployment Bro	Deployment Crew
mttrly_get_capabilities	✓	✓	✓
mttrly_list_servers	✓	✓	✓
mttrly_get_server_status	✓	✓	✓
mttrly_get_alerts	✓	✓	✓
mttrly_quick_triage	✓	✓	✓
mttrly_run_diagnostic	—	✓	✓
mttrly_list_playbooks	✓	✓	✓
mttrly_run_playbook	—	✓	✓
mttrly_execute_command	—	✓	✓
mttrly_get_pending_actions	—	✓	✓
mttrly_get_action_result	—	✓	✓
mttrly_approve_action	—	✓	✓
mttrly_cancel_action	—	✓	✓
mttrly_get_audit_log	—	✓	✓
mttrly_get_service_reality	—	✓	✓
mttrly_refresh_reality	—	✓	✓
mttrly_get_server_timeline	—	✓	✓
mttrly_run_deploy_verifier	—	✓	✓
mttrly_read_file	—	✓	✓
mttrly_read_privileged_file	—	✓	✓
mttrly_search_files	—	✓	✓
mttrly_diff_file	—	✓	✓
mttrly_compare_source_to_dist	—	✓	✓
mttrly_get_install_health	—	✓	✓
mttrly_write_file	—	✓	✓
mttrly_cleanup_file	—	✓	✓
mttrly_execute_script	—	✓	✓
mttrly_bootstrap_recover	—	✓	✓
mttrly_repair_install	—	✓	✓
mttrly_regenerate_install_token	✓	✓	✓
mttrly_decommission_server	✓	✓	✓
mttrly_update_agent	—	✓	✓
mttrly_start_investigation	—	✓	✓
mttrly_generate_retrospective	—	✓	✓
mttrly_search_knowledge	—	✓	✓
mttrly_get_morning_brief	—	✓	✓
mttrly_get_investigation_bypass	—	✓	✓
mttrly_acquire_investigation_bypass	—	✓	✓
mttrly_revoke_investigation_bypass	—	✓	✓
mttrly_acknowledge_proactive_event	—	✓	✓

Support

• Support email: [email protected]
• Issues: github.com/mttrly-hq/mttrly-mcp/issues
• Marketing page: mttrly.com/mcp
• Docs: mttrly.com/docs#mcp