Watchgoose

Watchgoose MCP

Watchgoose MCP は、MCP 対応の AI クライアントを Watchgoose Management API に接続します。cron と定期タスクの監視状況を確認でき、チェックの変更は書き込みを明示的に有効にした場合にのみ可能です。

ホステッドコネクター

OAuth 2.1 と Dynamic Client Registration に対応したクライアントでは、ホステッド Streamable HTTP エンドポイントを使用します。

https://mcp.watchgoose.com/mcp

利用可能な場所

Watchgoose はClaude コネクターディレクトリで利用できます。

Watchgoose は GPT および Codex 用の ChatGPT プラグインに掲載されています。

Watchgoose は 公式 MCP Registry に掲載されています。

watchgoose-mcp パッケージは npm で利用できます。

Claude では、Settings > Connectors を開き、カスタムコネクターとしてエンドポイントを追加します。Claude Code では、次を実行します。

claude mcp add --transport http --scope user watchgoose https://mcp.watchgoose.com/mcp

ブラウザーでの同意フローでは、各接続を 1 つのプロジェクトに限定し、デフォルトで読み取り専用アクセスに設定します。ツールとプライバシーの境界については、 Watchgoose MCP のドキュメントを参照してください。

必要条件

• Node.js 20 以降
• プロジェクトにスコープされた Watchgoose API キー（Project settings → API Access → Create (read-only) から作成）

チェックの状態とステータス履歴のみが必要な場合は、読み取り専用キー hcr_ を使用します。ping、インテグレーション、またはチェックの変更も必要な場合は、読み書きキー hcw_ を使用します。

Claude Desktop

このエントリーを claude_desktop_config.json に追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

Claude Code

claude mcp add --env WATCHGOOSE_API_KEY=hcr_your_project_key \
  --transport stdio --scope user watchgoose -- npx -y watchgoose-mcp

claude mcp get watchgoose を実行して接続を確認します。

Cursor

プロジェクト内に .cursor/mcp.json を作成するか、同じエントリーをユーザーの MCP 設定に追加します。

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

VS Code

.vscode/mcp.json を作成します。

