# API i MCP: podłącz asystenta AI

_API · 7 min czytania · Zaktualizowano 2026-10-22 · https://lanachat.ai/guides/pl/api-mcp/_

**API & MCP** (w Users, na dole paska bocznego) pozwala podłączyć asystenta AI, takiego jak Claude lub innego klienta MCP, aby skonfigurować i zarządzać swoim workspace. MCP to otwarty standard, który pozwala asystentowi korzystać z narzędzi w aplikacji w Twoim imieniu. Te same tokeny dostępu otwierają [REST API](https://lanachat.ai/guides/pl/api-overview/).

> Note: Tę stronę mogą otworzyć tylko właściciel workspace i właściciele agencji. Pozostali widzą komunikat „Owner access required”.

## Czego potrzebujesz

- **MCP endpoint**, pokazany na górze strony. Naciśnij **Copy URL**.
- **token dostępu**, który określa, co asystent może robić.

## Utwórz token dostępu

1. Naciśnij **Create token**.
2. Nadaj mu nazwę i wybierz dostęp: **Workspace setup** lub **Custom permissions**, aby zaznaczyć je pojedynczo (np. „Read fans and conversations” lub „Read sales”).
3. Zapisz. Token jest pokazany tylko raz: naciśnij **Copy token** lub **Copy client configuration**, aby uzyskać gotową konfigurację dla swojego asystenta.
4. Naciśnij **Done, I saved it**.

## Podłącz swojego asystenta

1. Utwórz dedykowany dostęp dla tego asystenta (jeden token na każde podłączane narzędzie).
2. Dodaj połączenie HTTP MCP w swoim asystencie, z endpointem i tokenem (dokładne kroki poniżej).
3. Zapytaj go, co widzi, aby sprawdzić, czy uprawnienia są poprawne.
4. Pracuj na wersjach roboczych: pozwól mu przygotować zmiany, przetestuj je, a potem opublikuj.

Te same kroki, z endpointem, nagłówkiem i gotową do skopiowania konfiguracją, znajdziesz w **Connect your assistant** na dole strony API & MCP. W każdym przykładzie poniżej zamień URL na ten ze swojego workspace (**Copy URL**) i `YOUR_MCP_TOKEN` na swój token.

### Claude Code

Jedno polecenie w terminalu:

```bash
claude mcp add --transport http lanachat https://app.lanachat.ai/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"
```

Następnie wpisz `/mcp` w Claude Code: `lanachat` pojawi się jako podłączony, z jego narzędziami.

### Cursor

Dodaj to do `~/.cursor/mcp.json` (dla każdego projektu) lub `.cursor/mcp.json` (dla jednego projektu), potem włącz `lanachat` w **Settings › MCP**:

```json
{
  "mcpServers": {
    "lanachat": {
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### VS Code (GitHub Copilot)

Dodaj to do `.vscode/mcp.json` w swoim projekcie:

```json
{
  "servers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### Claude Desktop

Claude Desktop uruchamia lokalne serwery z pliku konfiguracyjnego, więc łączy się z LanaChat przez mały mostek `mcp-remote` (Node.js 18 lub nowszy). Otwórz **Settings › Developer › Edit Config** i dodaj:

```json
{
  "mcpServers": {
    "lanachat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.lanachat.ai/mcp", "--header", "Authorization:${LANACHAT_AUTH}"],
      "env": { "LANACHAT_AUTH": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

Uruchom ponownie Claude Desktop; narzędzia LanaChat pojawią się w menu narzędzi nowego czatu.

### ChatGPT i inni asystenci

Każdy klient MCP, który potrafi wysłać nagłówek w połączeniu HTTP, działa z powyższą konfiguracją. Webowe konektory oferujące tylko logowanie OAuth (konektory ChatGPT, własne konektory na claude.ai) nie mogą wysłać tokena dostępu, więc na razie nie mogą się połączyć.

### Sprawdź połączenie

MCP Inspector pokazuje narzędzia, do których Twój token daje dostęp, bez asystenta:

```bash
npx @modelcontextprotocol/inspector
```

Wybierz **Streamable HTTP**, wklej endpoint, dodaj nagłówek `Authorization: Bearer YOUR_MCP_TOKEN`, potem **Connect** i **List tools**.

## Zarządzanie tokenami

Tabela **Access tokens** pokazuje uprawnienia, datę wygaśnięcia i status każdego tokena. Używaj **Edit**, **Rotate** (lub **Renew**) i **Revoke**. **Show revoked tokens** wyświetla stare tokeny.

> Warning: Token działa jak hasło. Cofnij go natychmiast po zaprzestaniu używania asystenta lub jeśli podejrzewasz wyciek.

## Endpoint MCP

| Method | Path | Opis | Uprawnienie | Status |
|---|---|---|---|---|
| POST | `https://app.lanachat.ai/mcp` | Serwer MCP (Streamable HTTP): tu trafiają wszystkie wywołania narzędzi | dowolny token | Planned |
| GET | `https://app.lanachat.ai/mcp` | Otwiera strumień zdarzeń sesji | dowolny token | Planned |
| POST | `https://app.lanachat.ai/api/media/uploads` | Przesyłanie mediów przez asystenta, z tym samym tokenem | `can_setup` | Planned |

Dokładny URL Twojego workspace jest pokazany na górze strony API & MCP (**Copy URL**). Token trafia do nagłówka `Authorization`, tak jak w API. Konfiguracja klienta wygląda tak:

```json
{
  "mcpServers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

## Narzędzia dostępne dla asystenta

Asystent widzi tylko narzędzia, do których pozwala jego token. Narzędzie, którego nie może użyć, w ogóle się nie pojawia. Po połączeniu serwer wysyła asystentowi dokładne argumenty każdego narzędzia (nazwa, typ, wymagane), więc nigdy nie musisz ich wpisywać samodzielnie. Ostatnia kolumna to endpoint API robiący to samo, gdzie opisane są parametry.

| Narzędzie | Co robi | Uprawnienie | Odpowiednik w API |
|---|---|---|---|
| `list_creators`, `get_creator` | Odczyt twórczyń, ich tożsamości i postępu konfiguracji | `can_setup` | [`GET /creators`](https://lanachat.ai/guides/pl/api-creators/) |
| `update_creator`, `update_persona` | Zmiana tożsamości twórczyni lub stron persony | `can_setup`, `can_engine` dla persony | [`PUT …/identity`, `PATCH …/persona`](https://lanachat.ai/guides/pl/api-creators/) |
| `list_accounts`, `update_account` | Odczyt kont Telegram, zmiana brain, market lub traffic | `can_setup` | [`GET /accounts`, `PATCH /accounts/{id}`](https://lanachat.ai/guides/pl/api-telegram-accounts/) |
| `list_media`, `upload_media`, `update_media`, `create_media_folder` | Dodawanie mediów do Vault, sortowanie, sugerowanie opisów (pokazywanych do zatwierdzenia) | `can_setup` | [`/media`](https://lanachat.ai/guides/pl/api-vault/) |
| `list_scripts`, `draft_script`, `update_script` | Odczyt skryptów i tworzenie wersji roboczych: kroki, media i ceny Stars | `can_setup` | [`/scripts`](https://lanachat.ai/guides/pl/api-scripts/) |
| `list_members`, `update_member` | Odczyt i zmiana członków zespołu | `can_setup` | [`/members`](https://lanachat.ai/guides/pl/api-team/) |
| `get_brain`, `update_brain_draft`, `test_brain` | Odczyt brain, edycja wersji roboczej, test w Playground | `can_engine` | [`/brains`, `/playground`](https://lanachat.ai/guides/pl/api-ai-brains/) |
| `publish_brain` | Publikacja zwykłej wersji roboczej brain | `can_publish` | [`POST /brains/{id}/publish`](https://lanachat.ai/guides/pl/api-ai-brains/) |
| `test_advanced_ai`, `tune_advanced_ai`, `publish_advanced_ai` | Zaawansowane wersje robocze AI, ustawienia i profile (tylko właściciel workspace) | `can_ai_test`, `can_ai_tune`, `can_ai_publish` | Brak |
| `list_experiment_reports` | Odczyt raportów eksperymentów komercyjnych (tylko właściciel workspace) | `can_commercial_reports` | Brak |
| `list_fans`, `get_conversation` | Odczyt fanów i historii rozmów | `can_fan_read` | [`GET /fans`, `GET /conversations/{id}/messages`](https://lanachat.ai/guides/pl/api-conversations/) |
| `import_fan_history` | Dodawanie przeszłych fanów i wiadomości do bazy; nigdy nie wysyła wiadomości | `can_fan_import` | [`POST /fans/import`](https://lanachat.ai/guides/pl/api-conversations/) |
| `list_sales` | Odczyt zarejestrowanych sprzedaży do raportów | `can_sales_read` | [`GET /fans/{id}/sales`](https://lanachat.ai/guides/pl/api-conversations/), [`GET /stats`](https://lanachat.ai/guides/pl/api-tracking/) |

> Note: Wyłączenie **Access AI configuration** usuwa też uprawnienia do publikacji, Advanced AI i raportów eksperymentów. Uprawnienia do konfiguracji workspace oraz fanów i sprzedaży pozostają niezależne. Żadne narzędzie nie wysyła wiadomości do fana.

## Co możesz mu zlecić

Rozmawiaj z nim jak z koleżanką, która zna Console. Kilka przykładów, które dobrze działają:

- „Wypisz moje twórczynie i powiedz, które mają niedokończoną konfigurację.”
- „Przeczytaj personę Lei i zaproponuj trzy odpowiedzi z banku fraz dla fanów pytających, czy jest prawdziwa. Nic nie zapisuj.”
- „Szkicuj skrypt odzyskiwania Lei: trzy kroki w ciągu dwóch dni, ostatni to płatny zestaw za 250 Stars. Zostaw go nieaktywnym.”
- „Prześlij zdjęcia z tego folderu do Vault Lei, w folderze o nazwie Beach, i zaproponuj opis do każdego.”
- „Zmień wersję roboczą brain Lei tak, aby pierwsza oferta pojawiła się po 6 wiadomościach, przetestuj w Playground z nowym anglojęzycznym fanem i pokaż mi odpowiedzi przed publikacją.”
- „Ile każda twórczyni sprzedała wczoraj i który link śledzący przyniósł najwięcej kupujących w tym tygodniu?”

> Tip: Proś, aby pracował na wersjach roboczych i pokazywał wynik przed publikacją. Publikacja wymaga tokena z uprawnieniem **Publish AI Brain drafts**: wyłącz je, jeśli chcesz mieć ostatnie słowo.

## Endpointy tokenów

Powyższa strona wywołuje te ścieżki; [team guide](https://lanachat.ai/guides/pl/api-team/) wymienia te same akcje w publicznym API (`/v1/tokens`).

| Method | Path | Opis | Uprawnienie | Status |
|---|---|---|---|---|
| GET | `/api/mcp/tokens` | Lista tokenów, ich uprawnień, wygaśnięcia i statusu | `owner` | Planned |
| POST | `/api/mcp/tokens` | Utwórz token (pokazywany raz) | `owner` | Planned |
| PUT | `/api/mcp/tokens/{id}` | Edytuj nazwę lub uprawnienia | `owner` | Planned |
| POST | `/api/mcp/tokens/{id}/rotate` | Obróć sekret | `owner` | Planned |
| DELETE | `/api/mcp/tokens/{id}` | Cofnij token | `owner` | Planned |

Te ścieżki Console przyjmują i zwracają uprawnienia jako pojedyncze pola true lub false (`can_setup`, `can_engine`, `can_publish`, `can_ai_test`, `can_ai_tune`, `can_ai_publish`, `can_commercial_reports`, `can_fan_read`, `can_fan_import`, `can_sales_read`). Utworzenie tokena zwraca `{ "token": "…", "grant": { … } }`: `token` to sekret, pokazany raz; `grant` to dostęp z polami `id`, `name`, `scope`, `enabled`, `created` i `expires` (sekundy Unix). Obrót cofa stary dostęp i zwraca nowy `token` i `grant`. Brak nazwy zwraca `400`, nieznane id `404`, cofnięty dostęp `409`.

Więcej na [stronie funkcji API i MCP](https://lanachat.ai/landing/features/api-and-mcp/).

## Powiązane artykuły

- [LanaChat API: szybki start, uwierzytelnianie i błędy](https://lanachat.ai/guides/pl/api-overview/)
- [Szybkie przepisy API: kopiuj, wklej, uruchom](https://lanachat.ai/guides/pl/api-recipes/)
- [Czym jest AI Brain](https://lanachat.ai/guides/pl/what-is-an-ai-brain/)