Instalacja serwera MCP

Przed instalacją potrzebujesz 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.

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`