API und MCP

Nutzen Sie Point11 aus Ihrer eigenen Software, Ihrem KI-Assistenten oder Terminal.

Überblick#

Der MCP-Server, die API und das Befehlszeilentool können, was Sie im Dashboard tun: Ihre Kampagnen und Ergebnisse lesen und dieselbe Arbeit starten.

  • MCP-Server: Verbinden Sie Claude, ChatGPT oder einen anderen KI-Assistenten.
  • API: Rufen Sie Point11 aus Ihrem eigenen Code unter https://point11.ai/api/v1 auf.
  • CLI: Nutzen Sie die API in Ihrem Terminal.

Melden Sie sich an, um die API-Referenz zu öffnen; sie steht Mitgliedern einer Point11-Organisation offen. Sie listet jede Anfrage auf, was sie entgegennimmt und was sie zurückgibt, und welche Dashboard-Aktionen der MCP-Server, die API und die CLI erreichen. Wie Sie Anzeigen und anderes Kreativmaterial mit den digitalen Zwillingen Ihrer Kunden testen, lesen Sie unter Kreativmaterial mit der API testen.

Einen KI-Assistenten verbinden#

Verwenden Sie diese MCP-Server-URL: https://point11.ai/api/mcp. Melden Sie sich bei Point11 an und genehmigen Sie den Zugriff, wenn Sie dazu aufgefordert werden. Wenn Sie mehreren Organisationen angehören, teilen Sie Ihrem Assistenten mit, welche er verwenden soll. Um sich stattdessen mit einem API-Schlüssel zu verbinden, folgen Sie den Schritten für Ihren Client unten.

Um Ihrem Assistenten nur die Produkte zu geben, die Sie nutzen, verbinden Sie sich mit einem API-Schlüssel und fügen Sie deren Namen kleingeschrieben und durch Kommas getrennt an die URL an, zum Beispiel https://point11.ai/api/mcp?products=discovery,inspector. Eine kürzere Liste von Tools lässt Ihrem Assistenten mehr Raum zum Arbeiten. Zum Anmelden verwenden Sie genau die obige URL, ohne etwas nach /api/mcp. Point11 listet nur die aktuelle Version jedes Tools auf; ein Assistent, der noch eine ältere verwendet, funktioniert weiterhin.

Business und Alpha haben die meisten Tools, deshalb können Sie auch nur einen Teil davon hinzufügen: das Produkt, einen Punkt und den Teil, zum Beispiel business.customers. Business umfasst profiles, customers, crm, goals, products, measurement und google-ads. Alpha umfasst chat, projects, files, workflows, ads, brand-kits, advisor und connectors. Kombinieren Sie Produkte und Teile beliebig, zum Beispiel https://point11.ai/api/mcp?products=discovery,business.customers. Wenn Ihr Assistent Tools erst bei Bedarf sucht, kann er weiterhin ein ganzes Produkt oder den gesamten Server verwenden.

Registries und Clients können die Beschreibung des Servers unter https://point11.ai/api/mcp/server-card lesen.

Claude im Web und auf dem Desktop#

  1. Öffnen Sie Customize > Connectors und dann + > Add custom connector.
  2. Geben Sie Point11 als Namen und genau https://point11.ai/api/mcp als URL ein und wählen Sie Add, dann Connect.
  3. Öffnen Sie in einer Unterhaltung + > Connectors und aktivieren Sie Point11.

Bei Team- und Enterprise-Plänen fügt zunächst ein Inhaber den Konnektor unter Organization settings > Connectors hinzu. Siehe Claudes Anleitung für Konnektoren.

Claude Code#

Führen Sie im Terminal Folgendes aus:

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

Öffnen Sie danach Claude Code, führen Sie /mcp aus und wählen Sie Point11 zur Authentifizierung. Um stattdessen einen API-Schlüssel zu verwenden, fügen Sie ihn als Header hinzu:

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

Siehe die MCP-Anleitung für Claude Code.

