API a MCP

Využívejte Point11 z vlastního softwaru, AI asistenta nebo terminálu.

Přehled#

Server MCP, API a nástroj pro příkazový řádek umí totéž co vy v přehledu: číst vaše kampaně a výsledky a spouštět stejnou práci.

  • Server MCP: připojte Claude, ChatGPT nebo jiného AI asistenta.
  • API: volejte Point11 z vlastního kódu na adrese https://point11.ai/api/v1.
  • CLI: používejte API z terminálu.

Přihlaste se a otevřete referenci API; je k dispozici členům organizace Point11. Uvádí každý požadavek, co přijímá a co vrací, a které akce panelu zvládne server MCP, API a CLI. Jak testovat reklamy a další kreativy s digitálními dvojčaty svých zákazníků, najdete v článku Testujte kreativy přes API.

Připojte AI asistenta#

Použijte tuto URL serveru MCP: https://point11.ai/api/mcp. Po zobrazení výzvy se přihlaste do Point11 a schvalte přístup. Pokud patříte do více organizací, řekněte asistentovi, kterou má použít. Chcete-li se místo toho připojit pomocí API klíče, postupujte podle kroků pro svého klienta níže.

Chcete-li asistentovi zpřístupnit jen produkty, které používáte, připojte se pomocí API klíče a přidejte jejich názvy do URL malými písmeny a oddělené čárkami, například https://point11.ai/api/mcp?products=discovery,inspector. Kratší seznam nástrojů nechá asistentovi víc prostoru pro práci. Pro přihlášení použijte přesně URL uvedenou výše, bez čehokoli za /api/mcp. Point11 uvádí jen aktuální verzi každého nástroje; asistent, který stále používá starší verzi, funguje dál.

Business a Alpha mají nejvíc nástrojů, takže můžete přidat i jen jednu jejich část: produkt, tečku a část, například business.customers. Business obsahuje profiles, customers, crm, goals, products, measurement a google-ads. Alpha obsahuje chat, projects, files, workflows, ads, brand-kits, advisor a connectors. Produkty a části můžete libovolně kombinovat, například https://point11.ai/api/mcp?products=discovery,business.customers. Pokud váš asistent vyhledává nástroje až ve chvíli, kdy je potřebuje, může dál používat celý produkt nebo celý server.

Registry a klienti si mohou popis serveru přečíst na adrese https://point11.ai/api/mcp/server-card.

Claude na webu a v počítači#

  1. Otevřete Customize > Connectors a poté + > Add custom connector.
  2. Zadejte název Point11 a přesně URL https://point11.ai/api/mcp, pak vyberte Add a Connect.
  3. V konverzaci otevřete + > Connectors a zapněte Point11.

U tarifů Team a Enterprise musí vlastník nejprve přidat konektor v Organization settings > Connectors. Viz průvodce konektory Claude.

Claude Code#

V terminálu spusťte:

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

Poté otevřete Claude Code, spusťte /mcp a vyberte Point11 pro ověření. Chcete-li místo toho použít API klíč, přidejte ho jako hlavičku:

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

Viz průvodce MCP pro Claude Code.

ChatGPT na webu#

  1. Otevřete Settings > Security and login a zapněte Developer mode.
  2. Otevřete Plugins > +. Zadejte Point11, krátký popis a URL serveru do Connection a vytvořte připojení.
  3. Zkontrolujte nástroje, zahajte novou konverzaci a vyberte Point11 v nabídce nástrojů.

Dostupnost závisí na nastavení účtu a pracovního prostoru. Viz průvodce připojením od OpenAI.

ChatGPT pro počítač a Codex#

V aplikaci pro počítač otevřete Settings > MCP servers > Add server. Zadejte název Point11, vyberte Streamable HTTP a vložte URL serveru. Uložte, vyberte Restart a poté Authenticate.

Pro Codex CLI spusťte:

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

Chcete-li místo toho použít API klíč, uveďte proměnnou prostředí, ve které je uložen:

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

Klienti pro počítač, CLI a IDE sdílejí konfiguraci na vašem počítači. Viz průvodce MCP od OpenAI.

Zobrazte si přehled v asistentovi#

Požádejte o pohled z přehledu Discovery, například Podíl značky, Úspěšnost značky nebo Konkurenti. Asistent, který zobrazuje interaktivní aplikace, vykreslí stejnou kartu, jakou vidíte v přehledu, s odkazem pro její otevření v Point11. Ostatní asistenti dostanou krátké shrnutí stejných čísel a odkaz.

Přihlaste se, nebo použijte API klíč#

  • Přihlaste se vlastním účtem. Point11 vás požádá o schválení přístupu a poté váš asistent nebo nástroj jedná s vaší rolí v každé organizaci, do které patříte. Tento způsob použijte pro AI asistenty a vlastní práci.
  • Použijte API klíč pro software, který pracuje bez vás, například skript nebo naplánovanou úlohu. Klíč jedná za jednu organizaci a může používat jen přístup, který mu udělíte.

