Watchgoose MCP

Watchgoose MCP は、MCP 対応の AI クライアントを Watchgoose Management API に接続します。cron および定期タスクの監視を検査でき、チェックの変更は明示的に書き込みを有効にした場合のみ利用できます。

要件

• Node.js 20 以上

• プロジェクト設定からのプロジェクトスコープの Watchgoose API キー

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

Related MCP server: uptrack-mcp

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 を起動します。

環境

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

ツール

チェックは、安定した 40 文字の unique_key 値でアドレス指定されます。UUID、ping URL、統合 UUID はサーバー内でのみ使用され、AI クライアントには表示されません。

統合の割り当てには、正確な統合名を使用します。名前は空でなく、プロジェクト内で一意である必要があります。

リスト結果は、チェック 100 件、ping 100 件、フリップ 200 件、統合 100 件に制限されています。シリアル化された各ツール結果も 24,000 文字に制限されています。エントリが省略された場合、結果にはメタデータが含まれます。

セキュリティ

• 書き込みは、hcw_ キーを使用している場合でも、デフォルトで無効になっています。

• API キーは X-Api-Key ヘッダーでのみ送信され、ログに記録されたり返されたりすることはありません。

• API リダイレクトは拒否されるため、資格情報が別のホストに転送されることはありません。

• チェック UUID、ping および更新 URL、統合 UUID、および未知の将来の API フィールドは出力から削除されます。

• ping は type、date、n、scheme、method、duration のみを保持します。送信元 IP アドレス、ユーザーエージェント、実行 ID、本文 URL は削除されます。

• ping 本文は決して要求されません。

• サーバーにはテレメトリはありません。

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

開発

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

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

ライセンス

MIT