ChatGPT im Web#

  1. Öffnen Sie Settings > Security and login und aktivieren Sie Developer mode.
  2. Öffnen Sie Plugins > +. Geben Sie Point11, eine kurze Beschreibung und die Server-URL unter Connection ein und erstellen Sie die Verbindung.
  3. Prüfen Sie die Tools, starten Sie eine neue Unterhaltung und wählen Sie Point11 im Tool-Menü.

Die Verfügbarkeit hängt von Ihren Konto- und Workspace-Einstellungen ab. Siehe OpenAIs Anleitung zur Verbindung.

ChatGPT auf dem Desktop und Codex#

Öffnen Sie in der Desktop-App Settings > MCP servers > Add server. Geben Sie Point11 als Namen ein, wählen Sie Streamable HTTP und geben Sie die Server-URL ein. Speichern Sie, wählen Sie Restart und dann Authenticate.

Führen Sie für die Codex CLI Folgendes aus:

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

Um stattdessen einen API-Schlüssel zu verwenden, geben Sie die Umgebungsvariable an, die ihn enthält:

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

Desktop-, CLI- und IDE-Clients verwenden dieselbe Konfiguration auf Ihrem Computer. Siehe OpenAIs MCP-Anleitung.

Ihr Dashboard im Assistenten ansehen#

Fragen Sie nach einer Ansicht des Discovery-Dashboards, etwa Markenanteil, Erfolgsquote der Marke oder Wettbewerber. Ein Assistent, der interaktive Apps anzeigt, stellt dieselbe Karte dar, die Sie in Ihrem Dashboard sehen, mit einem Link, um sie in Point11 zu öffnen. Andere Assistenten erhalten eine kurze Zusammenfassung derselben Zahlen und den Link.

Anmelden oder einen API-Schlüssel verwenden#

  • Melden Sie sich mit Ihrem eigenen Konto an. Point11 bittet Sie, den Zugriff zu genehmigen. Danach handelt Ihr Assistent oder Tool mit Ihrer Rolle in jeder Organisation, der Sie angehören. Nutzen Sie dies für KI-Assistenten und Ihre eigene Arbeit.
  • Verwenden Sie einen API-Schlüssel für Software, die ohne Sie arbeitet, etwa ein Skript oder einen geplanten Job. Ein Schlüssel handelt für eine Organisation und kann nur den Zugriff nutzen, den Sie ihm geben.

Manches erfordert immer Sie selbst. Ihre eigenen Alpha-Unterhaltungen und -Projekte, Kommentare und Entwürfe von Research-Studien gehören einer Person, daher kann ein API-Schlüssel sie nicht erreichen. Bevor eine Kampagne pausiert oder gelöscht, jemand eingeladen oder ein Mitglied entfernt wird, werden Sie zuerst um Genehmigung gebeten. Sie sehen die Organisation und genau, was sich ändern wird, und Ihre Genehmigung gilt nur für diese Anfrage. Abrechnung, API-Schlüssel und Mitgliederrollen ändern Sie nur im Dashboard.

Arbeit, die Sie über den MCP-Server, die API oder die CLI starten, wird genauso auf Ihren Tarif angerechnet wie im Dashboard.

Festlegen, was jeder Assistent tun darf#

Alle KI-Assistenten und Apps, die für Sie gehandelt haben, sind unter Einstellungen > Sicherheit im Bereich Verbundene Apps aufgeführt. Legen Sie jeweils fest, was sie in dieser Organisation tun dürfen: Vollzugriff, Nur Lesen oder Blockiert. Inhaber und Administratoren legen außerdem unter Einstellungen > Sicherheit > Organisation im Bereich KI-Clients (MCP) fest, was die Assistenten der Mitglieder in der gesamten Organisation tun dürfen: Erlaubt, Nur Lesen oder Aus, und widerrufen im Bereich Verbundene Apps der Mitglieder die App eines Mitglieds. Eine Änderung gilt ab der nächsten Anfrage, und API-Schlüssel sind nicht betroffen.

Einen API-Schlüssel erstellen#

