Serveur MCP

Skoup expose un serveur MCP (Model Context Protocol) : un assistant IA peut lire la visibilité de vos marques, vos alertes, vos tâches, vos requêtes, votre catalogue et vos revenus attribués, et agir sur certains d’entre eux, sans une ligne de code.


https://api.skoup.ai/mcp

Transport HTTP streamable, sans session. Le serveur est ouvert à tous les plans, comme l’API.

Se connecter

Claude, ChatGPT : connecteur OAuth

Ajoutez un connecteur personnalisé avec l’adresse ci-dessus. L’assistant vous envoie sur Skoup :

connectez-vous si besoin (tous les modes de connexion fonctionnent) ;
l’écran de consentement indique l’assistant, votre compte et les espaces concernés ;
cochez ou non Autoriser les modifications, puis Autoriser.

La connexion est personnelle : l’assistant voit tous vos espaces, avec vos droits dans chacun. Un lecteur (client-viewer) ne peut jamais écrire. Les connexions se gèrent et se coupent dans Mon profil → Applications connectées.

Claude Code, Cursor, n8n : clé API

Un client local peut utiliser une clé API à la place d’OAuth :


claude mcp add --transport http skoup https://api.skoup.ai/mcp \
  --header "Authorization: Bearer skoup_live_…"


{
  "mcpServers": {
    "skoup": {
      "url": "https://api.skoup.ai/mcp",
      "headers": { "Authorization": "Bearer skoup_live_…" }
    }
  }
}

L’assistant a alors exactement les scopes et les marques de la clé. Une clé skoup_test_ travaille sur l’espace de démonstration et n’enregistre aucune écriture (Mode test).

Outils

Chaque outil est une route de l’API publique : mêmes filtres, mêmes objets, mêmes identifiants, mêmes erreurs. Commencez par list_brands, ou par search pour chercher un objet dans toutes vos marques : search et fetch suivent le format de la recherche approfondie de ChatGPT.

Outil	Route	Scope
`list_brands`	marques accessibles (tous vos espaces en OAuth)	`brands:read`
`search`	texte libre dans les alertes, tâches, requêtes et produits de toutes vos marques	scopes de lecture de chaque type
`fetch`	un objet par l’identifiant renvoyé par `search` (même JSON que l’API + lien vers Skoup)	scope de lecture du type
`list_markets`	`GET /v1/brands/{brand}/markets`	`brands:read`
`get_metrics`	`GET /v1/brands/{brand}/metrics`	`metrics:read`
`list_samplings`	`GET /v1/brands/{brand}/samplings`	`metrics:read`
`list_competitors`	`GET /v1/brands/{brand}/competitors`	`metrics:read`
`get_readiness`	`GET /v1/brands/{brand}/readiness`	`metrics:read`
`get_product_perception`	`GET /v1/brands/{brand}/products/{product}/perception`	`metrics:read`
`list_alerts`, `get_alert`	`GET /v1/brands/{brand}/alerts[/{alert}]`	`alerts:read`
`treat_alert`, `dismiss_alert`	`POST …/alerts/{alert}/treat \| dismiss`	`alerts:write`
`list_tasks`, `get_task`	`GET /v1/brands/{brand}/tasks[/{task}]`	`tasks:read`
`create_task`, `update_task`	`POST …/tasks`, `PATCH …/tasks/{task}`	`tasks:write`
`list_queries`, `get_query`	`GET /v1/brands/{brand}/queries[/{query}]`	`queries:read`
`add_query`, `update_query`	`POST …/queries`, `PATCH …/queries/{query}`	`queries:write`
`list_products`, `get_product`	`GET /v1/brands/{brand}/products[/{product}]`	`products:read`
`get_ai_revenue`	`GET /v1/brands/{brand}/attribution`	`revenue:read`
`get_ai_traffic`	`GET /v1/brands/{brand}/traffic` (Growth et +)	`revenue:read`
`get_visibility_revenue_correlation`	`GET /v1/brands/{brand}/correlation` (Growth et +)	`revenue:read`

Deux prompts sont fournis : weekly_brief (synthèse hebdomadaire d’une marque) et explain_alert.

En OAuth, les outils de lecture n’ont besoin d’aucun scope ; les outils d’écriture exigent Autoriser les modifications et un rôle qui peut modifier la marque.

Aucun outil ne dépense de crédits ni ne supprime quoi que ce soit : la vérification d’une alerte (qui relance un sampling) reste dans l’app et l’API.

Erreurs, limites, logs

Une erreur revient comme résultat d’outil isError, au format de l’API (quota_exceeded, plan_feature_unavailable, insufficient_scope…). Une authentification manquante répond 401 avec un en-tête WWW-Authenticate qui oriente le client vers OAuth.
Les limites de débit de l’API s’appliquent, par clé ou par assistant connecté.
Chaque appel apparaît dans Réglages → Développeurs → Logs, marqué MCP, avec la route /v1 réellement appelée.

Pièges

Identifiants préfixés : passez les br_…, alrt_…, task_… renvoyés par un outil tels quels au suivant.
Un bloc null n’a jamais été mesuré : ce n’est pas 0 %.
Déconnecter les autres sessions (profil) ne coupe pas les assistants : utilisez Applications connectées.