{
  "servers": {
    "watchgoose": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

MCP: List Servers を実行し、watchgoose を起動します。

Cline

Cline は OAuth を使用してホステッドエンドポイントに接続するため、API キーは不要です。MCP Servers > Configure MCP Servers を開き、このエントリーを cline_mcp_settings.json に追加します。

{
  "mcpServers": {
    "watchgoose": {
      "type": "streamableHttp",
      "url": "https://mcp.watchgoose.com/mcp"
    }
  }
}

"type": "streamableHttp" は記載どおりにしてください。これがないと Cline は SSE にフォールバックし、接続に失敗します。Cline から認証を求められたら、ブラウザーで Watchgoose にサインインし、プロジェクトを 1 つ選択します。Cline にチェックを変更させる場合を除き、読み取り専用アクセスのままにしてください。代わりにプロジェクト API キーを使用するには、上記の Cursor セクションにある npx エントリーを同じファイルに追加します。

環境

変数	必須	デフォルト	説明
WATCHGOOSE_API_KEY	はい	-	プロジェクト単位の読み取り専用 hcr_ キー、読み取り・書き込み可能な hcw_ キー、または従来の32文字キーです。
WATCHGOOSE_API_URL	いいえ	https://watchgoose.com/api/v3	管理 API のベース URL です。ループバック開発ホストを除き、HTTPS が必要です。キーはこのホストに送信されるため、信頼できる URL のみを使用してください。
WATCHGOOSE_ENABLE_WRITES	いいえ	false	キーが読み取り・書き込み可能な場合に、変更ツールを公開するには true に設定します。
WATCHGOOSE_API_KEY_ACCESS	従来のキーのみ	-	プレフィックスのない32文字キーの場合、read-only または read-write を指定する必要があります。

サーバーはキーのプレフィックスをローカルで判定し、アクセス権限を推測するために API を呼び出すことはありません。 WATCHGOOSE_ENABLE_WRITES=true に設定しても、読み取り専用キーに追加のアクセス権限を付与することはできません。

ツール

チェックは、固定長40文字のunique_key値で指定します。UUID、ping URL、連携UUIDはサーバー内部でのみ使用され、AI クライアントには表示されません。

ツール	必要なアクセス権	Management API の対応
list_checks	読み取り専用	GET /checks/
get_check	読み取り専用	GET /checks/<unique_key>
list_flips	読み取り専用	GET /checks/<unique_key>/flips/
list_pings	読み取り／書き込み	unique_keyを解決し、GET /checks/<uuid>/pings/を実行
list_channels	読み取り／書き込み	GET /channels/
create_check	読み取り／書き込みに加え、書き込みの有効化が必要	POST /checks/
update_check	読み取り／書き込みに加え、書き込みの有効化が必要	unique_keyを解決し、POST /checks/<uuid>を実行
pause_check	読み取り／書き込みに加え、書き込みの有効化が必要	unique_keyを解決し、POST /checks/<uuid>/pauseを実行
resume_check	読み取り／書き込みに加え、書き込みの有効化が必要	unique_keyを解決し、POST /checks/<uuid>/resumeを実行
delete_check	読み取り／書き込みに加え、書き込みの有効化が必要	unique_keyを解決し、DELETE /checks/<uuid>を実行

連携の割り当てには、連携名を完全一致で指定します。名前は空でなく、プロジェクト内で一意である必要があります。

uniqueを指定した場合、create_checkは作成または更新の操作になります。一致する既存のチェックがある場合、指定した設定で置き換えられます。scheduleなしでtimeoutを指定すると、スケジュール監視中のチェックもインターバル監視に切り替わります。保存されているスケジュール文字列はそのまま残りますが、監視間隔には適用されなくなります。スケジュール監視を維持するには、確認済みのスケジュールを含めてください。省略したその他の設定は変更されません。 channels: []を指定すると、すべてのアラート連携の割り当てが解除されます。そのため、このツールはdestructiveHint: trueを通知します。新しいチェックは、完了ベースの監視間隔で成功または失敗を待ちます。最初の失敗でステータスが低下する場合があります。オプションの開始pingを使うと、完了前に実行時の監視を開始できます。

一覧の結果は、チェック100件、ping100件、ステータス変化200件、連携100件に制限されます。シリアライズされた各ツールの結果も24,000文字までに制限されます。項目が省略された場合、結果にはメタデータが含まれます。

セキュリティ

• hcw_キーを使用している場合でも、書き込みはデフォルトで無効です。
• API キーはX-Api-Keyヘッダーでのみ送信され、ログに記録されたり返されたりすることはありません。
• API リダイレクトは拒否されるため、認証情報が別のホストに転送されることはありません。
• チェックUUID、ping URLと更新URL、連携UUID、および将来追加される未知のAPIフィールドは、出力から削除されます。
• pingで保持されるのは、type、date、n、scheme、method、durationのみです。送信元IPアドレス、ユーザーエージェント、実行ID、本文URLは削除されます。
• pingの本文がリクエストされることはありません。
• サーバーはテレメトリーを収集しません。

API キーを含むクライアント設定ファイルを保護してください。必要なツールのみを公開する、専用のプロジェクトと最小権限のキーを使用してください。使用しなくなったキーは、Watchgooseのプロジェクト設定から取り消してください。

脆弱性は、SECURITY.mdに記載された方法で非公開に報告してください。

ワークフロースキル

このリポジトリには、スケジュール済みジョブのカバレッジ監査、単一ジョブのセットアップ案の作成、ハートビート未受信のトリアージ、既存の監視状態の確認、および監査結果、一覧、CSVに基づく承認済みの新規作成のみの一括処理の提案に使える、移植可能なスキルが含まれています。ローカルへのインストール方法、使用例、安全上の境界については、スキルガイドをご覧ください。スキルによってアクセス権が追加されたり、ジョブが自動実行されたり、既存のディレクトリ一覧が変更されたりすることはありません。

インストール可能な 監視プラグイン は plugins/watchgoose-monitoring/ にあり、正規のスキルツリーとリモート MCP アダプターを備えています。リポジトリのルートではなく、このサブフォルダーを読み込んでください。以前のルートにあったプラグイン／スキルのパスは廃止されており、インストール済みのコピーは自動移行されません。npm CLI とホスト型エンドポイントに変更はありません。

各リリースでは、プラグインを pixeware/watchgoose-pluginのルートとしても公開しています。

• Gemini CLI：gemini extensions install https://github.com/pixeware/watchgoose-plugin
• Grok Build：grok plugin install pixeware/watchgoose-plugin --trust
• Agent Skills を読み取るすべてのエージェント：npx skills add pixeware/watchgoose-plugin を実行し、クライアントにホスト型エンドポイントを追加します

開発

npm install
npm run format:check
npm run lint
npm run typecheck
npm test
npm run publish:dry-run

本番環境との統合テストはオプトイン方式で、専用のテストプロジェクトキーが必要です。CI では実行されません。

ユーザーに表示されるすべての配布物で、リリースバージョンは統一されています。npm パッケージ、server.json、ホスト型サーバー、Claude プラグインとポータブルプラグインのマニフェスト、および OpenAI プラグインが対象です。packages/core/src/constants.ts の WATCHGOOSE_RELEASE_VERSION と、対応するマニフェストを同時に更新してください。いずれかの値が一致しない場合、tests/skills/release-version.test.ts が失敗します。OpenAI のアップロード用 ZIP は npm run build:openai-plugin でビルドします。

サポート

• サポート：[email protected]
• ドキュメント：watchgoose.com/docs/mcp
• プライバシーポリシー：watchgoose.com/legal/privacy
• 利用規約：watchgoose.com/legal/terms

ライセンス

MIT

各種バッジ