Administratoren und Inhaber können Schlüssel erstellen.

  1. Öffnen Sie Einstellungen > API-Schlüssel und wählen Sie Schlüssel erstellen.
  2. Geben Sie unter Name einen Namen ein und wählen Sie unter Zugriff den Zugriff für jedes Produkt, unter Ablauf, wann er abläuft, und unter Besitzer, wem er gehört.
  3. Wählen Sie Erstellen und kopieren Sie dann den Schlüssel. Sie sehen ihn nur einmal.

Bewahren Sie den Schlüssel in einem Secret Manager auf, niemals in Ihrem Code. Eine Organisation kann bis zu 10 aktive Schlüssel haben. Um einen Schlüssel zu stoppen, wählen Sie Widerrufen; Rotieren gibt ihm ein neues Secret. Ein Schlüssel mit dem Besitzer Ich wird widerrufen, sobald Sie die Organisation verlassen oder keine Schlüssel mehr verwalten können; einer mit dem Besitzer Die Organisation funktioniert weiter.

Ihre erste Anfrage senden#

Senden Sie Ihren Schlüssel als Bearer-Token:

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

Lesende Anfragen verwenden GET. Anfragen, die etwas ändern, verwenden POST mit einem JSON-Body und einem Idempotency-Key-Header, der eine neue UUID enthält:

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

Wenn Sie sich anmelden, statt einen Schlüssel zu verwenden, senden Sie zusätzlich Point11-Organization mit der Organisations-ID. Sie finden sie unter Einstellungen > API-Schlüssel.

Antworten verarbeiten#

  • Wiederholungen. Um eine Anfrage sicher zu wiederholen, senden Sie sie erneut mit demselben Idempotency-Key. Eine wiederholte Erstellung oder ein wiederholter Start liefert die erste Antwort zurück, und nichts läuft doppelt. Jede andere wiederholte Änderung läuft erneut und antwortet mit dem Stand, den sie hinterlässt; eine wiederholte Löschung, die 404 antwortet, bedeutet also, dass das Element bereits entfernt ist. Verwenden Sie für jede neue Anfrage einen neuen Schlüssel. Über den MCP-Server sendet Ihr Assistent den Schlüssel als idempotencyKey. Er ist erforderlich, um etwas zu erstellen oder zu starten; bei jeder anderen Änderung ist er optional, und eine Anfrage ohne Schlüssel läuft als neue Anfrage.
  • Listen. Übergeben Sie limit, höchstens 100. Um die nächste Seite abzurufen, übergeben Sie den nextCursor aus der vorherigen Antwort als cursor. Auf der letzten Seite ist nextCursor null.
  • Längere Arbeit. Wenn Sie einen Scan oder eine Kampagne starten, erhalten Sie sofort 202 mit einer runId. Den Fortschritt prüfen Sie mit GET /api/v1/platform/runs-v2/{runId} oder im MCP-Server mit platform_runs_get_v2.
  • Fehler. Jeder Fehler hat einen code, eine message und eine request_id. Entscheiden Sie anhand des code, was zu tun ist, und geben Sie die request_id an, wenn Sie um Hilfe bitten.
  • Limits. Jeder Schlüssel hat ein Anfragebudget, ebenso jede Person, die sich anmeldet, über alle Organisationen und Assistenten hinweg, die sie nutzt. Die Header RateLimit-Remaining und RateLimit-Reset zeigen, was noch übrig ist. Ist es aufgebraucht, erhalten Sie 429. Warten Sie die in Retry-After angegebenen Sekunden und versuchen Sie es dann erneut.

Die CLI verwenden#

Die CLI ist Restish. Restish liest die API-Referenz und macht aus jeder Anfrage einen Befehl mit ihrem Namen, etwa discovery-campaigns-list. Es verwendet einen API-Schlüssel. Installieren Sie Restish, zum Beispiel mit brew install restish, legen Sie Ihren Schlüssel in POINT11_API_KEY ab und verbinden Sie Restish dann mit 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

Führen Sie dann jede Anfrage über ihren Befehlsnamen aus:

bash
restish p11 discovery-campaigns-list

Stellen Sie bei einer Anfrage, die etwas ändert, den Idempotency-Key an den Anfang:

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

Führen Sie restish api sync p11 erneut aus, um neue Anfragen zu übernehmen.