API et MCP

Vue d’ensemble#

Le serveur MCP, l’API et l’outil en ligne de commande font ce que vous faites dans le tableau de bord : lire vos campagnes et vos résultats, et lancer les mêmes tâches.

• Serveur MCP : connectez Claude, ChatGPT ou un autre assistant IA.
• API : appelez Point11 depuis votre propre code à l’adresse https://point11.ai/api/v1.
• CLI : utilisez l’API depuis votre terminal.

Connectez-vous pour ouvrir la référence de l’API ; elle est réservée aux membres d’une organisation Point11. Elle liste chaque requête, ce qu’elle accepte et ce qu’elle renvoie, ainsi que les actions du tableau de bord accessibles depuis le serveur MCP, l’API et la CLI. Pour tester des annonces et d’autres créations auprès des jumeaux numériques de vos clients, consultez Tester des créations avec l’API.

Connectez un assistant IA#

Utilisez cette URL de serveur MCP : https://point11.ai/api/mcp. Connectez-vous à Point11 et approuvez l’accès lorsque vous y êtes invité. Si vous appartenez à plusieurs organisations, indiquez à votre assistant laquelle utiliser. Pour vous connecter plutôt avec une clé API, suivez les étapes de votre client ci-dessous.

Pour ne donner à votre assistant que les produits que vous utilisez, connectez-vous avec une clé API et ajoutez leurs noms en minuscules à l’URL, séparés par des virgules, par exemple https://point11.ai/api/mcp?products=discovery,inspector. Une liste d’outils plus courte laisse à votre assistant plus de place pour travailler. Pour vous connecter à Point11, utilisez exactement l’URL ci-dessus, sans rien après /api/mcp. Point11 ne liste que la version actuelle de chaque outil ; un assistant qui utilise encore une version plus ancienne continue de fonctionner.

Business et Alpha comptent le plus d’outils : vous pouvez donc aussi n’ajouter qu’une partie de l’un ou de l’autre, en écrivant le produit, un point, puis la partie, par exemple business.customers. Business comprend profiles, customers, crm, goals, products, measurement et google-ads. Alpha comprend chat, projects, files, workflows, ads, brand-kits, advisor et connectors. Combinez librement produits et parties, par exemple https://point11.ai/api/mcp?products=discovery,business.customers. Si votre assistant recherche les outils au fur et à mesure de ses besoins, il peut toujours utiliser un produit entier ou le serveur complet.

Les registres et les clients peuvent lire la description du serveur à l’adresse https://point11.ai/api/mcp/server-card.

Claude sur le web et sur ordinateur#

1. Ouvrez Customize > Connectors, puis + > Add custom connector.
2. Nommez le connecteur Point11, saisissez exactement https://point11.ai/api/mcp et sélectionnez Add, puis Connect.
3. Dans une conversation, ouvrez + > Connectors et activez Point11.

Pour les offres Team et Enterprise, un propriétaire doit d’abord ajouter le connecteur dans Organization settings > Connectors. Consultez le guide des connecteurs de Claude.

Claude Code#

Exécutez dans votre terminal :

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

Ouvrez ensuite Claude Code, exécutez /mcp et sélectionnez Point11 pour vous authentifier. Pour utiliser plutôt une clé API, ajoutez-la comme en-tête :

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

Consultez le guide MCP de Claude Code.

ChatGPT sur le web#

1. Ouvrez Settings > Security and login et activez Developer mode.
2. Ouvrez Plugins > +. Saisissez Point11, une courte description et l’URL du serveur sous Connection, puis créez la connexion.
3. Vérifiez les outils, démarrez une nouvelle conversation et sélectionnez Point11 dans le menu des outils.

La disponibilité dépend des paramètres de votre compte et de votre espace de travail. Consultez le guide de connexion d’OpenAI.

ChatGPT sur ordinateur et Codex#

Dans l’application de bureau, ouvrez Settings > MCP servers > Add server. Nommez le serveur Point11, choisissez Streamable HTTP et saisissez l’URL du serveur. Enregistrez, sélectionnez Restart, puis Authenticate.

Pour la CLI Codex, exécutez :

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

Pour utiliser plutôt une clé API, indiquez la variable d’environnement qui la contient :

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

Les clients de bureau, CLI et IDE partagent la configuration sur votre ordinateur. Consultez le guide MCP d’OpenAI.

Affichez votre tableau de bord dans votre assistant#

Demandez une vue du tableau de bord Discovery, comme Part de marque, Taux de réussite de la marque ou Concurrents. Un assistant qui affiche des applications interactives présente la même carte que celle que vous voyez dans votre tableau de bord, avec un lien pour l’ouvrir dans Point11. Les autres assistants reçoivent un court résumé des mêmes chiffres et le lien.

Connectez-vous ou utilisez une clé API#

• Connectez-vous avec votre propre compte. Point11 vous demande d’approuver l’accès, puis votre assistant ou votre outil agit avec votre rôle dans chaque organisation dont vous êtes membre. Choisissez cette option pour les assistants IA et votre propre travail.
• Utilisez une clé API pour les logiciels qui fonctionnent sans vous, comme un script ou une tâche planifiée. Une clé agit pour une seule organisation et ne peut utiliser que l’accès que vous lui accordez.

