API i MCP

Przegląd#

Serwer MCP, API i narzędzie wiersza poleceń robią to samo co Ty w panelu: odczytują kampanie i wyniki oraz uruchamiają te same zadania.

• Serwer MCP: połącz Claude, ChatGPT lub innego asystenta AI.
• API: wywołuj Point11 z własnego kodu pod adresem https://point11.ai/api/v1.
• CLI: korzystaj z API w terminalu.

Zaloguj się, aby otworzyć dokumentację API; jest dostępna dla członków organizacji Point11. Wymienia każde żądanie, co przyjmuje i co zwraca, oraz które działania z panelu obsługują serwer MCP, API i CLI. Jak testować reklamy i inne kreacje na cyfrowych bliźniakach swoich klientów, przeczytasz w artykule Testuj kreacje przez API.

Połącz asystenta AI#

Użyj tego adresu serwera MCP: https://point11.ai/api/mcp. Zaloguj się do Point11 i zatwierdź dostęp, gdy pojawi się prośba. Jeśli należysz do więcej niż jednej organizacji, powiedz asystentowi, której ma używać. Aby zamiast tego połączyć się za pomocą klucza API, wykonaj poniższe kroki dla swojego klienta.

Aby udostępnić asystentowi tylko produkty, których używasz, połącz się za pomocą klucza API i dodaj ich nazwy do adresu małymi literami, oddzielone przecinkami, na przykład https://point11.ai/api/mcp?products=discovery,inspector. Krótsza lista narzędzi zostawia asystentowi więcej miejsca na pracę. Aby się zalogować, użyj dokładnie powyższego adresu, bez niczego po /api/mcp. Point11 wymienia tylko bieżącą wersję każdego narzędzia; asystent, który nadal używa starszej wersji, dalej działa.

Business i Alpha mają najwięcej narzędzi, więc możesz też dodać tylko jedną część któregoś z nich: produkt, kropkę i część, na przykład business.customers. Business obejmuje profiles, customers, crm, goals, products, measurement i google-ads. Alpha obejmuje chat, projects, files, workflows, ads, brand-kits, advisor i connectors. Łącz produkty i części dowolnie, na przykład https://point11.ai/api/mcp?products=discovery,business.customers. Jeśli Twój asystent wyszukuje narzędzia wtedy, gdy ich potrzebuje, nadal może korzystać z całego produktu lub całego serwera.

Rejestry i klienty mogą odczytać opis serwera pod adresem https://point11.ai/api/mcp/server-card.

Claude w przeglądarce i na komputerze#

1. Otwórz Customize > Connectors, a następnie + > Add custom connector.
2. Wpisz nazwę Point11, podaj dokładnie adres https://point11.ai/api/mcp i wybierz Add, a potem Connect.
3. W rozmowie otwórz + > Connectors i włącz Point11.

W planach Team i Enterprise właściciel najpierw dodaje konektor w Organization settings > Connectors. Zobacz przewodnik po konektorach Claude.

Claude Code#

Uruchom w terminalu:

claude mcp add --transport http point11 https://point11.ai/api/mcp

Następnie otwórz Claude Code, uruchom /mcp i wybierz Point11, aby się uwierzytelnić. Aby zamiast tego użyć klucza API, dodaj go jako nagłówek:

claude mcp add --transport http point11 https://point11.ai/api/mcp \
  --header "Authorization: Bearer $POINT11_API_KEY"

Zobacz przewodnik MCP dla Claude Code.

ChatGPT w przeglądarce#

1. Otwórz Settings > Security and login i włącz Developer mode.
2. Otwórz Plugins > +. Wpisz Point11, krótki opis i adres serwera w sekcji Connection, a następnie utwórz połączenie.
3. Sprawdź narzędzia, rozpocznij nową rozmowę i wybierz Point11 z menu narzędzi.

