MCP do powiadomień Pushover

Chcę, abyś stworzył i wdrożył na tym serwerze kompletny, prosty i bezpieczny serwer MCP umożliwiający agentom AI wysyłanie powiadomień na mój telefon przez usługę Pushover.

Dane dostępowe do Pushover:

* User Key: [WSTAW_USER_KEY]
* API/Application Token: [WSTAW_API_TOKEN]

Potraktuj te dane jako sekrety. Nie zapisuj ich bezpośrednio w kodzie aplikacji, plikach dostępnych publicznie ani w repozytorium Git. Umieść je w bezpiecznej konfiguracji, np. zmiennych środowiskowych lub pliku konfiguracyjnym znajdującym się poza katalogiem publicznym serwera [WWW](http://WWW).

Twoim zadaniem jest samodzielne zaprojektowanie, utworzenie, skonfigurowanie, wdrożenie i przetestowanie rozwiązania.

Serwer MCP powinien udostępniać narzędzie:

`send_notification`

Narzędzie ma umożliwiać agentowi AI wysłanie wiadomości przez Pushover.

Minimalnym wymaganym parametrem powinna być:

* `message` – treść wiadomości.

Dodatkowo obsłuż opcjonalne parametry:

* `title` – tytuł powiadomienia,
* `priority` – priorytet wiadomości,
* `sound` – dźwięk powiadomienia Pushover,
* `url` – opcjonalny adres URL,
* `url_title` – tekst wyświetlany zamiast adresu URL,
* `html` – możliwość użycia formatowania HTML, jeśli Pushover to obsługuje,
* `device` – opcjonalne wskazanie konkretnego urządzenia,
* `timestamp` – opcjonalny czas zdarzenia.

Jeżeli dany parametr nie zostanie podany, użyj bezpiecznych i rozsądnych wartości domyślnych.

Zadbaj o poprawną walidację danych wejściowych. Agent nie powinien być w stanie wysłać przypadkowo błędnego żądania, nieprawidłowego priorytetu, zbyt długiej wiadomości lub wartości nieobsługiwanej przez API Pushover.

W przypadku błędu zwracaj agentowi jednoznaczną informację, np.:

* czy błąd nastąpił po stronie MCP,
* czy połączenie z Pushover nie działa,
* czy Pushover odrzucił żądanie,
* czy podano niepoprawne parametry.

Nie zwracaj w komunikatach błędów żadnych sekretów, tokenów ani danych uwierzytelniających.

## Bezpieczeństwo

MCP nie może być publicznie dostępny bez zabezpieczenia.

Zabezpiecz dostęp własnym tokenem autoryzacyjnym lub innym prostym mechanizmem odpowiednim dla tego zastosowania.

Token dostępu do MCP:

* wygeneruj losowo,
* zapisz poza publicznym katalogiem WWW,
* nie umieszczaj w kodzie źródłowym,
* nie zapisuj w repozytorium,
* pokaż mi go na końcu instalacji razem z instrukcją konfiguracji klienta.

Jeżeli serwer MCP będzie dostępny przez Internet, użyj HTTPS.

Jeżeli na serwerze istnieje już poprawnie skonfigurowany serwer WWW, reverse proxy lub certyfikat Let's Encrypt, wykorzystaj istniejącą infrastrukturę zamiast tworzyć niepotrzebnie nowe komponenty.

Nie otwieraj dodatkowych portów publicznych, jeżeli nie jest to konieczne.

## Architektura

Najpierw sprawdź środowisko serwera i dostępne technologie.

Wybierz możliwie proste i lekkie rozwiązanie.

Jeżeli obecna konfiguracja serwera pozwala wykonać MCP w PHP, możesz użyć PHP. Jeśli istnieje istotny techniczny powód, dla którego inne rozwiązanie będzie wyraźnie lepsze, możesz zastosować np. Node.js lub Python, ale wyjaśnij krótko swoją decyzję.

Nie instaluj dużych frameworków ani zbędnych zależności.

Priorytety:

1. prostota,
2. bezpieczeństwo,
3. stabilność,
4. łatwość utrzymania,
5. minimalna liczba zależności.

Rozwiązanie powinno nadawać się do długotrwałego działania na VPS.

## Integracja z Pushover

Do komunikacji wykorzystaj oficjalne API Pushover.

Obsłuż poprawnie odpowiedź API i zwracane przez nie błędy.

Jeżeli Pushover zwraca identyfikator żądania lub inne informacje diagnostyczne przydatne do debugowania, możesz je zachować w logach, ale nie zapisuj danych wrażliwych.

Dźwięk powinien być parametrem opcjonalnym, tak aby agent mógł np. wysłać:

zwykłe powiadomienie:

`send_notification(message="Backup zakończony poprawnie")`

powiadomienie z tytułem:

`send_notification(title="Backup", message="Backup serwera został wykonany")`

alarm:

`send_notification(title="ALARM VPS", message="Wykryto poważny problem z serwerem", priority=1, sound="siren")`

Jeżeli nazwa dźwięku jest nieprawidłowa, obsłuż sytuację w kontrolowany sposób.

## Priorytety wiadomości

Jeżeli API Pushover obsługuje różne poziomy priorytetów, zaimplementuj je zgodnie z dokumentacją.

Zabezpiecz szczególnie najwyższy poziom priorytetu, jeśli wymaga dodatkowych parametrów lub powoduje powtarzające się alarmy.

Nie ustawiaj najwyższego priorytetu jako wartości domyślnej.

Domyślny priorytet powinien oznaczać zwykłe powiadomienie.

## Logowanie

Dodaj proste logowanie zdarzeń.

Loguj:

* datę i godzinę,
* czy wysłanie wiadomości się powiodło,
* wynik odpowiedzi Pushover,
* podstawowe informacje diagnostyczne przy błędzie.

Nie zapisuj w logach:

* User Key,
* API Token Pushover,
* tokenu zabezpieczającego MCP,
* pełnych nagłówków autoryzacyjnych.

Jeżeli to możliwe, nie zapisuj również pełnej treści prywatnych wiadomości. Wystarczy informacja o poprawnym wysłaniu lub ewentualnie skrócona treść diagnostyczna.

## Testy

Po wdrożeniu przeprowadź test całego rozwiązania.

Wykonaj co najmniej:

1. zwykłe powiadomienie,
2. powiadomienie z tytułem,
3. powiadomienie z wybranym dźwiękiem,
4. test błędnego żądania,
5. test dostępu bez poprawnego tokenu MCP.

Wyślij testową wiadomość:

`Test MCP Pushover – połączenie działa poprawnie.`

Jeżeli wiadomość zostanie poprawnie przyjęta przez API Pushover, uznaj integrację za działającą.

Nie wykonuj dużej liczby testowych powiadomień.

## Dokumentacja

Po zakończeniu przygotuj krótką dokumentację administratora.

Podaj:

* gdzie znajduje się kod MCP,
* gdzie znajduje się konfiguracja,
* gdzie zapisane są sekrety,
* gdzie znajdują się logi,
* pod jakim adresem działa MCP,
* jak uruchomić lub zrestartować usługę,
* jak sprawdzić jej status,
* jak zaktualizować User Key lub API Token Pushover,
* jak zmienić token dostępu do MCP.

Jeżeli utworzysz usługę systemd, podaj jej nazwę.

## Konfiguracja Claude Code

Na końcu przygotuj dokładną konfigurację potrzebną do podłączenia tego MCP do Claude Code.

Nie opisuj jej tylko słownie.

Podaj gotowy fragment konfiguracji do skopiowania.

Konfiguracja powinna zawierać:

* adres MCP,
* wymagany sposób autoryzacji,
* token MCP lub miejsce, w którym należy go wstawić,
* nazwę serwera MCP.

Nazwij serwer:

`pushover`

Po podłączeniu Claude Code powinien widzieć narzędzie:

`send_notification`

Podaj również przykład użycia tego narzędzia przez agenta.

## Końcowy raport

Po zakończeniu przedstaw krótki raport w formacie:

### Status

Czy MCP działa poprawnie.

### Adres MCP

Adres endpointu.

### Dostępne narzędzia

Lista dostępnych narzędzi MCP.

### Zabezpieczenie

Jak MCP jest chronione.

### Pliki

Najważniejsze pliki i ich lokalizacje.

### Test

Wynik testowego powiadomienia Pushover.

### Claude Code

Gotowa konfiguracja do wklejenia.

### Przykładowe użycie

Przykład zwykłego powiadomienia i alarmu.

### Utrzymanie

Komendy potrzebne do sprawdzenia statusu, restartu oraz podejrzenia logów.

Nie kończ zadania wyłącznie na napisaniu kodu. Doprowadź wdrożenie do stanu, w którym MCP faktycznie działa na tym serwerze i zostało przetestowane.

Nie zmieniaj niezwiązanych z zadaniem elementów konfiguracji serwera. Nie wyłączaj istniejących zabezpieczeń, firewalla ani usług. Jeżeli wykryjesz konflikt z istniejącą konfiguracją, dostosuj rozwiązanie do środowiska zamiast przebudowywać serwer.

Jeżeli podczas realizacji znajdziesz drobne kwestie techniczne, które możesz jednoznacznie i bezpiecznie rozwiązać samodzielnie, zrób to bez pytania mnie o każdą decyzję. Pytaj tylko wtedy, gdy wykonanie operacji wiązałoby się z ryzykiem uszkodzenia istniejącej konfiguracji lub wymaga podjęcia istotnej decyzji dotyczącej architektury.