Watchgoose MCP

Watchgoose MCP는 MCP를 지원하는 AI 클라이언트를 Watchgoose Management API에 연결합니다. 이를 통해 cron 및 반복 작업 모니터링을 확인할 수 있으며, 체크 변경은 쓰기를 명시적으로 활성화한 경우에만 사용할 수 있습니다.

요구 사항

• Node.js 20 이상

• 프로젝트 설정에서 발급받은 프로젝트 범위의 Watchgoose API 키

체크 상태와 상태 기록만 필요하다면 hcr_ 읽기 전용 키를 사용하세요. 핑, 통합 또는 체크 변경도 필요하다면 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, 핑 URL, 통합 UUID는 서버 내부에서만 사용되며 AI 클라이언트에는 표시되지 않습니다.

통합 할당은 정확한 통합 이름을 사용합니다. 이름은 비어 있지 않아야 하며 프로젝트 내에서 고유해야 합니다.

목록 결과는 체크 100개, 핑 100개, 플립 200개, 통합 100개로 제한됩니다. 모든 직렬화된 도구 결과도 24,000자로 제한됩니다. 항목이 생략되면 결과에 메타데이터가 포함됩니다.

보안

• 쓰기는 기본적으로 비활성화되어 있으며, hcw_ 키를 사용해도 마찬가지입니다.

• API 키는 X-Api-Key 헤더로만 전송되며 절대 로그에 기록되거나 반환되지 않습니다.

• API 리디렉션은 거부되므로 자격 증명이 다른 호스트로 전달될 수 없습니다.

• 체크 UUID, 핑 및 업데이트 URL, 통합 UUID, 알 수 없는 향후 API 필드는 출럭에서 제거됩니다.

• 핑은 type, date, n, scheme, method, duration만 유지합니다. 출발지 IP 주소, 사용자 에이전트, 실행 ID, 본문 URL은 제거됩니다.

• 핑 본문은 절대 요청되지 않습니다.

• 서버에는 텔레메트리가 없습니다.

API 키가 포합된 클라인트 구정 파일을 보호하세요. 전용 프젝트와 필한 도구를 노출하는 최소 권한 키를 사용하는 것이 좋습니다. 더 이상 사요하지 않을 때 Watchgoose 프젝트 설정에서 키를 해지하세요.

개방

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

프로덕션 통합 테스트는 옵트인이며 전용 테스트 프젝트 키가 필합니다. CI에서는 절대 실핵되지 않습니다.

라이선스

MIT