> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Serveur MCP Analytics
> Connectez vos agents IA à la plateforme publicitaire de Topsort pour des analyses en temps réel et des opérations de catalogue
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](/api/mcp) 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` :
```json theme={null}
{
"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 :
```json theme={null}
{
"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
Connecter ChatGPT aux analytics Topsort
Configurer Claude Desktop avec authentification
Tester le serveur MCP avec Postman
## ChatGPT
ChatGPT prend en charge les serveurs MCP distants pour les abonnés Plus et Team.
Naviguez vers [chat.openai.com](https://chat.openai.com) et cliquez sur votre icône de profil, puis sélectionnez **Paramètres**.
Cliquez sur **Connexions** ou **Intégrations** dans la barre latérale des paramètres.
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
* **macOS** : Cliquez sur **Claude** dans la barre de menu → **Paramètres**
* **Windows** : Cliquez sur **Fichier** → **Paramètres**
Cliquez sur l'onglet **Développeur** dans la barre latérale gauche.
Cliquez sur **Modifier la config** et ajoutez :
```json theme={null}
{
"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 :
```json theme={null}
{
"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"
]
}
}
}
```
Enregistrez la configuration et redémarrez Claude Desktop.
## Postman
Vous pouvez tester le serveur MCP Analytics en utilisant le support MCP de Postman.
Lancez Postman et naviguez vers **Paramètres** → **Serveurs MCP**.
Cliquez sur **Ajouter un serveur** et configurez :
* **Nom** : `Topsort Analytics`
* **URL** : `https://mcp-server.api.topsort.ai/mcp`
Ajoutez les en-têtes requis :
* `X-API-Key` : Votre clé API Topsort
* `X-Vendor-Id` : (Optionnel) ID Vendeur pour un accès limité
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](https://status.topsort.com) pour toute interruption de service
## En savoir plus
* [Documentation du Model Context Protocol](https://modelcontextprotocol.io)
* [Liste des clients MCP](https://modelcontextprotocol.io/clients)
* [Documentation de l'API Topsort](/api-reference)
* [Serveur MCP Documentation](/api/mcp) - Pour l'intégration API assistée par IA