# Klucze API i asystenci AI (MCP)

Postbird został stworzony tak, aby asystent AI lub Twoje własne narzędzia mogły publikować posty. Claude, ChatGPT, Claude Code, Cursor, n8n, Make lub Twoje własne skrypty mogą planować i publikować posty dla Twoich marek. Wszystko znajduje się w zakładce **API i MCP**.

::: master-only
<figure><img src="../.gitbook/assets/v2-postbird-api.png" alt="Strona API i MCP: Połącz asystenta AI z adresem MCP, skonfiguruj karty dla Claude, ChatGPT, Claude Code, Cursor oraz n8n, Make, skrypty z ponumerowanymi krokami, a poniżej sekcja kluczy API"><figcaption><p>API i MCP: adres dla asystentów AI, konfiguracja krok po kroku dla każdego asystenta oraz Twoje klucze API.</p></figcaption></figure>
:::

## Połącz asystenta AI

MCP to sposób, w jaki asystenci AI łączą się z narzędziami. Adres to:

```
https://mcp.postbird.ai/mcp
```

- **Claude** (wersja internetowa lub desktopowa): Ustawienia, Łączniki (Connectors), **Dodaj niestandardowy łącznik** (Add custom connector), nazwij go Postbird i wklej adres. Kliknij **Dodaj**, następnie **Połącz** i zatwierdź logowanie.
- **ChatGPT**: Ustawienia, Łączniki (lub Aplikacje), **Utwórz**, nazwij go Postbird, wklej adres i wybierz OAuth jako metodę logowania. Zapisz, połącz i zatwierdź.
- **Claude Code** i **Cursor**: wklej adres wraz z kluczem API (poniżej). Zakładka dla każdego z nich pokazuje dokładne kroki.

Po połączeniu asystent może wyświetlać Twoje marki i kanały, tworzyć szkice, planować i publikować posty, dodawać obrazy z linku, odczytywać kalendarz i dziennik publikacji oraz importować wiele postów jednocześnie (najpierw je sprawdź, zaimportuj, a w razie potrzeby cofnij import). Po prostu poproś go, na przykład: „zaplanuj post o naszym wiosennym menu na każdym kanale Sunrise Dental na piątek na godzinę 10:00”. Może on również sugerować hashtagi dla poszczególnych sieci, przechowywać Twoje zapisane grupy hashtagów, tworzyć obrazy za pomocą AI w ramach mediów marki oraz odczytywać i odpowiadać na komentarze pod Twoimi postami w [Skrzynce odbiorczej](inbox.md): odpowiadaj, polub, ukryj lub usuń, jeśli sieć na to pozwala, oznaczaj konwersacje jako zakończone i sugeruj odpowiedź. Szkice AI, sugestie hashtagów, obrazy AI i sugerowane odpowiedzi generowane przez asystenta kosztują tyle samo, co w aplikacji ([Pisanie z AI i hashtagi](ai-drafts.md)).

## Klucze API

Klucz pozwala narzędziu działać w Twoim imieniu w ramach Twoich marek, bez konieczności podawania hasła.

1. W sekcji **Klucze API** nadaj kluczowi nazwę (na przykład „Claude Code na moim laptopie”).
2. Zaznacz **Tylko do odczytu** (Read only), jeśli narzędzie ma jedynie przeglądać marki, kanały, posty i kalendarz, bez tworzenia, zmieniania czy publikowania czegokolwiek.
3. Kliknij **Utwórz klucz** i od razu go skopiuj. Klucze zaczynają się od `pb_live_`. Ze względów bezpieczeństwa klucz jest wyświetlany tylko raz; jeśli go zgubisz, unieważnij go i utwórz nowy.

Utwórz jeden klucz dla każdego narzędzia, aby móc później wyłączyć pojedyncze narzędzie za pomocą opcji **Unieważnij** (Revoke). Każdy, kto posiada klucz, może publikować posty w imieniu Twoich marek, więc traktuj go jak hasło.

Klucz utworzony przez członka zespołu działa zgodnie z rolą i markami tego członka zespołu oraz podąża za nim, jeśli jego rola ulegnie zmianie lub jeśli opuści on zespół. Tylko Ty i administratorzy możecie tworzyć klucze. Zobacz [Role w zespole](team-roles.md).

## Zwykłe żądania internetowe (n8n, Make, skrypty)

Każda akcja asystenta jest również zwykłym żądaniem internetowym. Wyślij swój klucz w nagłówku `X-API-Key`. Link **Opis API** w zakładce n8n, Make, skrypty to standardowy opis każdego żądania, który n8n i Make mogą zaimportować bezpośrednio.