API och MCP

Nå Point11 från din egen programvara, AI-assistent eller terminal.

Översikt#

MCP-servern, API:et och kommandoradsverktyget gör det du gör i instrumentpanelen: läser dina kampanjer och resultat och startar samma arbete.

  • MCP-server: anslut Claude, ChatGPT eller en annan AI-assistent.
  • API: anropa Point11 från din egen kod på https://point11.ai/api/v1.
  • CLI: använd API:et från terminalen.

Logga in för att öppna API-referensen; den är öppen för medlemmar i en Point11-organisation. Den listar varje anrop, vad det tar emot och vad det returnerar, och vilka åtgärder i instrumentpanelen som MCP-servern, API:t och CLI:t når. Läs Testa kreativ med API:t för att testa annonser och annat kreativ med dina kunders digitala tvillingar.

Anslut en AI-assistent#

Använd denna URL för MCP-servern: https://point11.ai/api/mcp. Logga in på Point11 och godkänn åtkomsten när du blir tillfrågad. Om du tillhör fler än en organisation säger du till assistenten vilken den ska använda. Om du vill ansluta med en API-nyckel i stället följer du stegen för din klient nedan.

Om du bara vill ge assistenten de produkter du använder ansluter du med en API-nyckel och lägger till deras namn i URL:en med gemener, åtskilda med kommatecken, till exempel https://point11.ai/api/mcp?products=discovery,inspector. En kortare lista med verktyg ger assistenten mer utrymme att arbeta. För att logga in använder du URL:en ovan exakt som den är, utan något efter /api/mcp. Point11 listar bara den aktuella versionen av varje verktyg; en assistent som fortfarande använder en äldre version fortsätter att fungera.

Business och Alpha har flest verktyg, så du kan också lägga till bara en del av något av dem: produkten, en punkt och delen, till exempel business.customers. Business har profiles, customers, crm, goals, products, measurement och google-ads. Alpha har chat, projects, files, workflows, ads, brand-kits, advisor och connectors. Kombinera produkter och delar som du vill, till exempel https://point11.ai/api/mcp?products=discovery,business.customers. Om assistenten söker efter verktyg när den behöver dem kan den fortfarande använda en hel produkt eller hela servern.

Register och klienter kan läsa serverns beskrivning på https://point11.ai/api/mcp/server-card.

Claude på webben och datorn#

  1. Öppna Customize > Connectors och sedan + > Add custom connector.
  2. Ange namnet Point11, fyll i exakt https://point11.ai/api/mcp och välj Add, sedan Connect.
  3. Öppna + > Connectors i ett samtal och aktivera Point11.

För Team- och Enterprise-abonnemang lägger en ägare först till anslutningen i Organization settings > Connectors. Se Claudes guide för anslutningar.

Claude Code#

Kör i terminalen:

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

Öppna sedan Claude Code, kör /mcp och välj Point11 för att autentisera dig. Om du vill använda en API-nyckel i stället lägger du till den som en header:

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

Se Claude Codes MCP-guide.

ChatGPT på webben#

  1. Öppna Settings > Security and login och aktivera Developer mode.
  2. Öppna Plugins > +. Ange Point11, en kort beskrivning och serverns URL under Connection och skapa anslutningen.
  3. Granska verktygen, starta ett nytt samtal och välj Point11 i verktygsmenyn.

Tillgängligheten beror på inställningarna för ditt konto och din arbetsyta. Se OpenAI:s anslutningsguide.

ChatGPT för datorn och Codex#

Öppna Settings > MCP servers > Add server i datorappen. Ange namnet Point11, välj Streamable HTTP och fyll i serverns URL. Spara, välj Restart och sedan Authenticate.

För Codex CLI kör du:

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

Om du vill använda en API-nyckel i stället anger du namnet på miljövariabeln som innehåller den:

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

Dator-, CLI- och IDE-klienter delar konfigurationen på din dator. Se OpenAI:s MCP-guide.

Se din instrumentpanel i assistenten#

Be om en vy i Discovery-instrumentpanelen, till exempel Varumärkesandel, Varumärkets vinstfrekvens eller Konkurrenter. En assistent som visar interaktiva appar återger samma kort som du ser i instrumentpanelen, med en länk för att öppna det i Point11. Andra assistenter får en kort sammanfattning av samma siffror och länken.

Logga in eller använd en API-nyckel#

  • Logga in som dig själv. Point11 ber dig godkänna åtkomsten, och sedan agerar assistenten eller verktyget med din roll i varje organisation du tillhör. Använd det för AI-assistenter och ditt eget arbete.
  • Använd en API-nyckel för programvara som arbetar utan dig, till exempel ett skript eller ett schemalagt jobb. En nyckel agerar för en organisation och kan bara använda den åtkomst du ger den.

