Watchgoose MCP

Watchgoose MCP подключает AI-клиенты с поддержкой MCP к Management API Watchgoose. С его помощью можно просматривать сведения о мониторинге cron и повторяющихся задач. Изменять проверки можно только после явного включения записи.

Hosted connector

Используйте размещённую конечную точку Streamable HTTP в клиентах с поддержкой OAuth 2.1 и Dynamic Client

Registration:

https://mcp.watchgoose.com/mcp

Доступно в

Watchgoose доступен в каталоге коннекторов Claude.

Watchgoose

включён в каталог плагинов ChatGPT для GPT и Codex.

Watchgoose

включён в официальный реестр MCP.

Пакет watchgoose-mcp доступен на npm.

В Claude откройте Settings > Connectors и добавьте конечную точку как пользовательский коннектор. В Claude

Code выполните команду:

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

В процессе подтверждения в браузере для каждого подключения выбирается только один проект. По умолчанию доступ предоставляется только для чтения. Описание инструментов и ограничений конфиденциальности см. в документации Watchgoose MCP.

Требования

Node.js 20 или более поздней версии
API-ключ Watchgoose для конкретного проекта. Создайте его в Project settings → API Access → Create (read-only).

Используйте ключ hcr_ с правами только на чтение, если вам нужны лишь данные о состоянии проверок и история изменений их статуса. Если дополнительно требуются пинги, интеграции или изменение проверок, используйте ключ 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 через браузер, выберите проект и сохраните доступ только для чтения, если не хотите разрешать Cline изменять проверки. Чтобы вместо этого использовать API-ключ проекта, добавьте в тот же файл запись с npx из раздела Cursor.

Переменные окружения

Переменная	Обязательна	Значение по умолчанию	Описание
`WATCHGOOSE_API_KEY`	Да	-	Ключ `hcr_` с правами только на чтение, ключ `hcw_` с правами на чтение и запись или устаревший 32-символьный ключ для конкретного проекта.
`WATCHGOOSE_API_URL`	Нет	`https://watchgoose.com/api/v3`	Базовый URL Management API. Требуется HTTPS, кроме локальных хостов для разработки. Ключ передаётся на этот хост, поэтому используйте только доверенный URL.
`WATCHGOOSE_ENABLE_WRITES`	Нет	`false`	Установите значение `true`, чтобы открыть инструменты изменения данных при использовании ключа с правами на чтение и запись.
`WATCHGOOSE_API_KEY_ACCESS`	Только для устаревших ключей	-	Для ключа без префикса длиной 32 символа необходимо указать `read-only` или `read-write`.

Сервер определяет права доступа по префиксу ключа локально и не обращается к API для их выяснения. Установка WATCHGOOSE_ENABLE_WRITES=true не расширяет права ключа, у которого есть только доступ для чтения.

Инструменты

Для обращения к проверкам используются стабильные значения unique_key длиной 40 символов. UUID, URL для пингов и UUID интеграций применяются только внутри сервера и не передаются AI-клиенту.

Инструмент	Необходимый доступ	Соответствующий запрос к Management API
`list_checks`	Только чтение	`GET /checks/`
`get_check`	Только чтение	`GET /checks/`
`list_flips`	Только чтение	`GET /checks//flips/`
`list_pings`	Чтение и запись	Поиск по `unique_key`, затем `GET /checks//pings/`
`list_channels`	Чтение и запись	`GET /channels/`
`create_check`	Чтение и запись, запись включена	`POST /checks/`
`update_check`	Чтение и запись, запись включена	Поиск по `unique_key`, затем `POST /checks/`
`pause_check`	Чтение и запись, запись включена	Поиск по `unique_key`, затем `POST /checks//pause`
`resume_check`	Чтение и запись, запись включена	Поиск по `unique_key`, затем `POST /checks//resume`
`delete_check`	Чтение и запись, запись включена	Поиск по `unique_key`, затем `DELETE /checks/`

