# Podłączyć asystenta
> Podłączyć asystenta do serwera MCP (https://api.ocost.io/public/mcp, te same klucze): Claude Code, Claude Desktop, Cursor, claude.ai i ChatGPT przez OAuth oraz każdy klient.
>
> Najpierw: [Klucze i uprawnienia](https://ocost.io/docs/pl/authentication.md)

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](https://ocost.io/docs/pl/tools.md) wymienia każde narzędzie z jego uprawnieniem i argumentami.

## Claude Code

Dodaj serwer z kluczem ze zmiennej środowiskowej:

```bash
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:

```bash
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](https://ocost.io/docs/pl/limits.md) 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ż

- [Narzędzia MCP](https://ocost.io/docs/pl/tools.md): Każde narzędzie serwera MCP, według uprawnienia: co robi, jego argumenty i przykładowe wywołanie.
- [Klucze i uprawnienia](https://ocost.io/docs/pl/authentication.md): Klucze API: jak niesie je żądanie, ich wymiana, ich uprawnienia i odmowy.
- [Grupy spółek](https://ocost.io/docs/pl/groups.md): Grupy spółek: do których spółek sięga klucz, nagłówek Ocost-Business, przekierowanie po identyfikatorach dokumentu, needs_company i pliki w grupie.
- Na ocost.io: [API and MCP](https://ocost.io/en/product/api-and-mcp)
