Pulsetic Mcp Server

Pulsetic MCP サーバー

Model Context Protocol（MCP）を使用して、AI アシスタントを Pulsetic の監視プラットフォームに接続します。

---

MCP とは？

Model Context Protocol は、AI アシスタントが外部のツールやサービスと連携できるようにするオープンスタンダードです。Pulsetic の MCP サーバーを使うと、自然な会話を通じて、モニターのステータス確認、インシデントの作成、メンテナンスのスケジュール設定などを AI アシスタントに依頼できます。

対応クライアント：

• Claude Desktop — Anthropic のデスクトップアプリ
• Claude Code — 開発者向けの Anthropic の CLI
• ChatGPT — OpenAI の AI アシスタント（OAuth 経由）
• Cursor — AI 搭載のコードエディター
• Windsurf — AI 搭載の IDE
• MCP 仕様を実装している任意のクライアント

---

前提条件

• API アクセスが含まれるプラン（Business または Enterprise）の Pulsetic アカウント。
• Pulsetic API キー — ダッシュボードの Settings → API から生成します。
• MCP 対応の AI クライアント。

---

セットアップ

Claude Desktop

Claude Desktop は stdio ベースの MCP サーバーを使用します。mcp-remote を使ってリモート HTTP エンドポイントに接続します。Settings → Developer → Edit Config を開いて、次を追加します。

{
  "mcpServers": {
    "pulsetic": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.pulsetic.com/mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

YOUR_API_KEY を実際の API キーに置き換えます。変更を適用するには、Claude Desktop を再起動してください。

Claude Code

プロジェクトの .mcp.json ファイルにサーバーを追加します。

{
  "mcpServers": {
    "pulsetic": {
      "type": "streamableHttp",
      "url": "https://api.pulsetic.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Settings → MCP Servers → Add Server を開いて、次のように設定します。

• Type: streamableHttp
• URL: https://api.pulsetic.com/mcp
• Headers: Authorization: YOUR_API_KEY

ChatGPT

ChatGPT は開発者モードを通じて、MCP をネイティブにサポートします。OAuth を使用して Pulsetic で認証します。

ステップ 1. ChatGPT で開発者モードを有効にします。Enabled apps → Advanced settings → Developer mode に移動し、オンに切り替えます。この機能は ChatGPT Pro、Plus、Team、Business、Enterprise、Edu のユーザーが利用できます。

ステップ 2. 新しいアプリを作成します。Enabled apps → Create app に移動します。

ステップ 3. アプリの詳細を入力します。

フィールド	値
名前	Pulsetic MCP（または任意の名前）
説明	Uptime monitoring（任意）
MCP サーバー URL	https://api.pulsetic.com/mcp
認証	OAuth

ステップ 4. OAuth エンドポイントはサーバーから自動検出されます。Advanced settings で確認できます。

フィールド	値
認証 URL	https://api.pulsetic.com/mcp/oauth/authorize
トークン URL	https://api.pulsetic.com/mcp/oauth/token
登録 URL	https://api.pulsetic.com/mcp/oauth/register

ステップ 5. "I understand and want to continue" にチェックを入れて、Create をクリックします。

ステップ 6. OAuth ログインフローを完了します。Pulsetic の認証ページにリダイレクトされるので、アカウントのメールアドレスと API トークンを入力してください。

メールアドレスは API トークンと一致している必要があります。 認証ページで入力するメールアドレスは、指定する API トークンの所有者のものと一致している必要があります。

API キーは非公開にしてください。 API キーを使うと、Pulsetic アカウントに対する完全なアクセス権が得られます。バージョン管理に登録したり、公開したりしないでください。

---

利用可能なツール

MCP サーバーでは、17 個のツールを 4 つのカテゴリに分けて提供しています。

モニター

ツール	説明
list_monitors	ステータス、稼働率、応答時間を含むすべてのモニターを一覧表示します。
get_monitor	特定のモニターの詳細情報を取得します。
get_monitor_stats	1日／7日／30日／90日間の稼働率（%）、ダウンタイム、応答時間を取得します。
get_monitor_events	指定した期間内のオンライン／オフラインイベントを取得します。
get_monitor_downtime	指定した期間の合計ダウンタイムを秒単位で取得します。
create_monitor	HTTP、TCP、または ICMP モニターを新規作成します。
update_monitor	モニターの名前、URL、頻度、または設定を更新します。
delete_monitor	モニターを完全に削除します。
pause_monitor	監視を一時停止します（チェックを停止します）。
resume_monitor	一時停止中のモニターを再開します。

ステータスページ

ツール	説明
list_status_pages	タイトル、スラッグ、ドメインを含むすべてのステータスページを一覧表示します。

インシデント

ツール	説明
list_incidents	ステータスページのインシデントを一覧表示します。
create_incident	初回のステータス更新を含む新しいインシデントを作成します。
update_incident	既存のインシデントにステータス更新を投稿します。
resolve_incident	インシデントを解決済みとしてマークします。

メンテナンス

ツール	説明
create_maintenance	ステータスページでメンテナンス時間をスケジュールします。
delete_maintenance	スケジュール済みのメンテナンス時間を削除します。

---

使用例

設定が完了すると、自然言語で Pulsetic を操作できます。

モニターの状態を確認する

"Show me all my monitors and their current status."

"What's the uptime for my production API monitor over the last 30 days?"

"Are any of my monitors currently down?"

"Show me the downtime events for monitor 42 in the past week."

モニターを管理する

"Create a new monitor for https://api.example.com that checks every 30 seconds."

"Pause the staging monitor while we do the migration."

"Resume all paused monitors."

"Change the check frequency of monitor 15 to 60 seconds."

"Delete the old marketing-site monitor."

インシデントに対応する

"Create an incident on our main status page: 'Elevated API latency'
 with status investigating and message 'We're looking into slow response times.'"

"Update the API latency incident to identified: 'Root cause is a database
 connection pool issue. Working on a fix.'"

"Resolve incident 8 with message 'Connection pool limits increased.
 Response times back to normal.'"

メンテナンスをスケジュールする

"Schedule a maintenance window on status page 1 called 'Database upgrade'
 starting 2025-03-20 at 2am UTC and ending at 4am UTC."

"Delete the maintenance window we scheduled for next week."

---

cURL でのテスト

cURL を使って MCP エンドポイントを直接テストし、API キーが機能することを確認できます。

初期化

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "curl", "version": "1.0"}
    }
  }'

ツールを一覧表示する

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

ツールを呼び出す

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "list_monitors",
      "arguments": {}
    }
  }'

