UptimeRobot MCP

AI エージェント向け UptimeRobot

このリポジトリは、AI エージェントとの連携に関する UptimeRobot の唯一の信頼できる情報源です。以下を公開しています。

• **llms.txt** および **AGENTS.md** — LLM とコーディングエージェント向けの探索・案内用ファイルです。
• **.claude-plugin/****, **.cursor-plugin/**, および ****.codex-plugin/** — Claude Code、Cursor、Codex 用のインストール可能なプラグインマニフェストです。
• **skills/** — すべての UptimeRobot MCP ツールに加え、オンボーディングやランブックのワークフローを網羅した、自己完結型のスキルファイルです。
• **rules/** — Cursor と Claude Code の両方で読み込まれる共有ルールです。
• **mcp.json** — Cursor 形式の MCP サーバー設定ファイル（ドットなしのファイル名）です。
• **.mcp.json** — Claude Code 形式の MCP サーバー設定ファイル（プラグインの読み込み時に Claude Code がサーバーを自動登録するよう、ファイル名の先頭にドットを付けています）。
• **codex.mcp.json** — Codex 形式の MCP サーバー設定ファイル（mcp_servers というスネークケースのキーを使用し、Codex マニフェストから明示的に参照します）。
• **.agents/plugins/marketplace.json** — ローカルでのインストールとテスト用の、リポジトリ単位の Codex マーケットプレイスです。リポジトリを開くと、Codex がこのファイルを自動検出します。
• **assets/logo.png** — マーケットプレイスのロゴです。Cursor と Codex のマニフェストでは icon として指定されています（Claude Code のプラグインマニフェストにはアイコンのフィールドがありません。提出時にはディレクトリの一覧からアイコンが設定されます）。

mcp.json、.mcp.json、および codex.mcp.json の各ファイルは、いずれも同じ mcp-remote ランチャーを登録します。このランチャーは https://mcp.uptimerobot.com/mcp へのプロキシとして動作し、OAuth のブラウザーフローを実行します。ファイル名が3種類あるのは、Claude Code、Cursor、Codex がそれぞれ独自の規則を求めるためです（また、Codex では mcpServers ではなく、スネークケースの mcp_servers が必須です）。

同じ内容が、クローラーによる検出用に uptimerobot.com/ 配下にもミラーされています（uptimerobot.com/llms.txt、uptimerobot.com/AGENTS.md など）。

インストール

Claude Code

マーケットプレイスから（公開後）

UptimeRobot は、Anthropic のコミュニティプラグインマーケットプレイスに申請中です。承認されたら、マーケットプレイスを一度追加してインストールしてください。

/plugin marketplace add anthropics/claude-plugins-community
/plugin install uptimerobot@claude-community

または、/plugin を実行して Discover タブを開き、UptimeRobot を見つけてインストールしてください。（先にコミュニティマーケットプレイスを追加する必要があります。組み込みではありません。設定なしで /plugin に表示されるのは、Anthropic が厳選した公式マーケットプレイスのみです。）

プラグインが読み込まれると、.mcp.json によって MCP サーバーが自動登録されます。初回接続時にはブラウザーが開き、UptimeRobot にログインしてアクセスを許可するよう求められます（OAuth）。貼り付ける API キーはありません。トークンはローカルにキャッシュされるため、この操作は一度だけで済みます。

ローカルクローン（プラグインの手動インストール）

マーケットプレイスを介さず、ローカルのチェックアウトからプラグイン全体（スキル、ルール、コマンド、自動登録される MCP サーバー）を直接実行するには、リポジトリをクローンし、--plugin-dir フラグを指定して読み込みます。

git clone https://github.com/uptimerobot/ai.git
claude --plugin-dir ./ai

--plugin-dir <path> は、ディレクトリ（.claude-plugin/plugin.json を含むディレクトリ）からプラグインを読み込み、そのセッション中のみ有効にします。このフラグは繰り返し指定でき、.zip も指定できます。別の場所から Claude Code を起動する場合は、絶対パスを使用してください。

claude --plugin-dir /absolute/path/to/ai

初回接続時には、OAuth フローのためにブラウザーが開きます。/plugin を実行し、プラグインが読み込まれていて、uptimerobot MCP Server に ✓ connected と表示されることを確認してください。

MCP サーバーのみ（スクリプトによる設定）

プラグインの他の機能（ドットファイル、CI のブートストラップ）を含めず、MCP ツールだけを使いたい場合は、[skills/setup/SKILL.md](skills/setup/SKILL.md) を参照してください。概要は次のとおりです。

claude mcp add uptimerobot -- npx -y mcp-remote@latest https://mcp.uptimerobot.com/mcp

その後、Claude Code を終了して再起動し、ブラウザーが開いたら OAuth のブラウザーフローを完了してください。/plugin を実行し、uptimerobot MCP Server に ✓ connected と表示されることを確認してください。

Cursor

マーケットプレイスから（公開後）

Cursor Marketplace を開き、UptimeRobot を見つけて Add to Cursor をクリックしてください。MCP サーバーの初回接続時に、OAuth のブラウザーフローで認証してください。API キーは不要です。

ローカルインストール（開発および提出前テスト用）

Cursor のプラグインドキュメントに従ってください：

# Clone or symlink this repo into Cursor's local plugin folder
git clone https://github.com/uptimerobot/ai.git ~/.cursor/plugins/local/uptimerobot-ai

Cursor を起動し、コマンドパレットから Developer: Reload Window を実行します。

プラグインが検出されていることを確認します：

• Settings → Rules, Skills, Subagents — uptimerobot.mdc ルールと、すべての skills/*/SKILL.md エントリが一覧に表示されている必要があります。
• Settings → Tools & MCPs — MCP サーバーが接続すると、uptimerobot が 32 個のツールとともに表示されます。初回接続時に OAuth ブラウザーフローを完了してください。

