Przejdź do treści

Instalacja serwera MCP

Hostowany serwer zdalny https://mcp.ogarni.ai/mcp loguje Cię przez OAuth w przeglądarce. Nie tworzysz, nie kopiujesz i nie przechowujesz tokenu API. Serwer jest wdrażany w wersji beta i może nie być jeszcze dostępny dla Twojego konta; jeśli połączenie się nie uda, użyj serwera lokalnego opisanego niżej.

Okno terminala
claude mcp add --transport http ogarniai https://mcp.ogarni.ai/mcp

Następnie uruchom /mcp w Claude Code, wybierz ogarniai i zaloguj się do Ogarni w przeglądarce.

W ustawieniach otwórz Konektory i dodaj własny konektor z adresem https://mcp.ogarni.ai/mcp. Pola OAuth Client ID i Client Secret zostaw puste: Claude rejestruje się sam. Po zapisaniu kliknij Połącz i zaloguj się do Ogarni.

Dodaj nową aplikację (konektor) z adresem https://mcp.ogarni.ai/mcp i uwierzytelnianiem OAuth. Nie podawaj identyfikatora klienta, ChatGPT rejestruje się automatycznie.

Dodaj do .vscode/mcp.json:

{
"servers": {
"ogarniai": { "type": "http", "url": "https://mcp.ogarni.ai/mcp" }
}
}

Dodaj do ~/.cursor/mcp.json:

{
"mcpServers": {
"ogarniai": { "url": "https://mcp.ogarni.ai/mcp" }
}
}
Okno terminala
codex mcp add ogarniai --url https://mcp.ogarni.ai/mcp
codex mcp login ogarniai

W Gemini CLI dodaj do settings.json serwer z polem "httpUrl": "https://mcp.ogarni.ai/mcp". W każdym innym kliencie dodaj https://mcp.ogarni.ai/mcp jako zdalny serwer MCP (Streamable HTTP) i przejdź przez logowanie oraz stronę zgody Ogarni.

Serwer obsługuje oba standardowe sposoby rejestracji klienta OAuth: Client ID Metadata Documents (Claude, ChatGPT, VS Code) i Dynamic Client Registration (Cursor, Codex, Gemini CLI, MCP Inspector). Nie musisz niczego rejestrować ręcznie.

Nigdy nie wklejaj tokenu Firebase ani tokenu API Ogarni do zdalnego konektora. Serwer zdalny udostępnia obecnie narzędzia ogarniai_get_financial_overview, ogarniai_get_spending_summary, ogarniai_search_documents, ogarniai_get_document_details i ogarniai_list_categories. Do pozostałych danych (obrazy paragonów, powiadomienia, grupy, skrzynki, programy lojalnościowe, tagi, wydatki cykliczne, podsumowania tygodniowe) użyj serwera lokalnego.

Serwer lokalny działa na Twoim komputerze przez stdio i uwierzytelnia się tokenem API. Jest nadal wspierany dla narzędzi, których serwer zdalny jeszcze nie udostępnia.

Przed instalacją potrzebujesz:

  • Node.js 20 lub nowszego,
  • tokenu API z uprawnieniem read. Jeśli jeszcze go nie masz, pobierz aplikację mobilną i utwórz token w ustawieniach.

Uruchom poniższą komendę w terminalu:

Okno terminala
claude mcp add ogarniai-mcp \
-e OGARNIAI_API_TOKEN=oai_twoj_token \
-- npx -y github:IsidoreSoftware/ogarniai-mcp

To wystarczy — serwer będzie automatycznie dostępny w sesjach Claude Code.

Ta sama komenda obsługuje klienty MCP 2026-07-28 oraz starsze wersje protokołu. Nie musisz dodawać wersji protokołu do konfiguracji serwera.

Dodaj poniższy blok do pliku konfiguracyjnego MCP:

{
"mcpServers": {
"ogarniai": {
"command": "npx",
"args": [
"-y",
"github:IsidoreSoftware/ogarniai-mcp"
],
"env": {
"OGARNIAI_API_TOKEN": "oai_twoj_token"
}
}
}
}
NarzędzieŚcieżka pliku
Claude Desktop (macOS)~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)%APPDATA%\Claude\claude_desktop_config.json
CursorUstawienia > MCP Servers
WindsurfUstawienia > MCP

Jeśli chcesz rozwijać serwer lub testować zmiany lokalnie:

Okno terminala
# Sklonuj repozytorium
git clone https://github.com/IsidoreSoftware/ogarniai-mcp.git
cd ogarniai-mcp
# Zainstaluj zależności
npm install
# Zbuduj serwer
npm run build
# Uruchom z tokenem
OGARNIAI_API_TOKEN=oai_twoj_token node dist/index.js

Aby użyć lokalnej wersji w konfiguracji MCP, wskaż na zbudowany plik:

{
"mcpServers": {
"ogarniai": {
"command": "node",
"args": ["/sciezka/do/ogarniai-mcp/dist/index.js"],
"env": {
"OGARNIAI_API_TOKEN": "oai_twoj_token"
}
}
}
}

Po zainstalowaniu serwera otwórz nową sesję w swoim narzędziu i poproś o:

“Pokaż moje ostatnie podsumowanie tygodniowe z Ogarni.AI”

Jeśli serwer jest poprawnie skonfigurowany, model użyje narzędzia ogarniai_get_weekly_summary i zwróci Twoje dane finansowe.

ProblemRozwiązanie
Serwer nie startujeSprawdź, czy OGARNIAI_API_TOKEN jest ustawiony i zaczyna się od oai_
Błąd 401Token jest nieprawidłowy lub wygasły — utwórz nowy w ustawieniach
Brak narzędzi w narzędziuZrestartuj sesję po dodaniu konfiguracji MCP
TimeoutSprawdź połączenie z https://api.ogarni.ai
Nieobsługiwana wersja Node.jsZainstaluj Node.js 20 lub nowszego i uruchom serwer ponownie