---

ツールリファレンス

list_monitors

アカウントのすべてのモニターを返します。

パラメーターはありません。

---

get_monitor

SSL 証明書情報を含む、単一のモニターの詳細を返します。

パラメーター	型	必須	説明
monitor_id	integer	はい	モニター ID です。

---

get_monitor_stats

1 日、7 日、30 日、90 日の各期間における稼働時間の割合、ダウンタイム、インシデント数、平均応答時間を返します。

パラメーター	型	必須	説明
monitor_id	integer	はい	モニター ID です。

---

get_monitor_events

指定した日付範囲のオンライン／オフラインイベントを返します（最大 100 件、新しい順）。

パラメーター	型	必須	説明
monitor_id	integer	はい	モニター ID です。
from	string	いいえ	開始日（YYYY-MM-DD）。デフォルト：7 日前。
to	string	いいえ	終了日（YYYY-MM-DD）。デフォルト：今日。

---

get_monitor_downtime

指定した期間のダウンタイム合計（秒）とインシデント数を返します。

パラメーター	型	必須	説明
monitor_id	integer	はい	モニター ID です。
days	integer	いいえ	遡って確認する日数です。デフォルト：30。

---

create_monitor

新しい稼働状況モニターを作成します。

パラメーター	型	必須	説明
url	string	はい	監視する URL またはホスト名です。
name	string	いいえ	表示名です。
request_type	string	いいえ	http、tcp、または icmp です。デフォルト：http。
uptime_check_frequency	integer	いいえ	チェック間隔（秒）です。デフォルト：60。
request_method	string	いいえ	HTTP メソッドです。デフォルト：GET。
request_timeout	integer	いいえ	タイムアウト時間（秒）です。デフォルト：30。
ssl_check	boolean	いいえ	SSL 監視を有効にします。

---

update_monitor

既存のモニターの設定を更新します。変更するフィールドのみを指定してください。