Dostępność zależy od ustawień konta i przestrzeni roboczej. Zobacz przewodnik OpenAI dotyczący połączenia.

ChatGPT na komputerze i Codex#

W aplikacji komputerowej otwórz Settings > MCP servers > Add server. Wpisz nazwę Point11, wybierz Streamable HTTP i podaj adres serwera. Zapisz, wybierz Restart, a potem Authenticate.

W przypadku Codex CLI uruchom:

codex mcp add point11 --url https://point11.ai/api/mcp
codex mcp login point11

Aby zamiast tego użyć klucza API, podaj nazwę zmiennej środowiskowej, która go przechowuje:

codex mcp add point11 --url https://point11.ai/api/mcp --bearer-token-env-var POINT11_API_KEY

Klienty komputerowe, CLI i IDE współdzielą konfigurację na Twoim komputerze. Zobacz przewodnik MCP OpenAI.

Zobacz swój panel w asystencie#

Poproś o widok panelu Discovery, na przykład Udział marki, Wskaźnik wygranych marki lub Konkurenci. Asystent, który wyświetla aplikacje interaktywne, pokazuje tę samą kartę, którą widzisz w panelu, wraz z linkiem do otwarcia jej w Point11. Inni asystenci otrzymują krótkie podsumowanie tych samych liczb i link.

Zaloguj się lub użyj klucza API#

• Zaloguj się na własne konto. Point11 poprosi Cię o zatwierdzenie dostępu, a potem Twój asystent lub narzędzie działa z Twoją rolą w każdej organizacji, do której należysz. Używaj tej opcji w asystentach AI i we własnej pracy.
• Użyj klucza API w oprogramowaniu, które działa bez Ciebie, na przykład w skrypcie lub zaplanowanym zadaniu. Klucz działa w imieniu jednej organizacji i może korzystać tylko z dostępu, który mu nadasz.

Niektóre rzeczy zawsze wymagają Twojego udziału. Twoje własne rozmowy i projekty Alpha, komentarze oraz szkice badań Research należą do konkretnej osoby, więc klucz API nie ma do nich dostępu. Wstrzymanie lub usunięcie kampanii, zaproszenie kogoś albo usunięcie członka najpierw wymaga Twojego zatwierdzenia. Widzisz organizację i dokładnie to, co się zmieni, a Twoje zatwierdzenie dotyczy tylko tego jednego żądania. Rozliczenia, klucze API i role członków zmienisz tylko w panelu.

Zadania uruchomione z serwera MCP, API lub CLI są wliczane do Twojego planu tak samo jak w panelu.

Wybierz, co może robić każdy asystent#

W Ustawienia > Bezpieczeństwo w sekcji Połączone aplikacje widać każdego asystenta AI lub aplikację, która działała w Twoim imieniu. Dla każdej pozycji wybierz, co może robić w tej organizacji: Pełny dostęp, Tylko do odczytu lub Zablokowane. Właściciele i administratorzy wybierają też, co mogą robić asystenci członków w całej organizacji, w Ustawienia > Bezpieczeństwo > Organizacja w sekcji Klienty AI (MCP): Dozwolone, Tylko do odczytu lub Wyłączone, a w sekcji Połączone aplikacje członków mogą cofnąć dostęp aplikacji członka. Zmiana obowiązuje od następnego żądania i nie dotyczy kluczy API.

Utwórz klucz API#

Administratorzy i właściciele mogą tworzyć klucze.

1. Otwórz Ustawienia > Klucze API i wybierz Utwórz klucz.
2. Wpisz nazwę w polu Nazwa, wybierz Dostęp do każdego produktu, termin w polu Wygasa oraz właściciela w polu Należy do.
3. Wybierz Utwórz, a następnie skopiuj klucz. Zobaczysz go tylko raz.

