API i MCP: podłącz asystenta AI

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.

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.

Zrzut ekranu

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:

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:

{
  "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:

{
  "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:

{
  "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:

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.

Endpoint MCP #

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:

{
  "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.

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?”

Endpointy tokenów #

Powyższa strona wywołuje te ścieżki; team guide wymienia te same akcje w publicznym API (/v1/tokens).

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.