Passer au contenu principal
Le Model Context Protocol (MCP) est un standard open-source pour connecter les applications d’IA à des systèmes externes. Topsort fournit un serveur MCP via Mintlify qui donne aux assistants IA un accès direct à notre documentation API complète, leur permettant de fournir des informations précises et à jour sur nos API.
Pensez au MCP comme un port USB-C pour les applications d’IA. Tout comme l’USB-C fournit une façon standardisée de connecter des appareils, le MCP fournit une façon standardisée de connecter les applications d’IA à des sources de données externes comme notre documentation API.

​
Ce que vous pouvez faire

En vous connectant au serveur MCP de Topsort, les assistants IA peuvent :
  • Accéder à la documentation API complète - Interroger les détails des endpoints, les paramètres, les schémas de requête/réponse et les exemples
  • Obtenir des conseils d’intégration précis - Recevoir des exemples de code à jour et des instructions d’implémentation
  • Dépanner plus rapidement - Référencer rapidement les codes d’erreur, les limites de taux et les méthodes d’authentification
  • Rester à jour - Toujours accéder à la dernière documentation API sans mises à jour manuelles

​
Démarrage rapide

Notre serveur MCP est disponible à : 
https://api.docs.topsort.com/mcp
Le serveur MCP est accessible publiquement et ne nécessite pas d’authentification. Cependant, vous aurez besoin de clés API pour réellement utiliser l’API Topsort dans vos applications.

​
Guides d’intégration

VS Code & GitHub Copilot

Utilisez MCP avec GitHub Copilot dans Visual Studio Code

ChatGPT

Connectez ChatGPT pour accéder à la documentation Topsort

Claude Desktop

Configurez Claude Desktop pour le développement local

Autres clients

Cursor, Windsurf, Continue, et plus

​
VS Code avec GitHub Copilot

GitHub Copilot prend en charge les serveurs MCP à la fois dans l’agent de codage et l’interface de chat.

​
Prérequis

  • VS Code version 1.95.0 ou ultérieure
  • Extension GitHub Copilot installée et activée
  • Extension GitHub Copilot Chat installée

​
Configuration

1

Ouvrir les paramètres VS Code

Appuyez sur Cmd+, (Mac) ou Ctrl+, (Windows/Linux) pour ouvrir les Paramètres.
2

Naviguer vers la configuration MCP

Recherchez “MCP” dans la barre de recherche des paramètres, ou naviguez vers Extensions > GitHub Copilot > MCP.
3

Ajouter le serveur MCP Topsort

Cliquez sur Modifier dans settings.json et ajoutez :
{
  "github.copilot.chat.mcp.servers": {
    "topsort": {
      "type": "http",
      "url": "https://api.docs.topsort.com/mcp"
    }
  }
}
4

Recharger VS Code

Appuyez sur Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux), tapez “Developer: Reload Window” et appuyez sur Entrée.

​
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 : Documentation API Topsort
  • URL du serveur : https://api.docs.topsort.com/mcp - Type de transport : http

​
Claude Desktop

Claude Desktop fournit un support MCP local complet.
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-api": {
      "type": "http",
      "url": "https://api.docs.topsort.com/mcp",
      "description": "Documentation API Topsort"
    }
  }
}
4

Redémarrer Claude Desktop

Enregistrez la configuration et redémarrez Claude Desktop.

​
Autres clients MCP

​
Cursor

Ajoutez à vos paramètres Cursor : 
{
  "mcp": {
    "servers": {
      "topsort": {
        "type": "http",
        "url": "https://api.docs.topsort.com/mcp"
      }
    }
  }
}

​
Windsurf Editor

Configurez dans ~/.windsurf/mcp.json : 
{
  "servers": {
    "topsort": {
      "type": "http",
      "url": "https://api.docs.topsort.com/mcp"
    }
  }
}

​
Continue

Ajoutez à ~/.continue/config.json : 
{
  "mcpServers": {
    "topsort": {
      "transport": {
        "type": "http",
        "url": "https://api.docs.topsort.com/mcp"
      }
    }
  }
}

​
Cline

Configurez dans ~/Documents/Cline/MCP/config.json : 
{
  "topsort": {
    "type": "http",
    "url": "https://api.docs.topsort.com/mcp"
  }
}

​
Dépannage

​
Problèmes de connexion

  • Vérifiez que l’URL est correcte : https://api.docs.topsort.com/mcp
  • Vérifiez votre connexion Internet
  • Redémarrez votre application client MCP
  • Examinez les journaux spécifiques au client pour les messages d’erreur

​
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
Bien que le serveur MCP lui-même ne nécessite pas d’authentification, vous aurez toujours besoin de clés API valides pour réellement utiliser l’API Topsort dans vos applications. Ne partagez jamais vos clés API dans les conversations ou ne les committez pas au contrôle de version.

​
En savoir plus

Besoin d'aide avec votre intégration Topsort ?

Parlez-nous, l'équipe d'ingénierie des intégrations.Contactez-nous via votre canal de messagerie dédié ou à support@topsort.com.Si vous n'êtes pas encore client, planifiez une démo avec notre équipe de vente.