Některé věci vždy vyžadují vás. Vaše vlastní konverzace a projekty v Alpha, komentáře a koncepty studií Research patří konkrétní osobě, takže k nim API klíč nemá přístup. Pozastavení nebo smazání kampaně, pozvání kolegy nebo odebrání člena vyžaduje nejprve vaše schválení. Uvidíte organizaci a přesně to, co se změní, a vaše schválení platí jen pro tento požadavek. Fakturaci, API klíče a role členů měníte pouze v přehledu.

Práce, kterou spustíte přes server MCP, API nebo CLI, se započítává do vašeho tarifu stejně jako v přehledu.

Zvolte, co smí každý asistent dělat#

V Nastavení > Zabezpečení v části Připojené aplikace najdete každého AI asistenta nebo aplikaci, která za vás jednala. U každé položky zvolte, co smí v dané organizaci dělat: Plný přístup, Jen pro čtení nebo Blokováno. Vlastníci a správci navíc v Nastavení > Zabezpečení > Organizace v části AI klienti (MCP) volí, co smějí asistenti členů dělat v celé organizaci: Povoleno, Jen pro čtení nebo Vypnuto, a v části Připojené aplikace členů mohou aplikaci člena odvolat. Změna platí od dalšího požadavku a na API klíče nemá vliv.

Vytvořte API klíč#

Klíče mohou vytvářet správci a vlastníci.

  1. Otevřete Nastavení > API klíče a vyberte Vytvořit klíč.
  2. Zadejte Název, pro každý produkt zvolte Přístup, kdy klíč Vyprší a komu Patří.
  3. Vyberte Vytvořit a poté klíč zkopírujte. Zobrazí se jen jednou.

Klíč uchovávejte v nástroji pro správu tajných údajů, nikdy ne v kódu. Organizace může mít až 10 aktivních klíčů. Klíč zneplatníte volbou Odvolat; Obměnit mu přidělí nový tajný údaj. Klíč, který patří Mně, se odvolá, jakmile organizaci opustíte nebo už nebudete moci spravovat klíče; klíč, který patří Organizaci, funguje dál.

Odešlete první požadavek#

Odešlete klíč jako bearer token:

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

Požadavky, které čtou, používají GET. Požadavky, které něco mění, používají POST s tělem JSON a hlavičkou Idempotency-Key obsahující nové UUID:

bash
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"}'

Pokud se místo klíče přihlašujete, odešlete také Point11-Organization s ID vaší organizace. Zkopírujte ho v Nastavení > API klíče.

Zpracujte odpovědi#

  • Opakování. Chcete-li požadavek bezpečně zopakovat, odešlete ho znovu se stejným Idempotency-Key. Opakovaný požadavek na vytvoření nebo spuštění vám vrátí první odpověď a nic se neprovede dvakrát. Jakákoli jiná změna se při opakování provede znovu a odpoví stavem, ve kterém věci zanechala, takže opakované smazání, které odpoví 404, znamená, že položka už neexistuje. Pro každý nový požadavek použijte nový klíč. Přes server MCP posílá váš asistent klíč jako idempotencyKey. K vytvoření nebo spuštění něčeho je povinný; u jakékoli jiné změny je volitelný a požadavek bez něj proběhne jako nový požadavek.
  • Seznamy. Předejte limit, nejvýše 100. Chcete-li získat další stránku, předejte nextCursor z předchozí odpovědi jako cursor. Na poslední stránce je nextCursor null.
  • Delší práce. Když spustíte kontrolu nebo kampaň, hned dostanete odpověď 202 s runId. Průběh zjistíte pomocí GET /api/v1/platform/runs-v2/{runId}, nebo na serveru MCP pomocí platform_runs_get_v2.
  • Chyby. Každá chyba má code, message a request_id. Podle code rozhodněte, co dělat, a když požádáte o pomoc, uveďte request_id.
  • Limity. Každý klíč má rozpočet požadavků a stejně tak každá přihlášená osoba, a to napříč všemi organizacemi a asistenty, které používá. Hlavičky RateLimit-Remaining a RateLimit-Reset ukazují, kolik zbývá. Když se vyčerpá, dostanete 429. Počkejte počet sekund uvedený v Retry-After a zkuste to znovu.

Používejte CLI#

CLI je Restish, který čte referenci API a z každého požadavku vytvoří příkaz se stejným názvem, například discovery-campaigns-list. Používá API klíč. Nainstalujte Restish, například pomocí brew install restish, uložte svůj klíč do POINT11_API_KEY a pak Restish připojte k Point11:

bash
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

Pak spusťte libovolný požadavek podle názvu jeho příkazu:

bash
restish p11 discovery-campaigns-list

U požadavku, který něco mění, uveďte Idempotency-Key jako první:

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

Chcete-li načíst nové požadavky, spusťte znovu restish api sync p11.