Codex

ローカルインストール（開発および提出前テスト用）

リポジトリをクローンして Codex で開きます。リポジトリ単位のマーケットプレイスである .agents/plugins/marketplace.json は自動検出されるため、追加設定なしで UptimeRobot (local) が Codex のプラグインディレクトリに表示されます。プラグインをインストールし、初回の MCP 接続時に OAuth ブラウザーフローを完了してください。

Codex にソースを明示的に追跡させたい場合：

codex plugin marketplace add ./

プラグインが読み込まれていることを確認します。24 個のスキルが利用可能になり、接続すると uptimerobot MCP サーバーが 32 個のツールとともに表示されます。

その他のエージェント／直接 MCP 接続

サーバーは公式 MCP Registry に com.uptimerobot/uptimerobot として登録されているため、レジストリに対応するクライアントであれば、クライアントごとのプラグイン提出なしで検出およびインストールできます。メタデータは server.json にあります：

curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=com.uptimerobot/uptimerobot"

レジストリに対応していないクライアントは、同じ mcp-remote ランチャー経由で接続できます（初回使用時は OAuth が必要です）：

{
  "mcpServers": {
    "uptimerobot": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.uptimerobot.com/mcp"]
    }
  }
}

ヘッドレス／CI（ブラウザーなし）

OAuth ブラウザーフローを実行できない環境では、代わりにダッシュボードの Integrations & API から取得した Main API キーを使って、通常の HTTP で接続します：