Certaines actions nécessitent toujours votre intervention. Vos conversations et projets Alpha, vos commentaires et vos brouillons d’études Research appartiennent à une personne : une clé API ne peut donc pas y accéder. Mettre en pause ou supprimer une campagne, inviter quelqu’un ou retirer un membre nécessite d’abord votre approbation. Vous voyez l’organisation et exactement ce qui va changer, et votre approbation ne vaut que pour cette requête. La facturation, les clés API et les rôles des membres se modifient uniquement dans le tableau de bord.

Le travail que vous lancez depuis le serveur MCP, l’API ou la CLI est décompté de votre forfait de la même manière que dans le tableau de bord.

Choisissez ce que chaque assistant peut faire#

Chaque assistant IA ou application qui a agi pour vous figure dans Paramètres > Sécurité, sous Applications connectées. Choisissez ce que chacun peut faire dans cette organisation : Complet, Lecture seule ou Bloqué. Les propriétaires et les administrateurs choisissent aussi ce que les assistants des membres peuvent faire dans toute l’organisation, dans Paramètres > Sécurité > Organisation, sous Clients IA (MCP) : Autorisé, Lecture seule ou Désactivé, et révoquent l’application d’un membre sous Applications connectées des membres. Une modification s’applique dès la requête suivante, et les clés API ne sont pas concernées.

Créez une clé API#

Les administrateurs et les propriétaires peuvent créer des clés.

1. Ouvrez Paramètres > Clés API et sélectionnez Créer une clé.
2. Saisissez un Nom, choisissez son Accès pour chaque produit, sa date d’expiration sous Expire le et à qui elle appartient sous Appartient à.
3. Sélectionnez Créer, puis copiez la clé. Elle ne s’affiche qu’une seule fois.

Conservez la clé dans un gestionnaire de secrets, jamais dans votre code. Une organisation peut avoir jusqu’à 10 clés actives. Pour désactiver une clé, sélectionnez Révoquer ; Renouveler lui attribue un nouveau secret. Une clé qui appartient à Moi est révoquée dès que vous quittez l’organisation ou ne pouvez plus gérer les clés ; une clé qui appartient à L’organisation continue de fonctionner.

Envoyez votre première requête#

Envoyez votre clé comme jeton Bearer :

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

Les requêtes de lecture utilisent GET. Les requêtes qui modifient quelque chose utilisent POST avec un corps JSON et un en-tête Idempotency-Key contenant un nouvel 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"}'

Si vous vous connectez au lieu d’utiliser une clé, envoyez aussi Point11-Organization avec l’ID de votre organisation. Copiez-le depuis Paramètres > Clés API.

Traitez les réponses#

• Nouvelles tentatives. Pour relancer une requête sans risque, renvoyez-la avec le même Idempotency-Key. Relancer une création ou un démarrage vous renvoie sa première réponse, et rien ne s'exécute deux fois. Toute autre modification relancée s'exécute à nouveau et répond avec l'état qu'elle laisse : une suppression relancée qui répond 404 signifie donc que l'élément a déjà disparu. Utilisez une nouvelle clé pour chaque nouvelle requête. Via le serveur MCP, votre assistant envoie la clé sous la forme idempotencyKey. Elle est obligatoire pour créer ou lancer quelque chose ; pour toute autre modification, elle est facultative, et une requête sans clé est traitée comme une nouvelle requête.
• Listes. Passez limit, jusqu’à 100. Pour obtenir la page suivante, passez le nextCursor de la réponse précédente comme cursor. nextCursor vaut null sur la dernière page.
• Tâches plus longues. Le lancement d’une analyse ou d’une campagne répond immédiatement 202 avec un runId. Suivez sa progression avec GET /api/v1/platform/runs-v2/{runId}, ou platform_runs_get_v2 dans le serveur MCP.
• Erreurs. Chaque erreur comporte un code, un message et un request_id. Décidez de la suite à partir du code, et incluez le request_id lorsque vous demandez de l’aide.
• Limites. Chaque clé dispose d’un budget de requêtes, tout comme chaque personne qui se connecte, pour l’ensemble des organisations et des assistants qu’elle utilise. Les en-têtes RateLimit-Remaining et RateLimit-Reset indiquent ce qu’il reste. Une fois le budget épuisé, vous recevez 429 ; attendez le nombre de secondes indiqué par Retry-After, puis réessayez.

Utilisez la CLI#

La CLI est Restish, qui lit la référence de l’API et transforme chaque requête en une commande portant son nom, comme discovery-campaigns-list. Elle utilise une clé API. Installez Restish, par exemple avec brew install restish, placez votre clé dans POINT11_API_KEY, puis connectez Restish à 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

Exécutez ensuite n’importe quelle requête par le nom de sa commande :

restish p11 discovery-campaigns-list

Pour une requête qui modifie quelque chose, placez l’Idempotency-Key en premier :

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

Exécutez à nouveau restish api sync p11 pour récupérer les nouvelles requêtes.