Podłączyć asystenta

Ocost jest też serwerem Model Context Protocol (MCP). Podłącz Claude Desktop, Claude Code, Cursor lub innego asystenta, a będzie przeszukiwał Twoje dokumenty, czytał je, pytał o Twoje liczby i wysyłał pliki. claude.ai i ChatGPT łączą się przez OAuth zamiast przez klucz.

Serwer

Text
https://api.ocost.io/public/mcp
Authorization: Bearer ocost_sk_<id>_<secret>

Serwer mówi Streamable HTTP i nie utrzymuje sesji, więc każde żądanie jest samodzielne. https://app.ocost.io/public/mcp to ten sam serwer. Daj każdemu asystentowi własny klucz tylko z potrzebnymi mu uprawnieniami. Wtedy widzisz jego ostatnie użycie w Ustawienia › Programiści i możesz unieważnić tylko jego. Narzędzia MCP wymienia każde narzędzie z jego uprawnieniem i argumentami.

Claude Code

Dodaj serwer z kluczem ze zmiennej środowiskowej:

Shell
claude mcp add --transport http ocost https://api.ocost.io/public/mcp \
  --header "Authorization: Bearer $OCOST_KEY"

claude mcp list pokazuje wtedy ocost jako połączony. Aby udostępnić serwer w repozytorium, wpisz go do .mcp.json. Klucz trzymaj w środowisku każdego programisty, nigdy w pliku:

JSON
{
  "mcpServers": {
    "ocost": {
      "type": "http",
      "url": "https://api.ocost.io/public/mcp",
      "headers": { "Authorization": "Bearer ${OCOST_KEY}" }
    }
  }
}

Claude Desktop

Otwórz Settings › Developer › Edit Config i dodaj Ocost do claude_desktop_config.json. mcp-remote przekazuje żądania z Twoim nagłówkiem i potrzebuje Node.js.

JSON
{
  "mcpServers": {
    "ocost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.15.2",
        "https://api.ocost.io/public/mcp",
        "--header",
        "Authorization:${OCOST_AUTH}"
      ],
      "env": { "OCOST_AUTH": "Bearer ocost_sk_…" }
    }
  }
}

Uruchom Claude Desktop ponownie, a narzędzia pojawią się pod przyciskiem narzędzi. Zapisz Authorization:${OCOST_AUTH} bez spacji, bo niektóre klienty dzielą tam argumenty.

Cursor

Dodaj Ocost do ~/.cursor/mcp.json albo do .cursor/mcp.json w projekcie:

JSON
{
  "mcpServers": {
    "ocost": {
      "url": "https://api.ocost.io/public/mcp",
      "headers": { "Authorization": "Bearer ${env:OCOST_KEY}" }
    }
  }
}

claude.ai i ChatGPT

Te aplikacje dodają serwery tylko przez OAuth. Nie potrzebujesz klucza: logujesz się do Ocost i zezwalasz na dostęp.

  1. Dodaj własny konektor. W claude.ai otwórz Settings › Connectors › Add custom connector. W ChatGPT dodaj własny konektor w trybie dewelopera.
  2. Wpisz tylko URL https://api.ocost.io/public/mcp. Pola Client ID i Client Secret zostaw puste.
  3. Zaloguj się do Ocost, gdy aplikacja go otworzy. Jeśli należysz do kilku firm, wybierz jedną pod Inna firma.
  4. Zaznacz uprawnienia, na które zezwalasz, i potwierdź. Zezwolić może tylko właściciel lub księgowy.

Aplikacja działa wtedy jako Ty, z Twoimi prawami. Dostaje własny klucz, widoczny jako „<App> (Connector)” w Ustawienia › Programiści. Unieważnij ten klucz, aby od razu odłączyć aplikację. Aplikacja sama odnawia swój token dostępu co godzinę. Po 30 dniach bez użycia połączenie wygasa i łączysz aplikację ponownie.

Budujesz własnego klienta OAuth? Ocost używa OAuth 2.1 z PKCE (S256). Metadane są pod https://api.ocost.io/.well-known/oauth-protected-resource/public/mcp (RFC 9728) i https://app.ocost.io/.well-known/oauth-authorization-server (RFC 8414). Ocost przyjmuje Client ID Metadata Documents i Dynamic Client Registration. Adresy przekierowania muszą używać https i pasować dokładnie.

Każdy inny klient

Wskaż mu URL z nagłówkiem Authorization. Serwer odpowiada na żądania POST w JSON, bez strumienia SSE i bez identyfikatora sesji. Wypisz narzędzia, aby sprawdzić połączenie:

Shell
curl -sS https://api.ocost.io/public/mcp \
  -H "Authorization: Bearer $OCOST_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Bez ważnego klucza serwer odpowiada 401 z WWW-Authenticate: Bearer. Twoje logowanie do Ocost nie jest kluczem.

Co mogą narzędzia

Klucz utworzony w Ustawieniach działa jako firma. Czyta każdy dokument spoza Kosza, ale żadnych osobistych decyzji poszczególnych osób. Tylko właściciel tworzy klucz z figures:read. Połączenie OAuth działa jako osoba, która na nie zezwoliła, i widzi to, co ona widzi w czacie Ocost. Żaden klucz ani połączenie nie czyta nigdy dokumentów pracowniczych, takich jak paski płacowe czy zwolnienia lekarskie.

Żadne narzędzie niczego nie usuwa, nie zatwierdza ani nie zamawia. Limity API obowiązują przy każdym wywołaniu narzędzia.

Słowa odczytane z dokumentu przychodzą wewnątrz <document-text>, a każdy wiersz jest oznaczony ¦ . To dane napisane przez innych, nigdy polecenia. W claude.ai i ChatGPT listy i liczby przychodzą też jako interaktywna tabela lub wykres.

Każde wywołanie jest zapisywane, bez słów dokumentu. Właściciel i księgowy widzą ostatnie wywołania klucza w Ustawienia › Programiści.

Zobacz też