Pingstack

Pingstack MCP サーバー

Pingstack はハートビートチェックで cron ジョブやスケジュールされたタスクを監視し、ウェブサイト、TCP ポート、DNS レコード、SSL 証明書、ドメインの有効期限もチェックします。MCP サーバーを使うと、コーディングエージェントが監視を設定し、結果を確認できます。

エージェントに、今作成したバックアップジョブのハートビートチェックを、適切な cron スケジュール、タイムゾーン、猶予期間で追加するよう依頼できます。先週、どのチェックでインシデントが発生し、どれくらいダウンしていたかを尋ねられます。過去 30 日間の API の p95 レイテンシを尋ねることもできます。

このリポジトリには、ホスト型サーバーのセットアップファイルとディレクトリ一覧が含まれています。サーバー自体は Pingstack で稼働しているため、ローカルにインストールしたり実行したりする必要はありません。

エンドポイント	https://app.pingstack.io/mcp
トランスポート	Streamable HTTP（ステートレス、JSON レスポンス）
サインイン	ブラウザーでの OAuth、または API キー
料金	15 件のチェックまで無料。MCP はすべてのプランに含まれています
ドキュメント	docs.pingstack.io/mcp

接続

Pingstack アカウントが必要です。無料で登録してから、サーバーをクライアントに追加してください。Authorization ヘッダーは指定しないでください。クライアントがブラウザーを開き、Owner または Admin が Pingstack アカウントを選択した後、接続を承認します。クライアントは自身で登録するため、コピーするクライアント ID やシークレットはありません。

Claude Code

claude mcp add --transport http pingstack https://app.pingstack.io/mcp

次に /mcp を実行し、pingstack を選択してサインインします。すべてのプロジェクトで使うには、--scope user を追加してください。プラグインとしてインストールすることもできます。

/plugin marketplace add atomicvan/pingstack-mcp
/plugin install pingstack@pingstack

Claude（claude.ai および Claude Desktop）

Settings → Connectors に移動し、Add custom connector を選択して、名前を Pingstack にし、https://app.pingstack.io/mcp を入力します。

GitHub Copilot CLI

copilot mcp add --transport http pingstack https://app.pingstack.io/mcp

/mcp に needs-auth と表示される場合は、/mcp auth pingstack を実行してください。

VS Code と Copilot

コマンドパレットから MCP: Add Server を実行し、HTTP を選択して URL を入力します。または、.vscode/mcp.json に追加します。

{
  "servers": {
    "pingstack": {
      "type": "http",
      "url": "https://app.pingstack.io/mcp"
    }
  }
}

Cursor

これを ~/.cursor/mcp.json に追加し、Cursor の MCP 設定からサインインします。

{
  "mcpServers": {
    "pingstack": {
      "url": "https://app.pingstack.io/mcp"
    }
  }
}

OpenAI Codex

codex mcp add pingstack --url https://app.pingstack.io/mcp
codex mcp login pingstack

Google Antigravity

Antigravity CLI を使って、antigravity フォルダーにプラグインをインストールします。アプリでも自動的に認識されます。初回の接続時に、ブラウザーでサインインします。

git clone https://github.com/atomicvan/pingstack-mcp
agy plugin install ./pingstack-mcp/antigravity

または、これを ~/.gemini/config/mcp_config.json に追加してから、Agent settings → Customizations の pingstack の横にある Authenticate をクリックします。

{
  "mcpServers": {
    "pingstack": {
      "serverUrl": "https://app.pingstack.io/mcp"
    }
  }
}

Gemini CLI

拡張機能としてインストールします。

gemini extensions install https://github.com/atomicvan/pingstack-mcp

次に /mcp auth pingstack を実行します。

クライアントセットアップガイドでは、各クライアントの詳細な手順のほか、クライアントがブラウザー経由でサインインできない場合に API キーを使う方法も説明しています。

ツール

サーバーには20個のツールがあります。接続の権限があるツールのみがクライアントに表示されます。

ツール	機能
get_account_capabilities	アカウント、プランの上限、使用状況、タイムゾーン、各チェックタイプで受け付けるフィールド
list_checks	チェックの一覧表示と絞り込み
get_check	1つのチェックの設定、ステータス、最終実行日時、有効期限
create_check	ハートビート、ウェブサイト、TCP、DNS、SSL証明書、ドメインのチェックを作成
update_check	チェックの設定を変更
get_check_ping_urls	ハートビートチェックの ping URL（別途許可が必要で、デフォルトでは無効）
get_check_history	最大1年分の日次実行、レイテンシ、インシデント
list_check_runs	最大90日分の個々の実行
get_check_metrics	プローブのリージョンまたはDNSリゾルバー別のレイテンシパーセンタイル
get_check_uptime	7日から1年までの稼働時間
list_incidents	チェックと状態で絞り込んだインシデント
get_incident	1つのインシデント
list_notification_groups	チェックのアラートを送信できるアラートグループ
list_dashboards	ダッシュボードとステータスページ
get_dashboard	1つのダッシュボードとそのチェック
create_dashboard	非公開ダッシュボードを作成
update_dashboard	非公開ダッシュボードを変更
attach_check_to_dashboard	ダッシュボードにチェックを追加
detach_check_from_dashboard	ダッシュボードからチェックを削除
reorder_dashboard_checks	ダッシュボードのチェックの順序を変更

履歴はプランで保持される期間までさかのぼれます。すべての引数については、 ツールリファレンスをご覧ください。

できないこと

サーバーでは、データの削除、ステータスページの公開、カスタムドメインの管理、チェックの一時停止、インシデントの更新投稿、購入はできません。これらはPingstackアプリで行います。接続ごとにアクセスできるアカウントは1つに限られ、接続時に承認された権限と、承認者の現在のロールが適用されます。プランの上限に達すると、エージェントに上限を伝え、担当者が開くためのアップグレードリンクを返します。

ハートビートの ping URL を使うと、誰でもジョブの完了を報告できます。そのため、接続時に該当する権限にチェックを入れた場合にのみ、サーバーから URL が返されます。

プロンプトの例

• バックアップジョブ用に猶予期間を15分とした日次ハートビートを追加し、Infrastructure ダッシュボードに配置してください。
• 過去7日間にインシデントが発生したチェックと、その停止時間を教えてください。
• この README に記載されているすべてのドメインについて、ウェブサイトチェックと SSL証明書チェックを作成してください。
• 過去30日間の API チェックの p95 レイテンシはどれくらいですか？
• プランではあと何個チェックを作成できますか？

サポート

• ドキュメント：docs.pingstack.io
• メール：[email protected]
• プライバシーポリシー：pingstack.io/privacy-policy
• 利用規約：pingstack.io/terms-conditions

セキュリティ上の問題は公開イシューを作成せず、[email protected] までご報告ください。

ライセンス

このリポジトリ内のファイルにはMIT Licenseが適用されます。 Pingstack サービスには利用規約が適用されます。