Для назначения интеграций используются точные имена. Имена должны быть непустыми и не должны повторяться в пределах проекта.

Если указан unique, инструмент create_check выполняет операцию создания или обновления: у существующей проверки с совпадающим значением будут заменены переданные настройки. Если передать timeout без schedule, запланированная проверка также переключится на мониторинг с заданным интервалом: сохранённая строка расписания останется, но перестанет определять периодичность. Чтобы сохранить мониторинг по расписанию, укажите подтверждённое значение schedule. Другие непереданные настройки останутся без изменений.

Значение channels: [] удаляет все назначения интеграций оповещений. Поэтому инструмент указывает destructiveHint: true. При создании новой проверки, основанной на завершении задачи, сервер ожидает успешного или неуспешного завершения. Первый сбой может привести к снижению её статуса. Необязательный начальный пинг может запустить мониторинг выполнения до завершения задачи.

В результатах списков отображается не более 100 проверок, 100 пингов, 200 изменений статуса и 100 интеграций. Размер каждого сериализованного результата инструмента также ограничен 24 000 символами. Если часть записей не включена, в результат добавляются метаданные.

Безопасность

Запись отключена по умолчанию, даже при использовании ключа hcw_.
API-ключ передаётся только в заголовке X-Api-Key; он не записывается в журнал и не возвращается в результатах.
Перенаправления API отклоняются, поэтому учётные данные не могут быть переданы другому хосту.
UUID проверок, URL для пингов и обновлений, UUID интеграций, а также неизвестные поля будущих версий API удаляются из результатов.
В пингах сохраняются только поля type, date, n, scheme, method и duration. IP-адреса источников, user agent, идентификаторы запусков и URL из тел запросов удаляются.
Тела пингов никогда не запрашиваются.
Сервер не собирает телеметрию.

Защитите файлы конфигурации клиента, содержащие API-ключи. По возможности используйте отдельный проект и ключ с минимально необходимыми правами для нужных инструментов. Если ключ больше не используется, отзовите его в настройках проекта Watchgoose.

О конфиденциальном сообщении об уязвимостях см. в SECURITY.md.

Навыки для рабочих процессов

В репозитории собраны переносимые навыки для проверки полноты мониторинга запланированных заданий, подготовки конфигурации для отдельного задания, анализа пропущенных сигналов, оценки состояния существующего мониторинга и подготовки предлагаемых пакетов операций только на создание по результатам проверки, списку или CSV. Инструкции по локальной установке, примеры и ограничения безопасности см. в руководстве по навыкам. Навыки не предоставляют дополнительных прав доступа, не запускают задания автоматически и не меняют существующие записи в каталогах.

Устанавливаемый

плагин мониторинга

находится в plugins/watchgoose-monitoring/. В нём есть единое каноническое дерево навыков и адаптеры для удалённого MCP. Загружайте эту подпапку, а не корень репозитория: прежние пути к плагину и навыкам в корне больше не используются, а установленные копии автоматически не переносятся. CLI для npm и размещённая конечная точка остаются без изменений.

Каждый выпуск также публикует плагин в корне репозитория

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

Интеграционные тесты для production запускаются по запросу и требуют ключей для выделенного тестового проекта. В CI они не запускаются.

Во всех вариантах распространения для пользователей используется одна версия релиза: пакет npm, server.json, размещённый сервер, манифесты плагинов Claude и portable, а также плагин OpenAI. Одновременно обновляйте WATCHGOOSE_RELEASE_VERSION в packages/core/src/constants.ts и соответствующие манифесты. Тест tests/skills/release-version.test.ts завершится с ошибкой, если версии не совпадут. ZIP-архив для загрузки плагина OpenAI собирается командой npm run build:openai-plugin.

Поддержка

Поддержка: support@watchgoose.com
Документация: watchgoose.com/docs/mcp
Политика конфиденциальности: watchgoose.com/legal/privacy
Условия предоставления услуг: watchgoose.com/legal/terms

Лицензия

MIT