API en MCP

Gebruik Point11 vanuit je eigen software, AI-assistent of terminal.

Overzicht#

De MCP-server, de API en de opdrachtregeltool doen wat je in het dashboard doet: je campagnes en resultaten lezen en hetzelfde werk starten.

  • MCP-server: verbind Claude, ChatGPT of een andere AI-assistent.
  • API: roep Point11 aan vanuit je eigen code op https://point11.ai/api/v1.
  • CLI: gebruik de API vanuit je terminal.

Log in om de API-referentie te openen; die is er voor leden van een Point11-organisatie. Hij somt elk verzoek op, wat het aanneemt en wat het teruggeeft, en welke dashboardacties de MCP-server, de API en de CLI bereiken. Lees Creatives testen met de API om advertenties en andere creatives te testen met de digitale tweelingen van je klanten.

Een AI-assistent verbinden#

Gebruik deze MCP-server-URL: https://point11.ai/api/mcp. Meld je aan bij Point11 en keur de toegang goed wanneer daarom wordt gevraagd. Hoor je bij meer dan één organisatie, vertel je assistent dan welke hij moet gebruiken. Wil je in plaats daarvan verbinden met een API-sleutel, volg dan hieronder de stappen voor je client.

Wil je je assistent alleen de producten geven die je gebruikt, verbind dan met een API-sleutel en voeg hun namen in kleine letters toe aan de URL, gescheiden door een komma, bijvoorbeeld https://point11.ai/api/mcp?products=discovery,inspector. Een kortere lijst met tools laat je assistent meer ruimte om te werken. Om je aan te melden, gebruik je precies de URL hierboven, zonder iets na /api/mcp. Point11 toont alleen de huidige versie van elke tool; een assistent die nog een oudere versie gebruikt, blijft werken.

Business en Alpha hebben de meeste tools, dus je kunt ook één onderdeel van een van beide toevoegen: het product, een punt en het onderdeel, bijvoorbeeld business.customers. Business heeft profiles, customers, crm, goals, products, measurement en google-ads. Alpha heeft chat, projects, files, workflows, ads, brand-kits, advisor en connectors. Combineer producten en onderdelen zoals je wilt, bijvoorbeeld https://point11.ai/api/mcp?products=discovery,business.customers. Als je assistent tools zoekt wanneer hij ze nodig heeft, kan hij nog steeds een heel product of de hele server gebruiken.

Registers en clients kunnen de beschrijving van de server lezen op https://point11.ai/api/mcp/server-card.

Claude op het web en op de desktop#

  1. Open Customize > Connectors en vervolgens + > Add custom connector.
  2. Geef de connector de naam Point11, voer precies https://point11.ai/api/mcp in en selecteer Add, daarna Connect.
  3. Open in een gesprek + > Connectors en schakel Point11 in.

Bij Team- en Enterprise-abonnementen voegt een eigenaar de connector eerst toe via Organization settings > Connectors. Zie de connectorhandleiding van Claude.

Claude Code#

Voer dit uit in je terminal:

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

Open daarna Claude Code, voer /mcp uit en selecteer Point11 om je te authenticeren. Wil je in plaats daarvan een API-sleutel gebruiken, voeg die dan toe als header:

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

Zie de MCP-handleiding van Claude Code.

ChatGPT op het web#

  1. Open Settings > Security and login en schakel Developer mode in.
  2. Open Plugins > +. Voer Point11, een korte beschrijving en de server-URL onder Connection in en maak de verbinding.
  3. Controleer de tools, start een nieuw gesprek en selecteer Point11 in het toolmenu.

De beschikbaarheid hangt af van de instellingen van je account en werkruimte. Zie de verbindingshandleiding van OpenAI.

ChatGPT desktop en Codex#

Open in de desktopapp Settings > MCP servers > Add server. Geef de server de naam Point11, kies Streamable HTTP en voer de server-URL in. Sla op, selecteer Restart en daarna Authenticate.

Voer voor de Codex CLI het volgende uit:

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

Wil je in plaats daarvan een API-sleutel gebruiken, geef dan de naam op van de omgevingsvariabele waarin de sleutel staat:

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

Desktop-, CLI- en IDE-clients delen de configuratie op je computer. Zie de MCP-handleiding van OpenAI.

Je dashboard bekijken in je assistent#

Vraag om een dashboardweergave van Discovery, zoals Merkaandeel, Winstpercentage van het merk of Concurrenten. Een assistent die interactieve apps toont, laat dezelfde kaart zien die je in je dashboard ziet, met een link om die in Point11 te openen. Andere assistenten krijgen een korte samenvatting van dezelfde cijfers en de link.

Aanmelden of een API-sleutel gebruiken#

  • Meld je aan als jezelf. Point11 vraagt je de toegang goed te keuren. Daarna handelt je assistent of tool met jouw rol in elke organisatie waar je lid van bent. Gebruik dit voor AI-assistenten en je eigen werk.
  • Gebruik een API-sleutel voor software die zonder jou werkt, zoals een script of een geplande taak. Een sleutel handelt voor één organisatie en kan alleen de toegang gebruiken die je hem geeft.

