Agenci AI i MCP
HelloCron udostępnia jeden pakiet dla asystentów AI i agentów programistycznych: trzy Agent Skills, które uczą model obsługi klienta shell, projektowania monitoringu i wywoływania API, oraz zdalny serwer MCP, przez który model zarządza monitorami na Twoim koncie. Wszystko żyje w publicznym repozytorium hellocron/agent-plugin.
Co dostajesz
| Element | Co robi | Działa w |
|---|---|---|
Skille (SKILL.md) | Instrukcje ładowane przez agenta na żądanie: instalacja i użycie hellocron.sh, dobór interwału i tolerancji, opakowanie zadań cron, bundle, wywołania API | Claude Code, Codex CLI, Cursor, GitHub Copilot, Gemini CLI i każde narzędzie czytające format Agent Skills |
| Serwer MCP | Narzędzia takie jak list_monitors, create_monitor, apply_monitor_bundle, ping, działające na Twoich kluczach API | Claude (Desktop, Code, claude.ai), ChatGPT (Developer Mode), Codex, Cursor, Gemini CLI, VS Code |
| Paczka pluginu | Skille i połączenie MCP w formacie Agent Plugins, więc jedna instalacja dodaje oba | Claude Code, Codex, ChatGPT |
llms.txt | Indeks tej dokumentacji dla modeli: /llms.txt i pełny tekst w /llms-full.txt | każdy agent z dostępem do sieci |
Serwer MCP nie przechowuje Twoich kluczy. Każde żądanie jest przekazywane do publicznego API z nagłówkiem Authorization ustawionym w kliencie, więc limity planu, limity zapytań i zakres klucza działają dokładnie tak samo jak przy curl.
Klucze
Klucze tworzysz w panelu w Ustawienia → Klucze API:
- klucz ingest (
ck_...) do pingów; można go trzymać na monitorowanych serwerach, - klucz zarządzający (
mk_...) do listowania, tworzenia, edycji, usuwania i stosowania bundle’i; trzymaj go tylko na swojej stacji roboczej lub w sekretach CI.
Klientowi MCP podaj klucz zarządzający, gdy agent ma zarządzać monitorami, a klucz ingest, gdy ma tylko wysyłać pingi.
Claude Code
claude plugin marketplace add hellocron/agent-pluginclaude plugin install hellocron@hellocronPlugin rejestruje skille (/hellocron:hellocron-cli, /hellocron:hellocron-monitoring, /hellocron:hellocron-api) oraz serwer MCP. Klucz ustawiasz raz:
claude mcp add --transport http hellocron https://mcp.hellocron.com/mcp \ --header "Authorization: Bearer mk_..."Codex CLI i ChatGPT
codex plugin marketplace add hellocron/agent-pluginNastępnie włącz plugin HelloCron w Codex lub ChatGPT. Przy pytaniu o połączenie wklej https://mcp.hellocron.com/mcp i swój klucz. Bez pluginu ChatGPT w trybie Developer Mode przyjmuje ten sam adres jako własne połączenie MCP, a Custom GPT może korzystać z API bezpośrednio przez Actions: zaimportuj https://docs.hellocron.com/openapi.yaml i wybierz uwierzytelnianie kluczem API w nagłówku Authorization: Bearer.
Cursor, Gemini CLI, VS Code i inne klienty MCP
Dodaj serwer do konfiguracji MCP klienta:
{ "mcpServers": { "hellocron": { "type": "streamable-http", "url": "https://mcp.hellocron.com/mcp", "headers": { "Authorization": "Bearer mk_..." } } }}Skille skopiuj z katalogu skills/ repozytorium do miejsca, które czyta Twoje narzędzie (.cursor/skills/, .gemini/skills/, .agents/skills/ albo skills/ w projekcie; patrz dokumentacja narzędzia). To zwykłe pliki Markdown, bez budowania.
Przykładowe polecenia
- „Zainstaluj klienta HelloCron na tym serwerze, sprawdź go przez doctor i opakuj każde zadanie w
/etc/cron.d, żeby awarie mnie alertowały.” - „Załóż check HTTP dla
https://api.example.com/healthco minutę, oczekujący 200 i tekstuok, oraz check SSL dlaexample.com.” - „Wyeksportuj moje monitory jako bundle, dodaj nocny monitor ping
db-backupz godziną tolerancji i zastosuj go najpierw na sucho.”
Narzędzia udostępniane przez serwer MCP
| Narzędzie | Endpoint | Uwagi |
|---|---|---|
get_account | GET /api/v1/account | tylko odczyt |
list_monitors, get_monitor | GET /api/v1/monitors[/{uuid}] | tylko odczyt |
export_monitors | GET /api/v1/monitors/export | tylko odczyt |
create_monitor, update_monitor | POST, PUT /api/v1/monitors | manifesty, patrz Monitory |
apply_monitor_bundle | POST /api/v1/monitors/apply | obsługuje dry_run, nigdy nie usuwa |
delete_monitor | DELETE /api/v1/monitors/{uuid}?confirm=true | destrukcyjne, wymaga confirm: true |
ping | POST /ping | wymaga klucza ingest |
get_health | GET /health | sprawdzenie dostępności |
Narzędzia niosą adnotacje MCP (readOnlyHint, destructiveHint), więc klienty mogą prosić o potwierdzenie przed zapisem. Pełny kontrakt to dokument OpenAPI.