{
  "mcpServers": {
    "uptimerobot": {
      "type": "http",
      "url": "https://mcp.uptimerobot.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

プラグインが提供する機能

MCP 経由で 32 個のツールをリソース別に分類して提供します。全リストとペイロードは [AGENTS.md](AGENTS.md) および [skills/](skills/) にあります：

モニター

ツール	用途
create-monitor	HTTP、KEYWORD、PING、PORT、HEARTBEAT、DNS、API、UDP モニターを作成します
update-monitor	名前、URL、間隔、アラート連絡先、タグ、HTTP 設定を変更します
update-monitor-status	モニターを一時停止または再開します
list-monitors	検索および状態フィルター付きのページ分割された一覧
get-monitor-details	1 つのモニターの全設定と現在の状態
get-monitor-stats	稼働中／ダウン／一時停止中の件数と稼働率％の集計
get-response-times	バケットごとの時系列応答時間データ

モニターグループ（プランによる制限：monitor-groups）

ツール	用途
create-monitor-group	グループを作成し、モニターを割り当てます
update-monitor-group	既存のグループ名を変更します
get-monitor-group	ID で単一のグループを取得します
list-monitor-groups	グループのページ分割された一覧

ステータスページ（PSP）

ツール	用途
create-psp	モニター、グループ、またはタグから公開ステータスページを作成します
update-psp	名前、ドメイン、並べ替え順、公開範囲、または公開状態を変更します
get-psp	ID で単一のステータスページを取得します
list-psps	ステータスページのページ分割された一覧

PSP のお知らせ

ツール	用途
create-psp-announcement	ステータスページにお知らせ（情報／メンテナンス／障害）を投稿します
update-psp-announcement	タイトル、内容、日付、種類、公開ステータスを編集します
pin-psp-announcement	お知らせをページの最上部にピン留めします
unpin-psp-announcement	お知らせのピン留めを解除します
get-psp-announcement	ID を指定して単一のお知らせを取得します
list-psp-announcements	ステータスページのお知らせ一覧をページネーション付きで取得します

メンテナンスウィンドウ（プランで利用可：maintenance-window）

ツール	用途
create-maintenance-window	アラートを抑制する単発または定期的なウィンドウをスケジュールします
update-maintenance-window	スケジュール、期間、モニターを変更するか、ウィンドウを一時停止／再開します
get-maintenance-window	ID を指定して単一のウィンドウを取得します
list-maintenance-windows	ウィンドウ一覧をページネーション付きで取得します

インシデント

ツール	用途
list-incidents	時間範囲とモニターのフィルターを指定して、モニター全体のインシデントを取得します
get-incident-details	インシデントごとのチェッカーの場所、ログ、トレースルートを取得します

インシデントコメント（プランで利用可：incident-comments）

ツール	用途
create-incident-comment	インシデントにコメントを追加します
update-incident-comment	既存のコメントを編集します
list-incident-comments	インシデントのコメント一覧をページネーション付きで取得します

アカウント不要

quick-monitor-setup スキルは、メールアドレスだけで無料の HTTPS モニターを作成します。アカウント、API キー、OAuth は不要です。エージェントが認証不要の proof-of-work API を呼び出し、所有者がアクティベーションメール内のリンクをクリックして確認します。ガイド：https://uptimerobot.com/quick-monitor-setup/.

プランの要件

UptimeRobot のプランは Free、Solo、Team、Enterprise です。利用可能なモニターの種類、最小間隔、モニターの上限は有効なプランによって異なります。MCP サーバーはこれらを適用し、呼び出しが上限を超える場合はエラーコード -28002（subscription_limit_exceeded）を返します。[skills/errors/SKILL.md](skills/errors/SKILL.md) を参照してください。

トラブルシューティング

Claude／Cursor にツールが表示されない

MCP のハンドシェイクが、セッション開始時にクライアントがツール一覧を取得した後に完了することがあります。そのため、サーバーに接続されていてもツールが表示されない場合があります。解決方法：クライアントを完全に終了し（/exit を実行するだけでなく、ターミナルを閉じてください）、再起動します。再起動前に claude mcp list を実行し、uptimerobot に ✓ Connected と表示されることを確認してください。

認証に関する問題

症状	解決方法
OAuth のブラウザーが開かない	mcp-remote がターミナルに表示する認証 URL をコピーして、手動で開いてください
ツールが -31001 user_not_found を返す	rm -rf ~/.mcp-auth でキャッシュされたトークンを削除し、OAuth フローを再実行するために、アプリを完全に終了してから再起動してください
書き込みツールが -31002 access_denied を返す	書き込み権限のあるアカウントを使って、再認証してください（rm -rf ~/.mcp-auth）

API エラーコード

コード	意味	対処方法
-28001	モニターの上限に達しました	使用していないモニターを削除するか、プランをアップグレードしてください
-28002	サブスクリプションの上限	プランに対して間隔が短すぎるか、モニターの種類がプランに含まれていません。間隔を長くするか、プランをアップグレードしてください
-29001	無効なパラメーター	エラーメッセージに問題のあるフィールドが示されています。修正して再試行してください
-31001	認証に失敗しました	上記の「認証に関する問題」を参照してください
HTTP 429	レート制限	時間をおいて、指数バックオフで再試行してください

エラーの全リファレンスと復旧手順については、skills/errors/SKILL.md を参照してください。

コントリビュート

このリポジトリは生成・キュレーションされています。問題は https://github.com/uptimerobot/ai/issues から報告してください。MCP サーバーのバグについては、https://uptimerobot.com/contact をご利用ください。

プライバシーと規約

• プライバシーポリシー
• 利用規約

ライセンス

MIT。LICENSE を参照してください。