パラメーター	型	必須	説明
monitor_id	integer	はい	モニター ID です。
name	string	いいえ	新しい表示名です。
url	string	いいえ	新しい URL またはホスト名です。
uptime_check_frequency	integer	いいえ	新しいチェック間隔（秒）です。
request_method	string	いいえ	HTTP メソッドです。
request_timeout	integer	いいえ	タイムアウト時間（秒）です。
ssl_check	boolean	いいえ	SSL 監視を有効／無効にします。

---

delete_monitor

モニターと関連するすべてのデータを完全に削除します。

パラメーター	型	必須	説明
monitor_id	integer	はい	モニター ID です。

---

pause_monitor

モニターを一時停止します。再開するまでチェックされなくなります。

パラメーター	型	必須	説明
monitor_id	integer	はい	モニター ID。

---

resume_monitor

一時停止中のモニターを再開します。

パラメーター	型	必須	説明
monitor_id	integer	はい	モニター ID。

---

list_status_pages

アカウントのすべてのステータスページを返します。

パラメーターはありません。

---

list_incidents

ステータスページのインシデントと、それぞれの最新の更新を返します。

パラメーター	型	必須	説明
status_page_id	integer	はい	ステータスページ ID。

---

create_incident

ステータスページに表示される初回のステータス更新を含む、新しいインシデントを作成します。

パラメーター	型	必須	説明
status_page_id	integer	はい	ステータスページ ID。
title	string	はい	インシデントのタイトル。
status	string	はい	investigating、identified、monitoring、または resolved。
message	string	はい	初回の更新メッセージ。

---

update_incident

既存のインシデントに新しいステータス更新を投稿します。

パラメーター	型	必須	説明
incident_id	integer	はい	インシデント ID。
status	string	はい	investigating、identified、monitoring、または resolved。
message	string	はい	更新メッセージ。
title	string	いいえ	インシデントのタイトルを更新します。

---

resolve_incident

解決メッセージを添えて、インシデントを解決済みとしてマークします。

パラメーター	型	必須	説明
incident_id	integer	はい	インシデント ID。
message	string	はい	解決メッセージ。

---

create_maintenance

ステータスページにメンテナンス期間を予定します。

パラメーター	型	必須	説明
status_page_id	integer	はい	ステータスページ ID。
name	string	はい	メンテナンスのタイトル。
description	string	いいえ	メンテナンスの説明。
start	string	はい	ISO 8601 形式の開始時刻。
end	string	はい	ISO 8601 形式の終了時刻。
timezone	string	いいえ	タイムゾーン（例：UTC、America/New_York）。デフォルト：UTC。

---

delete_maintenance

予定されているメンテナンス期間を削除します。

パラメーター	型	必須	説明
maintenance_id	integer	はい	メンテナンス期間 ID。

---

トラブルシューティング

401 Unauthorized

• API キーが正しく、有効期限が切れていないことを確認してください。
• Authorization ヘッダーにキーを渡していることを確認してください（トークンをそのまま渡すか、Bearer プレフィックスを付けます）。
• アカウントのプランで API アクセスが有効になっていることを確認してください。

OAuth 認証に失敗する（ChatGPT）

• 認証ページで入力するメールアドレスは、API トークンの所有者と一致する必要があります。
• ChatGPT の設定で開発者モードが有効になっていることを確認してください。
• 開発者モードに対応した ChatGPT プラン（Pro、Plus、Team、Business、Enterprise、または Edu）を利用していることを確認してください。

「モニターが見つからないか、アクセスが拒否されました」

• モニター ID が存在しないか、別のアカウントに属しています。
• list_monitors を使用して、利用可能なモニター ID を確認してください。

AI クライアントにツールが表示されない

• MCP 設定を編集した後、AI クライアントを再起動してください。
• URL が正確に https://api.pulsetic.com/mcp であることを確認してください。
• cURL でエンドポイントをテストし、接続を確認してください。

プロトコルエラーが発生する

• リクエストで Content-Type: application/json を使用していることを確認してください。
• jsonrpc フィールドは正確に "2.0" である必要があります。
• 通知を除くすべてのリクエストに、id フィールド（整数または文字列）を含めてください。

---

API リファレンス

MCP サーバーは、単一の POST /mcp エンドポイントで JSON-RPC 2.0 を使用し、Streamable HTTP トランスポートを介して MCP 仕様（2025-03-26） を実装しています。