Instalacja serwera MCP

Serwer zdalny (zalecany, beta)

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.

Claude Code

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.

Claude, ChatGPT i inne klienty z własnymi konektorami

Dodaj https://mcp.ogarni.ai/mcp jako zdalny serwer MCP i przejdź przez logowanie oraz stronę zgody Ogarni.

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 (starszy)

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.

Wymagania

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.

Claude Code

Uruchom poniższą komendę w terminalu:

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.

Claude Desktop / Cursor / Windsurf

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"
      }
    }
  }
}

Lokalizacja pliku konfiguracyjnego

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`
Cursor	Ustawienia > MCP Servers
Windsurf	Ustawienia > MCP

Lokalna instalacja deweloperska

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

# 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"
      }
    }
  }
}

Weryfikacja instalacji

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.

Rozwiązywanie problemów

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