Passer au contenu principal
Le Model Context Protocol (MCP) est un standard ouvert pour connecter les applications d’IA à des systèmes externes—pensez-y comme un port USB-C pour l’IA. Notre serveur MCP Analytics donne à vos assistants IA un accès direct aux APIs d’analyse publicitaire et de catalogue de Topsort.
Vous cherchez plutôt un accès à la documentation ? Consultez notre Serveur MCP Documentation pour des conseils d’intégration API assistés par IA.

​
Ce que vous pouvez faire

En vous connectant au serveur MCP Analytics de Topsort, les assistants IA peuvent :
  • Analyser les performances publicitaires - Interroger des métriques en temps réel comme le CTR, CVR, ROAS, CPC et les dépenses publicitaires à travers les campagnes ou marketplaces
  • Surveiller la santé des campagnes - Vérifier l’utilisation du budget, le comportement des enchères, les scores de qualité et le rythme en temps réel
  • Comparer les performances dans le temps - Exécuter des comparaisons semaine par semaine, mois par mois ou de périodes personnalisées pour identifier les tendances et anomalies
  • Comparer à l’industrie - Comparer les métriques de campagne aux benchmarks de catégorie (retail, pharmacie, voyage, etc.)
  • Visualiser les insights - Générer des graphiques en lignes, barres et camemberts à partir de n’importe quelle donnée analytique pour une interprétation facile
  • Obtenir des conseils Topsort - Répondre aux questions sur l’intégration API, le dépannage et les meilleures pratiques de la plateforme
Toutes les requêtes peuvent être limitées à un vendeur spécifique, garantissant que les annonceurs n’accèdent qu’à leurs propres données tandis que les opérateurs de marketplace peuvent voir les insights agrégés.

​
Démarrage rapide

Notre serveur MCP Analytics est disponible à : 
https://mcp-server.api.topsort.ai/mcp
Ce serveur MCP nécessite une authentification. Contactez votre représentant commercial Topsort pour demander une clé API avec accès au serveur MCP.

​
Authentification

​
Authentification Marketplace

Toutes les requêtes doivent inclure une clé API valide. Pour les clients MCP qui utilisent mcp-remote (comme Claude Desktop), passez la clé via l’argument --header : 
{
  "mcpServers": {
    "topsort-analytics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-server.api.topsort.ai/mcp",
        "--header",
        "X-API-Key: MPS_xxxx"
      ]
    }
  }
}

​
Filtrage par ID Vendeur

Les résultats des outils peuvent être filtrés pour des vendeurs spécifiques en incluant l’ID Vendeur dans l’en-tête de la requête. Cela restreint la portée de tous les outils, empêchant les fuites de données entre vendeurs : 
{
  "mcpServers": {
    "topsort-analytics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-server.api.topsort.ai/mcp",
        "--header",
        "X-API-Key: MPS_xxxx",
        "--header",
        "X-Vendor-Id: 1111-2222-3333-4444-55555"
      ]
    }
  }
}

​
Filtrage des outils

Les tags permettent un contrôle d’accès fin sur les outils disponibles pour différents clients. Chaque outil peut être annoté avec un ou plusieurs tags, et les clients se voient attribuer leurs propres ensembles de tags. Lors de la récupération des outils, le système filtre la liste en vérifiant tout chevauchement entre les tags du client et les tags requis de chaque outil—un client n’a besoin que d’un tag correspondant pour obtenir l’accès.

​
Guides d’intégration

ChatGPT

Connecter ChatGPT aux analytics Topsort

Claude Desktop

Configurer Claude Desktop avec authentification

Postman

Tester le serveur MCP avec Postman

​
ChatGPT

ChatGPT prend en charge les serveurs MCP distants pour les abonnés Plus et Team.
1

Ouvrir les paramètres ChatGPT

Naviguez vers chat.openai.com et cliquez sur votre icône de profil, puis sélectionnez Paramètres.
2

Accéder aux connexions

Cliquez sur Connexions ou Intégrations dans la barre latérale des paramètres.
3

Ajouter un serveur MCP

Cliquez sur Ajouter une connexion et entrez :
  • Nom : Topsort Analytics
  • URL du serveur : https://mcp-server.api.topsort.ai/mcp
  • Type de transport : http
  • En-têtes : Ajoutez X-API-Key avec votre clé API

​
Claude Desktop

Claude Desktop fournit un support MCP local complet.

​
Prérequis

  • Node.js installé sur votre système (requis pour mcp-remote)

​
Configuration

1

Ouvrir les paramètres Claude Desktop

  • macOS : Cliquez sur Claude dans la barre de menu → Paramètres
  • Windows : Cliquez sur Fichier → Paramètres
2

Naviguer vers l'onglet Développeur

Cliquez sur l’onglet Développeur dans la barre latérale gauche.
3

Modifier la configuration MCP

Cliquez sur Modifier la config et ajoutez :
{
  "mcpServers": {
    "topsort-analytics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-server.api.topsort.ai/mcp",
        "--header",
        "X-API-Key: MPS_xxxx"
      ]
    }
  }
}
Remplacez MPS_xxxx par votre clé API réelle.Pour un accès limité au vendeur, ajoutez un argument --header supplémentaire :
{
  "mcpServers": {
    "topsort-analytics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-server.api.topsort.ai/mcp",
        "--header",
        "X-API-Key: MPS_xxxx",
        "--header",
        "X-Vendor-Id: 1111-2222-3333-4444-55555"
      ]
    }
  }
}
4

Redémarrer Claude Desktop

Enregistrez la configuration et redémarrez Claude Desktop.

​
Postman

Vous pouvez tester le serveur MCP Analytics en utilisant le support MCP de Postman.
1

Ouvrir Postman

Lancez Postman et naviguez vers Paramètres → Serveurs MCP.
2

Ajouter un nouveau serveur

Cliquez sur Ajouter un serveur et configurez :
  • Nom : Topsort Analytics
  • URL : https://mcp-server.api.topsort.ai/mcp
3

Configurer les en-têtes

Ajoutez les en-têtes requis :
  • X-API-Key : Votre clé API Topsort
  • X-Vendor-Id : (Optionnel) ID Vendeur pour un accès limité
4

Tester la connexion

Cliquez sur Tester la connexion pour vérifier que le serveur répond correctement.

​
Dépannage

​
Problèmes de connexion

  • Vérifiez que l’URL est correcte : https://mcp-server.api.topsort.ai/mcp
  • Assurez-vous que votre clé API est valide et a accès au serveur MCP
  • Vérifiez votre connexion Internet
  • Redémarrez votre application client MCP

​
Erreurs d’authentification

  • Confirmez que votre clé API commence par MPS_
  • Vérifiez que l’en-tête X-API-Key est correctement formaté
  • Contactez votre représentant commercial Topsort si votre clé est rejetée

​
Le serveur ne répond pas

  • Vérifiez que le type de transport est défini sur http
  • Vérifiez si votre pare-feu ou VPN bloque la connexion
  • Consultez notre page de statut pour toute interruption de service

​
En savoir plus