Przechowuj klucz w menedżerze sekretów, nigdy w kodzie. Organizacja może mieć maksymalnie 10 aktywnych kluczy. Aby wyłączyć klucz, wybierz Unieważnij; Rotuj nadaje mu nowy sekret. Klucz, dla którego wybrano Ja, zostaje unieważniony, gdy opuścisz organizację lub stracisz uprawnienia do zarządzania kluczami; klucz, dla którego wybrano Organizacja, nadal działa.

Wyślij pierwsze żądanie#

Wyślij klucz jako token typu bearer:

curl https://point11.ai/api/v1/discovery/campaigns \
  -H "Authorization: Bearer $POINT11_API_KEY"

Żądania odczytu używają GET. Żądania, które coś zmieniają, używają POST z treścią JSON i nagłówkiem Idempotency-Key zawierającym nowy UUID:

curl https://point11.ai/api/v1/inspector/scans/start \
  -H "Authorization: Bearer $POINT11_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Jeśli logujesz się zamiast używać klucza, wyślij też Point11-Organization z identyfikatorem swojej organizacji. Skopiuj go z Ustawienia > Klucze API.

Obsługuj odpowiedzi#

• Ponowienia. Aby bezpiecznie ponowić żądanie, wyślij je ponownie z tym samym Idempotency-Key. Ponowienie utworzenia lub uruchomienia zwraca pierwszą odpowiedź i nic nie wykona się dwa razy. Każda inna ponowiona zmiana wykonuje się ponownie i zwraca stan, w jakim ją pozostawiła, więc ponowione usunięcie, które zwraca 404, oznacza, że element już nie istnieje. Do każdego nowego żądania używaj nowego klucza. Przez serwer MCP Twój asystent wysyła klucz jako idempotencyKey. Jest on wymagany przy tworzeniu lub uruchamianiu czegoś; przy każdej innej zmianie jest opcjonalny, a żądanie bez niego wykonuje się jako nowe żądanie.
• Listy. Przekaż limit, maksymalnie 100. Aby pobrać następną stronę, przekaż nextCursor z poprzedniej odpowiedzi jako cursor. Na ostatniej stronie nextCursor ma wartość null.
• Dłuższe zadania. Uruchomienie skanu lub kampanii od razu zwraca 202 z runId. Postęp sprawdzisz przez GET /api/v1/platform/runs-v2/{runId} albo platform_runs_get_v2 na serwerze MCP.
• Błędy. Każdy błąd ma code, message i request_id. O dalszych krokach decyduj na podstawie code, a gdy prosisz o pomoc, podaj request_id.
• Limity. Każdy klucz ma budżet żądań; ma go też każda zalogowana osoba, łącznie dla wszystkich organizacji i asystentów, z których korzysta. Nagłówki RateLimit-Remaining i RateLimit-Reset pokazują, ile zostało. Gdy budżet się wyczerpie, otrzymasz 429; odczekaj tyle sekund, ile podaje Retry-After, i spróbuj ponownie.

Korzystaj z CLI#

CLI to Restish. Restish odczytuje dokumentację API i zamienia każde żądanie w polecenie o tej samej nazwie, na przykład discovery-campaigns-list. Korzysta z klucza API. Zainstaluj Restish, na przykład poleceniem brew install restish, zapisz klucz w POINT11_API_KEY, a następnie połącz Restish z Point11:

restish api connect p11 https://point11.ai --no-discover
restish api set p11 'profiles.default.auth: {type: bearer, params: {token: env:POINT11_API_KEY}}'
restish api set p11 'profiles.default.credentials.apiKey.auth: {type: bearer, params: {token: env:POINT11_API_KEY}}'
restish api sync p11

Następnie uruchom dowolne żądanie, podając nazwę jego polecenia:

restish p11 discovery-campaigns-list

W przypadku żądania, które coś zmienia, podaj najpierw Idempotency-Key:

restish p11 inspector-scans-start "$(uuidgen)" url: https://example.com

Uruchom ponownie restish api sync p11, aby pobrać nowe żądania.