MCP setup - Scanova API Documentation

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 doit avoir l’intégration MCP activé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.

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. Vous effectuez ensuite une connexion OAuth et autorisez l’accès à votre compte 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 Créer et gérer les clés API. 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 — tous les outils disponibles une fois connecté
Créer et gérer les clés API — le même type de clé que génère l’alternative par token décrite ici, avec environment=mcp
Management API overview — le schéma d’authentification par clé brute contre lequel 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