MCP setup - Scanova API Documentation

Ce guide est rédigé à partir du composant d’intégration MCP du tableau de bord (McpBody) et de sa configuration, ainsi que de la véritable source publique du serveur trycon/scanova-mcp — pas à partir d’un parcours en direct. Le compte de test provisionné pour cette vérification a rencontré un défi d’authentification multifacteur par clé d’accès sans code de secours accessible, ce qui a bloqué une connexion automatisée par navigateur avant que le panneau ne puisse être capturé en image. Chaque URL, chaque liste d’onglets client et chaque étape ci-dessous est transcrite du contenu réellement affiché par le composant, et devrait donc correspondre exactement au panneau en direct — signalez-le si ce n’est pas le cas.

Il existe deux façons de se connecter, selon que votre outil IA dispose d’une prise en charge native des connecteurs basés sur OAuth.

Prérequis

Votre compte a besoin de l’intégration MCP débloquée — voir Conditions d’accès. Si la carte Integrations → Model Context Protocol affiche Upgrade au lieu de Connect, le reste de cette page ne s’appliquera pas encore.

Étape 1 : ouvrir l’intégration MCP

Depuis le tableau de bord, allez dans Integrations et cliquez sur la carte Model Context Protocol. Cela ouvre un panneau de configuration affichant l’URL de votre serveur MCP Scanova :

https://mcp.scanova.io/mcp

avec un badge OAuth et un bouton de copie. C’est l’unique URL à laquelle se connecte chaque client ci-dessous — un endpoint réel et actif (vérifié à partir de la source du serveur déployé et de ses réponses d’information /health//), pas un espace réservé.

Option A : clients natifs OAuth (Claude, ChatGPT, Perplexity)

Le panneau comporte un onglet par client, chacun avec ses propres étapes numérotées et une paire Client ID/Client Secret affichée en ligne (copiez-les depuis le panneau lui-même — ils ne sont pas reproduits ici). Ce sont des identifiants de connecteur publics propres à ce produit IA, pas un secret personnel ; vous effectuez tout de même ensuite une véritable connexion et un consentement OAuth auprès de Scanova.

Claude
ChatGPT
Perplexity

Ouvrir les paramètres Connectors

Dans Claude, ouvrez Settings → Connectors.

Ajouter un connecteur personnalisé

Cliquez sur + Add custom connector.

Coller l'URL du serveur

Collez https://mcp.scanova.io/mcp depuis le panneau.

Coller les identifiants OAuth

Collez le Client ID et le Client Secret affichés dans l’onglet Claude du panneau.

Se connecter et autoriser

Cliquez sur Add, puis sur Connect, et approuvez l’accès. Connectez-vous à Scanova lorsque vous y êtes invité.

Activer le mode développeur

Dans ChatGPT, ouvrez Settings → Apps → Advanced settings et activez Developer mode.

Créer une application

Créez une App et collez https://mcp.scanova.io/mcp comme URL de serveur.

Coller les identifiants OAuth

Cliquez sur Advanced OAuth settings et collez le Client ID et le Client Secret affichés dans l’onglet ChatGPT du panneau.

Autoriser

Autorisez Scanova lorsque vous y êtes invité, puis activez-le depuis le menu des outils dans votre conversation.

Ajouter un connecteur personnalisé

Dans Perplexity, ouvrez Customise → Connectors et cliquez sur + Add Custom Connector.

Le nommer et coller l'URL du serveur

Ajoutez un nom et collez https://mcp.scanova.io/mcp comme URL de serveur.

Coller les identifiants OAuth

Cliquez sur le bouton Advanced et collez le Client ID et le Client Secret affichés dans l’onglet Perplexity du panneau.

Ajouter et autoriser

Cliquez sur Add, autorisez Scanova lorsque vous y êtes invité, et commencez à l’utiliser dans vos conversations Perplexity.

Option B : clients à fichier de configuration (Cursor, VS Code, Claude Desktop, ou tout autre)

Pour les clients MCP qui n’ont pas d’interface de connecteur OAuth native — ils utilisent plutôt un fichier de configuration JSON — développez Use a token instead en bas du panneau. Cela génère une clé Management API Scanova avec environment=mcp, le même type de token documenté dans Creating an API token. Cliquez sur Generate token, puis copiez la valeur affichée (masquée dans le panneau ; le bouton de copie révèle la valeur complète dans votre presse-papiers). Ajoutez-la à la configuration MCP de votre client comme valeur de l’en-tête Authorization — c’est exactement le format documenté dans le propre README du serveur :

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

Placez la valeur brute du token dans l’en-tête Authorization — sans préfixe Bearer. Le serveur lit ce qui se trouve dans cet en-tête (il accepte aussi X-API-Key ou Scanova-API-Key) et le transmet tel quel à la Management API de Scanova, qui rejette tout ce qui n’est pas la clé brute.

Redémarrez votre IDE/client après avoir enregistré la configuration.

Révoquer l’accès

Clients par token : dans la section développée Use a token instead du panneau, cliquez sur l’icône de corbeille à côté du token et confirmez. Cela désactive immédiatement chaque client MCP utilisant ce token. Clients OAuth (Claude/ChatGPT/Perplexity) : retirez le connecteur depuis la propre liste de connecteurs/paramètres de cet outil IA — il utilise un token d’accès OAuth standard émis pour ce client spécifique, indépendamment de l’alternative par token ci-dessus.

Dépannage

« Invalid token » / appels d’outils échouant avec une erreur 401 — le token a été révoqué ou a expiré. Générez-en un nouveau et mettez à jour la configuration de votre client.
Outil introuvable après l’ajout du serveur — redémarrez votre IDE ou votre client ; la plupart des clients MCP ne récupèrent la liste des outils qu’une seule fois, au démarrage ou à la connexion.
Erreurs de connexion — vérifiez que l’URL est exactement https://mcp.scanova.io/mcp (pas /health ni l’origine brute) et que votre réseau peut l’atteindre.

Étape suivante

Consultez Available tools pour tout ce que votre assistant IA peut désormais faire.

À voir aussi

MCP overview — ce que fait le serveur, les conditions d’accès, et le verrou de quota INTEGRATION_MCP.
Available tools — la liste complète et vérifiée des outils disponibles une fois connecté.
Create an API token — le même type de clé que génère l’alternative par token décrite ici, avec environment=mcp.
Management API overview — l’architecture d’authentification à deux hôtes contre laquelle s’authentifie l’alternative par token.

​Prérequis

​Étape 1 : ouvrir l’intégration MCP

​Option A : clients natifs OAuth (Claude, ChatGPT, Perplexity)

​Option B : clients à fichier de configuration (Cursor, VS Code, Claude Desktop, ou tout autre)

​Révoquer l’accès

​Dépannage

​Étape suivante

​À voir aussi

Prérequis

Étape 1 : ouvrir l’intégration MCP

Option A : clients natifs OAuth (Claude, ChatGPT, Perplexity)

Option B : clients à fichier de configuration (Cursor, VS Code, Claude Desktop, ou tout autre)

Révoquer l’accès

Dépannage

Étape suivante

À voir aussi