Voor een paar dingen ben jij altijd nodig. Je eigen Alpha-gesprekken en -projecten, opmerkingen en conceptstudies in Research horen bij een persoon, dus een API-sleutel kan er niet bij. Voor het pauzeren of verwijderen van een campagne, het uitnodigen van iemand of het verwijderen van een lid wordt eerst om je goedkeuring gevraagd. Je ziet de organisatie en precies wat er verandert, en je goedkeuring geldt alleen voor dat verzoek. Facturering, API-sleutels en ledenrollen wijzig je alleen in het dashboard.

Werk dat je start via de MCP-server, de API of de CLI telt op dezelfde manier mee voor je abonnement als in het dashboard.

Kiezen wat elke assistent mag doen#

Elke AI-assistent of app die namens jou heeft gehandeld, staat in Instellingen > Beveiliging onder Verbonden apps. Kies wat elk ervan in die organisatie mag doen: Volledig, Alleen lezen of Geblokkeerd. Eigenaren en beheerders kiezen ook wat de assistenten van leden in de hele organisatie mogen doen, in Instellingen > Beveiliging > Organisatie onder AI-clients (MCP): Toegestaan, Alleen lezen of Uit, en trekken de app van een lid in onder Verbonden apps van leden. Een wijziging geldt vanaf het volgende verzoek, en API-sleutels worden niet beïnvloed.

Een API-sleutel maken#

Beheerders en eigenaren kunnen sleutels maken.

  1. Open Instellingen > API-sleutels en selecteer Sleutel maken.
  2. Voer een Naam in, kies de Toegang per product, wanneer de sleutel verloopt onder Verloopt en van wie hij is onder Behoort tot.
  3. Selecteer Maken en kopieer daarna de sleutel. Je ziet hem maar één keer.

Bewaar de sleutel in een secretmanager, nooit in je code. Een organisatie kan maximaal 10 actieve sleutels hebben. Selecteer Intrekken om een sleutel te stoppen; Roteren geeft hem een nieuw geheim. Een sleutel die behoort tot Mij wordt ingetrokken zodra je de organisatie verlaat of geen sleutels meer kunt beheren; een sleutel die behoort tot De organisatie blijft werken.

Je eerste verzoek doen#

Stuur je sleutel mee als bearer-token:

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

Verzoeken die lezen gebruiken GET. Verzoeken die iets wijzigen gebruiken POST met een JSON-body en een Idempotency-Key-header met een nieuwe 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"}'

Meld je je aan in plaats van een sleutel te gebruiken, stuur dan ook Point11-Organization mee met de ID van je organisatie. Kopieer die via Instellingen > API-sleutels.

Antwoorden verwerken#

  • Nieuwe pogingen. Wil je een verzoek veilig opnieuw proberen, stuur het dan nogmaals met dezelfde Idempotency-Key. Probeer je een aanmaak of een start opnieuw, dan krijg je het eerste antwoord terug en wordt niets twee keer uitgevoerd. Elke andere wijziging wordt bij een nieuwe poging opnieuw uitgevoerd en antwoordt met de toestand die ze achterlaat, dus een opnieuw geprobeerde verwijdering die 404 antwoordt, betekent dat het item al weg is. Gebruik voor elk nieuw verzoek een nieuwe sleutel. Via de MCP-server stuurt je assistent de sleutel mee als idempotencyKey. Die is verplicht om iets aan te maken of te starten; voor elke andere wijziging is hij optioneel, en een verzoek zonder sleutel wordt uitgevoerd als een nieuw verzoek.
  • Lijsten. Geef limit mee, tot 100. Geef voor de volgende pagina de nextCursor uit het vorige antwoord mee als cursor. Op de laatste pagina is nextCursor gelijk aan null.
  • Langer werk. Het starten van een scan of campagne geeft direct 202 terug met een runId. Volg de voortgang met GET /api/v1/platform/runs-v2/{runId} of met platform_runs_get_v2 in de MCP-server.
  • Fouten. Elke fout heeft een code, een message en een request_id. Bepaal op basis van de code wat je doet en vermeld de request_id wanneer je om hulp vraagt.
  • Limieten. Elke sleutel heeft een verzoekbudget, net als elke persoon die zich aanmeldt, over alle organisaties en assistenten heen die die persoon gebruikt. De headers RateLimit-Remaining en RateLimit-Reset tonen wat er nog over is. Is het op, dan krijg je 429; wacht het aantal seconden uit Retry-After en probeer het dan opnieuw.

De CLI gebruiken#

De CLI is Restish. Restish leest de API-referentie en maakt van elk verzoek een opdracht met dezelfde naam, zoals discovery-campaigns-list. Het gebruikt een API-sleutel. Installeer Restish, bijvoorbeeld met brew install restish, zet je sleutel in POINT11_API_KEY en verbind Restish daarna met 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

Voer daarna elk verzoek uit met de naam van de opdracht:

bash
restish p11 discovery-campaigns-list

Zet bij een verzoek dat iets wijzigt de Idempotency-Key vooraan:

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

Voer restish api sync p11 opnieuw uit om nieuwe verzoeken op te halen.