API

Klucze API i serwer MCP — podłącz zadania i finanse do automatyzacji albo do asystenta.

Ordiarion udostępnia dwie drogi dla programów: proste REST API do zadań oraz serwer MCP do finansów, czyli standardowe złącze, przez które asystent (Claude i inne) czyta i prowadzi budżet, kredyty, długi, konta, przychody i opłaty cykliczne. Obie drogi zabezpiecza ten sam klucz.

Tworzenie klucza

W Ustawieniach, w sekcji „Klucze API", nadaj kluczowi nazwę i zaznacz uprawnienia. Surowa wartość klucza pokazuje się dokładnie raz, zaraz po utworzeniu — zapisz ją od razu, bo nie da się jej odzyskać (można za to utworzyć nowy klucz albo unieważnić stary w dowolnym momencie).

Uprawnienia

Klucz leży potem miesiącami w cudzym pliku konfiguracyjnym, więc nie dostaje wszystkiego, co potrafi Twoje konto — dostaje to, co zaznaczysz:

Uprawnienie	Co otwiera
Zadania	REST API zadań. Można je dodatkowo zawęzić do jednej kategorii — wtedy klucz widzi tylko zadania w niej.
Finanse — odczyt	Serwer MCP, ale wyłącznie narzędzia, które czytają.
Finanse — zmiany	Narzędzia, które dopisują i zmieniają: transakcje, raty, spłaty. Obejmuje też odczyt.
Treści i marketing	Publikowanie artykułów. Widoczne tylko na koncie administratora.

Klucz z samym odczytem finansów nie widzi narzędzi zmieniających — nie są mu one pokazywane na liście, a wywołane po nazwie i tak zostaną odrzucone. To jest właściwy wybór, gdy chcesz, żeby asystent podsumowywał wydatki, ale nie miał prawa niczego w nich ruszyć.

Uwierzytelnianie

Każde żądanie musi zawierać nagłówek:

Authorization: Bearer <twój-klucz>

Serwer MCP (finanse)

Adres: https://ordiarion.com/api/mcp. To transport „streamable HTTP", bezstanowy — każde żądanie niesie własny klucz, nie ma sesji do wygaśnięcia.

Podłączenie w Claude Code:

claude mcp add --transport http ordiarion \
  https://ordiarion.com/api/mcp \
  --header "Authorization: Bearer <twój-klucz>"

W aplikacjach z własnym konfiguratorem (Claude Desktop, inne klienty MCP) wpisz ten sam adres i ten sam nagłówek.

Co serwer udostępnia

Narzędzia — po jednym na czynność, pogrupowane modułami:

Moduł	Narzędzia
Przegląd	`finance_overview` — wszystko naraz, dobre pierwsze wywołanie
Kalendarz	`calendar_month`, `calendar_upcoming`, `list_planned`, `create_planned`, `update_planned`, `delete_planned`, `mark_planned_paid`
Budżet	kategorie (`list_categories`, `create_category`, `update_category`, `delete_category`), transakcje (`list_transactions`, `create_transaction`, `update_transaction`, `delete_transaction`), `month_summary`, `list_projects`, `project_detail`
Kredyty	`list_loans`, `loan_detail`, `loans_summary`, `create_loan`, `update_loan`, `delete_loan`, `pay_loan_installment`, `revert_last_loan_payment`
Długi	`list_debts`, `debt_detail`, `debts_summary`, `create_debt`, `update_debt`, `delete_debt`, `repay_debt`, `revert_debt_repayment`
Konta i majątek	`list_accounts`, `create_account`, `record_account_balance`, `net_worth`, `list_assets`, `reconciliation`
Opłaty cykliczne	`list_recurring`, `recurring_summary`, `recurring_period`, `create_recurring`, `delete_recurring`, `pay_recurring`, `recurring_suggestions`
Przychody	`list_income_sources`, `list_income_entries`, `add_income_entry`, `income_year`

Zasoby — gotowe adresy do przypięcia do rozmowy: ordiarion://guide (jak moduły mają się do siebie), ordiarion://finance/overview, ordiarion://calendar/upcoming, ordiarion://budget/categories, ordiarion://budget/current-month, ordiarion://loans, ordiarion://debts, ordiarion://accounts.

Gotowe pytania — do wybrania z listy zamiast pisania od zera: przegląd miesiąca, szukanie pieniędzy, które zniknęły bez śladu, plan wychodzenia z długów, przegląd subskrypcji, i co jeszcze czeka w tym miesiącu.

O czym warto wiedzieć

Klucz sięga wyłącznie do konta, do którego należy. Nie ma parametru „czyje dane", a budżet udostępniony Ci przez kogoś innego otwiera się w aplikacji, nie przez klucz.
Odnotowanie raty (pay_loan_installment), odhaczenie opłaty cyklicznej (pay_recurring) i odhaczenie pozycji z kalendarza (mark_planned_paid) same dopisują wydatek do budżetu. Osobnej transakcji już się nie dodaje.
Kwoty jadą jako tekst z kropką ("129.99"), daty jako RRRR-MM-DD, miesiące jako RRRR-MM. Brak miesiąca znaczy „bieżący".

Endpointy zadań

Wszystkie ścieżki zaczynają się od https://ordiarion.com/api/public/tasks. Statusy zadań to TODO albo DONE. Świadomie brak tworzenia i usuwania zadań przez API — te dwie akcje zostają w interfejsie, klucz służy do sprawdzania i aktualizowania tego, co już istnieje.

Metoda	Ścieżka	Opis
GET	`/`	Lista zadań (parametr `status` opcjonalny)
GET	`/{id}`	Jedno zadanie
PATCH	`/{id}/status`	Zmiana statusu, body `{"status":"DONE"}`
GET	`/{id}/comments`	Komentarze do zadania
POST	`/{id}/comments`	Nowy komentarz, body `{"body":"…"}`

Zadanie spoza zasięgu klucza (cudze albo z innej kategorii niż ta, do której klucz jest zawężony) zwraca 404, tak samo jak zadanie, które nie istnieje.

Przykład

curl -H "Authorization: Bearer <twój-klucz>" \
     https://ordiarion.com/api/public/tasks?status=TODO

Unieważnienie

W Ustawieniach, przy kluczu, przycisk „Unieważnij" — działa natychmiast i nieodwracalnie. Każda automatyzacja korzystająca z tego klucza przestaje mieć dostęp od razu, razem z podłączonym asystentem.