Utwórz token API dla agenta AI
Utwórz token API w kreatorze czterokrokowym (Cel, Uprawnienia, Limity, Przejrzyj): ustawienia wstępne, uprawnienia, wygasanie, witryny dokumentacji, limity wydatków i lista dozwolonych adresów IP. Token jest wyświetlany tylko raz.
Token API pozwala Claude Code, Codex, Cursor lub Twojemu własnemu skryptowi pracować w Twoim obszarze roboczym jako Ty, z dostępem tylko do wybranych przez Ciebie elementów. Tworzysz go w kreatorze czterokrokowym (Cel, Uprawnienia, Limity, Przejrzyj), a Clevera wyświetla token tylko raz.
Zanim zaczniesz
- Funkcja AI agents & API jest dostępna w planach Pro, Business i Custom. W innych planach przycisk Nowy token wyświetla komunikat: "Dostęp do API i agentów jest dostępny w planie Pro i wyższych."
- Każdy członek obszaru roboczego może tworzyć tokeny dla siebie. Token może uzyskać tylko takie uprawnienia, na jakie pozwala Twoja rola. Zobacz Uprawnienia agenta.
- Obszar roboczy może mieć 50 aktywnych tokenów. Po osiągnięciu limitu przycisk Nowy token jest wyłączony: "Twój obszar roboczy osiągnął limit 50 aktywnych tokenów. Najpierw cofnij uprawnienia jednego z nich."
- Używaj jednego tokena na agenta lub skrypt, aby móc sprawdzić, co każdy z nich zrobił, i cofnąć uprawnienia jednego bez zatrzymywania pozostałych.
Utwórz token
Otwórz kartę Tokeny
Otwórz menu obszaru roboczego i wybierz AI agents & API. Na karcie Tokeny kliknij Nowy token.
Cel: nazwij go i wybierz, do czego służy
Nadaj mu Nazwę, którą rozpoznasz na liście tokenów i w dzienniku aktywności (do 100 znaków), np. "Autor dokumentacji (Claude Code)". W sekcji Do czego to służy? wybierz ustawienie wstępne. Zaznaczy ono odpowiednie uprawnienia dla tego zadania; możesz je później dostosować.
Wybierz ustawienie wstępne najbardziej zbliżone do zadania agenta. Ustawienie wstępne Użyj do Autor "Agenci tworzą szkice; osoba sprawdza i publikuje." Szkice witryn dokumentacji. Wydawca "Zaufana automatyzacja, która może zmieniać to, co widzą czytelnicy." Witryny dokumentacji, w tym publikowanie. Asystent wsparcia "Odpowiedzi z opublikowanej dokumentacji. Nic więcej." Bot pomocy. Tylko do odczytu "Badania, audyty i sprawdzanie tłumaczeń." Analityk "Czyta zawartość i sygnały od czytelników, aby sugerować poprawki." Producent "Tworzy szkice zawartości i rozpoczyna płatne prace w ramach limitów wydatków." Zamawianie wideo, klipów i artykułów. Agent obszaru roboczego "Wszystko, co agent może zrobić w tym obszarze roboczym, w ramach limitów wydatków." Wyszaryzowane ustawienie wstępne zawiera uprawnienie, którego Twoja rola nie może przyznać: "Twoja rola nie może przyznać wszystkich uprawnień w tym ustawieniu wstępnym."
Uprawnienia: sprawdź każde uprawnienie
Ten krok zawiera listę wszystkich uprawnień, pogrupowanych według Dokumentacja, Wideo i Obszar roboczy, z opisem tego, co umożliwiają, oraz plakietką (Odczytano, Edytuj, Opublikuj, Zarządzaj lub Wydaje kredyty). Zaznacz lub odznacz dowolne z nich. Po zmianie zestawu ustawienia wstępnego nagłówek zmieni się na Dostosowane, a opcja Resetuj do ustawienia wstępnego cofnie Twoje zmiany.
Każde uprawnienie określa, co umożliwia. Co umożliwia każde uprawnienie: Uprawnienia agenta.
Limity: ustaw wygasanie, witryny, wydatki i adresy
Wydatki pojawiają się tylko wtedy, gdy token może wydawać kredyty. Zobacz Opcje limitów poniżej.
Przejrzyj i utwórz
Podsumowanie w prostych słowach opisuje, co token może robić (Może czytać, Może tworzyć i edytować, Może publikować, Może zarządzać witrynami, Może wydawać kredyty) oraz jakie ma limity. "Działa jako Ty, w ramach tego, na co pozwala Twoja rola." Kliknij Utwórz token.
Sprawdź podsumowanie, a następnie kliknij Utwórz token. Skopiuj token
Ekran Token utworzony pokazuje token zaczynający się od
clv_agent_: "Skopiuj go teraz: nie zobaczysz go ponownie." Skopiuj go do bezpiecznego magazynu lub zmiennej środowiskowej. Opcja Połącz agenta poniżej zawiera gotową konfigurację dla Claude Code, Codex CLI,.mcp.json,curloraz Claude.ai, ChatGPT. Kliknij Zapisano, gdy skończysz.
Token jest wyświetlany tylko raz.
Wstecz zachowuje wszystko, co wprowadziłeś. Zamknięcie kreatora po dokonaniu zmian wyświetli pytanie "Odrzucić ten token?": "Rozpoczęta konfiguracja zostanie utracona. Token nie zostanie utworzony."
Opcje limitów
| Opcja | Co robi | Domyślnie |
|---|---|---|
| Wygasa po | 7 dni, 30 dni, 90 dni lub 1 rok. Data wyświetla się poniżej ("W dniu data"). Tokeny zawsze wygasają. | 90 dni |
| Witryny dokumentacji | Wyświetlane, gdy token ma uprawnienia do witryn dokumentacji. Wszystkie witryny ("Każda witryna dokumentacji w tym obszarze roboczym, w tym nowe.") lub Wybrane witryny. | Wybrane witryny, gdy obszar roboczy ma więcej niż jedną witrynę dokumentacji, w przeciwnym razie Wszystkie witryny |
| Wydatki → Na zadanie | Maksymalna kwota wyceny pojedynczego uruchomienia w kredytach. Puste: Brak limitu. | Brak limitu |
| Wydatki → Na dzień / Na miesiąc | Maksymalna kwota, jaką token może wydać (i zarezerwować na uruchomione zadania) w dniu kalendarzowym lub miesiącu. | Brak limitu |
| Wydatki → Automatycznie zatwierdzaj poniżej | Uruchomienia wycenione poniżej tej liczby kredytów działają bez udziału człowieka. "0 oznacza, że osoba zatwierdza każde płatne uruchomienie. Twój plan pozwala na maksymalnie 500." (1000 w planie Custom.) | 0 |
| Zaawansowane → Lista dozwolonych adresów IP | "Opcjonalne. Jeden adres lub zakres w linii; połączenia z innych miejsc są odrzucane." Do 20 adresów IPv4/IPv6 lub zakresów CIDR, takich jak 203.0.113.7 lub 198.51.100.0/24. |
Puste: dowolny adres |
Wydatki pojawiają się tylko wtedy, gdy token ma credits:spend (ustawienia wstępne Producent i Agent obszaru roboczego). Jak limity i zatwierdzenia współpracują ze sobą: Kontroluj wydatki i zatwierdzenia agenta.
Co dalej
- Token działa natychmiast przez MCP (
https://app.clevera.ai/mcp) i REST API. - Właściciel obszaru roboczego i administratorzy otrzymują powiadomienie: "Utworzono nowy token API, nazwa, dla obszar roboczy", wraz z informacją, kto go skonfigurował i jaki ma dostęp.
- Token pojawia się na karcie Tokeny z ostatnimi czterema znakami, np.
clv_agent_…k7Qe, a każde użycie aktualizuje Ostatnio użyto. - Po utworzeniu tokena jego uprawnienia i limity nie mogą zostać zmienione. Aby je zmienić, utwórz nowy token i cofnij uprawnienia starego. Zobacz Zarządzaj tokenami API.
Rozwiązywanie problemów
| Komunikat | Przyczyna | Rozwiązanie |
|---|---|---|
| "Nadaj tokenowi nazwę." | Nazwa jest pusta. | Wpisz nazwę. |
| "Wybierz przynajmniej jedną umiejętność." | Nie zaznaczono żadnego uprawnienia. | Zaznacz przynajmniej jedno. |
| "Wybierz przynajmniej jedną witrynę." | Wybrano Wybrane witryny, ale żadna nie została wybrana. | Wybierz witrynę lub wybierz Wszystkie witryny. |
| "Wpisz liczbę całkowitą kredytów." | Pole wydatków zawiera ułamek lub tekst, albo 0 w limicie. | Wpisz liczbę całkowitą lub pozostaw limit pusty. |
| "Twój plan zatwierdza pracę agenta automatycznie poniżej maksymalnie 500 kredytów." | Automatycznie zatwierdzaj poniżej przekracza maksimum Twojego planu. | Obniż tę wartość. |
| "wartość nie jest adresem IP ani zakresem." | Linia listy dozwolonych adresów IP jest nieprawidłowa. | Popraw lub usuń tę linię. |
| "Twoja rola nie może przyznać niektórych z tych umiejętności." | Uprawnienie wykracza poza Twoją rolę. | Odznacz je lub poproś właściciela albo administratora o utworzenie tokena. |
| "Twój obszar roboczy osiągnął limit 50 aktywnych tokenów. Najpierw cofnij uprawnienia jednego z nich." | 50 aktywnych tokenów. | Cofnij uprawnienia tokena, którego nie używasz. |
| "Dostęp do API i agentów nie jest dostępny w Twoim planie." | Obszar roboczy nie jest w planie Pro, Business ani Custom. | Przejdź na plan Pro. |
| "Nie udało się utworzyć tokena. Spróbuj ponownie." | Coś poszło nie tak. | Spróbuj ponownie; skontaktuj się z pomocą techniczną, jeśli problem nadal występuje. |