Vissa saker kräver alltid dig. Dina egna Alpha-samtal och projekt, kommentarer och utkast till Research-studier tillhör en person, så en API-nyckel kan inte nå dem. Att pausa eller ta bort en kampanj, bjuda in någon eller ta bort en medlem kräver att du godkänner det först. Du ser organisationen och exakt vad som kommer att ändras, och ditt godkännande gäller bara det anropet. Fakturering, API-nycklar och medlemsroller ändras bara i instrumentpanelen.

Arbete du startar från MCP-servern, API:et eller CLI:t räknas mot ditt abonnemang på samma sätt som i instrumentpanelen.

Välj vad varje assistent får göra#

Alla AI-assistenter och appar som har agerat för din räkning listas i Inställningar > Säkerhet under Anslutna appar. Välj vad var och en får göra i den organisationen: Full åtkomst, Endast läsning eller Blockerad. Ägare och administratörer väljer också vad medlemmarnas assistenter får göra i hela organisationen i Inställningar > Säkerhet > Organisation under AI-klienter (MCP): Tillåten, Endast läsning eller Av, och återkallar en medlems app under Medlemmarnas anslutna appar. En ändring gäller från nästa anrop, och API-nycklar påverkas inte.

Skapa en API-nyckel#

Administratörer och ägare kan skapa nycklar.

  1. Öppna Inställningar > API-nycklar och välj Skapa nyckel.
  2. Ange ett Namn, välj nyckelns Åtkomst för varje produkt, när den Upphör och vem den Tillhör.
  3. Välj Skapa och kopiera sedan nyckeln. Du ser den bara en gång.

Förvara nyckeln i en hemlighetshanterare, aldrig i din kod. En organisation kan ha upp till 10 aktiva nycklar. Om du vill stoppa en nyckel väljer du Återkalla; Rotera ger den en ny hemlighet. En nyckel som tillhör Mig återkallas när du lämnar organisationen eller inte längre kan hantera nycklar; en som tillhör Organisationen fortsätter att fungera.

Gör ditt första anrop#

Skicka nyckeln som en bearer-token:

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

Anrop som läser använder GET. Anrop som ändrar något använder POST med en JSON-body och en Idempotency-Key-header som innehåller ett nytt 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"}'

Om du loggar in i stället för att använda en nyckel skickar du också Point11-Organization med organisationens ID. Kopiera det från Inställningar > API-nycklar.

Hantera svar#

  • Nya försök. Om du vill göra om ett anrop på ett säkert sätt skickar du det igen med samma Idempotency-Key. Ett nytt försök att skapa eller starta något ger tillbaka det första svaret, och inget körs två gånger. Alla andra ändringar körs igen vid ett nytt försök och svarar med det läge de lämnar, så en borttagning som svarar 404 vid ett nytt försök betyder att objektet redan är borta. Använd en ny nyckel för varje nytt anrop. Via MCP-servern skickar assistenten nyckeln som idempotencyKey. Den krävs för att skapa eller starta något; för alla andra ändringar är den valfri, och ett anrop utan nyckel körs som ett nytt anrop.
  • Listor. Skicka limit, upp till 100. För att hämta nästa sida skickar du nextCursor från föregående svar som cursor. nextCursor är null på sista sidan.
  • Längre arbete. När du startar en skanning eller en kampanj får du 202 direkt, tillsammans med ett runId. Följ förloppet med GET /api/v1/platform/runs-v2/{runId} eller med platform_runs_get_v2 i MCP-servern.
  • Fel. Varje fel har en code, ett message och ett request_id. Bestäm vad du ska göra utifrån code och ta med request_id när du ber om hjälp.
  • Gränser. Varje nyckel har en anropsbudget, och varje person som loggar in har en egen budget som gäller för alla organisationer och assistenter som personen använder. Headrarna RateLimit-Remaining och RateLimit-Reset visar hur mycket som återstår. När budgeten tar slut får du 429; vänta det antal sekunder som Retry-After anger och försök sedan igen.

Använd CLI:t#

CLI:t är Restish, som läser API-referensen och gör varje anrop till ett kommando med samma namn, till exempel discovery-campaigns-list. Det använder en API-nyckel. Installera Restish, till exempel med brew install restish, lägg nyckeln i POINT11_API_KEY och anslut sedan Restish till 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

Kör sedan valfritt anrop med dess kommandonamn:

bash
restish p11 discovery-campaigns-list

För ett anrop som ändrar något anger du Idempotency-Key först:

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

Kör restish api sync p11 igen för att hämta nya anrop.