Oricalo dla asystentów AI i programistów

Pozwól Claude, ChatGPT albo własnym skryptom czytać i aktualizować Twój budżet - bezpiecznie i tylko za Twoją zgodą.

Połącz swojego asystenta AI

Oricalo udostępnia serwer MCP - otwarty standard, dzięki któremu asystenci AI współpracują z innymi aplikacjami. Połączenie zajmuje minutę i nigdy nie wymaga Twojego hasła.

1. Skopiuj adres konektora:

   https://oricalo.com/server/mcp

2. Claude: Ustawienia → Connectors → Add custom connector i wklej adres. ChatGPT: dodaj własny konektor (tryb deweloperski) z tym samym adresem. Inny klient MCP: dodaj zdalny serwer (Streamable HTTP) z tym adresem URL.
3. Zaloguj się do Oricalo, gdy zostaniesz poproszony, i zatwierdź połączenie. To Ty decydujesz, czy asystent może wprowadzać zmiany, czy tylko czytać.

MCP client config:

{
  "mcpServers": {
    "oricalo": { "url": "https://oricalo.com/server/mcp" }
  }
}

A potem po prostu zapytaj

• „Ile wydałem na zakupy spożywcze w tym miesiącu?”
• „Zapisz 12,40 € za lunch u Mario dzisiaj.”
• „Czy gdzieś przekroczyłem budżet w tym miesiącu?”
• „Przelej 50 € do skarbonki na wakacje.”
• „Jestem winny tacie 5 €.”
• „Zapłaciłem rachunek za prąd.”

Co może zrobić asystent

W Claude Oricalo oferuje też gotowe polecenia: Podsumowanie miesiąca, Znajdź oszczędności i Czy mieszczę się w budżecie w tym miesiącu?

Tryb deep research w ChatGPT też może czytać Oricalo - przez standardowe narzędzia search i fetch.

Bezpieczne z założenia

• Zatwierdzasz każdą aplikację. Nic się nie połączy, dopóki się nie zalogujesz i na to nie pozwolisz.
• Tryb tylko do odczytu jednym kliknięciem. Odznacz „Zezwól na zmiany”, a asystent będzie mógł tylko patrzeć.
• Konto pozostaje Twoje. Aplikacje i klucze nigdy nie zobaczą Twojego hasła ani nie zmienią e-maila, planu, płatności czy ustawień bezpieczeństwa.
• Każdą zmianę można cofnąć. Ustawienia → AI i API pokazują, co zmieniła każda aplikacja lub klucz, i cofają jedną zmianę albo wszystko, co zrobiła dzisiaj. Usunięte wpisy zostają też w Ostatnio usuniętych przez 30 dni.
• Widać, kto co zrobił. Wpisy dodane przez asystenta są oznaczone jego nazwą.
• Odłącz w każdej chwili w Ustawienia → AI i API - dostęp kończy się natychmiast.

REST API z osobistymi kluczami

Dla własnych skryptów i narzędzi: utwórz klucz w Ustawienia → AI i API - tylko do odczytu albo z prawem zmian, z datą wygaśnięcia - i wywołuj nim API.

Bazowy URL: https://oricalo.com/server

Wyślij klucz w nagłówku Authorization:

Authorization: Bearer ocl_your_key

Odczyt podsumowania miesiąca:

curl "https://oricalo.com/server/api/summary/month?year=2026&month=10" \
  -H "Authorization: Bearer ocl_your_key"

Dodanie wydatku (type 0 = wydatek, 1 = przychód):

curl -X POST "https://oricalo.com/server/api/transactions" \
  -H "Authorization: Bearer ocl_your_key" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-10-22","amount":12.40,"type":0,"categoryId":7,"accountId":1,"description":"Lunch"}'

Specyfikacja OpenAPI · Interaktywna dokumentacja API

Warto wiedzieć

• Klucz tylko do odczytu może wysyłać wyłącznie żądania GET.
• Do 300 żądań na minutę na użytkownika.
• Wysyłaj nagłówek X-Idempotency-Key przy zapisach, aby ponowienia były bezpieczne.
• Błędy wracają jako JSON: {"message": "…"}.
• Klucze mają dostęp tylko do danych budżetu - nigdy do logowania, płatności ani ustawień konta.

Szczegóły OAuth dla programistów

Budujesz klienta MCP albo integrację? Serwer autoryzacji jest zgodny ze specyfikacją autoryzacji MCP:

• Metadane chronionego zasobu (RFC 9728) i serwera autoryzacji (RFC 8414)
• Otwarta dynamiczna rejestracja klientów (RFC 7591)
• Przepływ authorization code z PKCE (tylko S256), rotacja refresh tokenów, unieważnianie (RFC 7009)
• Zakresy: read i write. Access tokeny ważne są godzinę, refresh tokeny 90 dni.

https://oricalo.com/server/.well-known/oauth-protected-resource/mcp
https://oricalo.com/server/.well-known/oauth-authorization-server

Pytania

Czy asystent dostaje moje hasło?

Nie. Logujesz się na stronie samego Oricalo i zatwierdzasz połączenie; asystent dostaje token, który sięga tylko do danych budżetu, a Ty możesz go w każdej chwili unieważnić.

Czy asystent może usunąć moje dane?

Tylko jeśli zezwolisz na zmiany i tylko wpisy - które trafiają do Ostatnio usuniętych na 30 dni, więc można je przywrócić. Nie może usunąć konta ani zmienić ustawień.

Którzy asystenci współpracują z Oricalo?

Każdy asystent lub narzędzie obsługujące zdalne serwery MCP z logowaniem OAuth, na przykład Claude i ChatGPT. Programiści mogą też korzystać bezpośrednio z REST API z osobistym kluczem.

Jakiego planu potrzebuję?

Plus. Łączenie asystenta i klucze API są częścią planu Plus i jego darmowego okresu próbnego, więc możesz najpierw spróbować. Jeśli przejdziesz na darmowy plan, klucze i połączone aplikacje zostaną wstrzymane (nie usunięte) i zaczną działać, gdy tylko zmienisz plan na wyższy.

Gdzie trafiają moje dane, gdy czyta je asystent?

Dane pobrane przez asystenta są wysyłane do jego dostawcy i przetwarzane zgodnie z jego warunkami. Nasza Polityka prywatności wyjaśnia to szczegółowo. →