Serwer MCP

Serwer MCP (Model Context Protocol) Ogarni.AI umożliwia modelom językowym bezpośredni dostęp do Twoich danych finansowych. Działa z Claude Code, Claude Desktop, Cursor, Windsurf i innymi klientami obsługującymi protokół MCP.

Czym jest MCP?

Model Context Protocol to otwarty standard komunikacji między modelami językowymi a zewnętrznymi źródłami danych. Serwer MCP Ogarni.AI udostępnia dane z API jako narzędzia (tools), z których model może korzystać w trakcie konwersacji.

Dzięki temu możesz zadawać pytania w języku naturalnym, np.:

• “Ile wydałem w tym miesiącu na jedzenie?”
• “Pokaż moje ostatnie paragony z Biedronki”
• “Jakie mam wydatki cykliczne?”

Dostępne narzędzia

Serwer udostępnia 20 narzędzi tylko do odczytu:

Narzędzie	Opis
ogarniai_list_documents	Lista paragonów z filtrami dat i sortowaniem
ogarniai_get_document	Szczegóły pojedynczego paragonu
ogarniai_get_document_image	Obraz paragonu
ogarniai_get_document_duplicates	Sugestie duplikatów dokumentu
ogarniai_list_categories	Lista kategorii wydatków/przychodów
ogarniai_list_tags	Lista tagów użytkownika
ogarniai_get_weekly_summary	Najnowsze podsumowanie tygodniowe
ogarniai_get_weekly_summary_periods	Lista okresów podsumowań
ogarniai_get_summary_by_period	Podsumowanie dla zakresu dat
ogarniai_get_current_period	Podsumowanie dla predefiniowanego okresu
ogarniai_list_notifications	Lista powiadomień z filtrami
ogarniai_get_notification	Szczegóły powiadomienia
ogarniai_get_unread_count	Liczba nieprzeczytanych powiadomień
ogarniai_list_groups	Lista grup finansowych
ogarniai_get_group	Szczegóły grupy
ogarniai_list_mailboxes	Adresy e-mail do przesyłania paragonów
ogarniai_list_dedup_suggestions	Sugestie duplikatów
ogarniai_list_loyalty_accounts	Konta programów lojalnościowych
ogarniai_list_supported_banks	Obsługiwane banki
ogarniai_get_recurring_expenses	Wydatki cykliczne

Konfiguracja

Serwer konfiguruje się przez zmienne środowiskowe:

Zmienna	Wymagana	Domyślna	Opis
OGARNIAI_API_TOKEN	Tak	—	Token API (zaczyna się od oai_)
OGARNIAI_API_URL	Nie	https://api.ogarni.ai	Bazowy URL API

Bezpieczeństwo

Serwer MCP został zaprojektowany z myślą o bezpieczeństwie:

• Tylko odczyt — wszystkie narzędzia są read-only, nie mogą modyfikować danych
• Token w zmiennej środowiskowej — nigdy nie jest hardcodowany w konfiguracji
• Walidacja danych wejściowych — schematy Zod weryfikują wszystkie parametry narzędzi
• Brak ekspozycji tokenu — komunikaty błędów nigdy nie zawierają wartości tokenu

Następne kroki

Przejdź do instrukcji instalacji, aby skonfigurować serwer MCP w swoim narzędziu.