> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP setup
> Connectez Claude, ChatGPT, Perplexity ou tout client compatible MCP à votre compte Scanova.
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](/fr/mcp/overview#conditions-dacces). 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.
Dans Claude, ouvrez **Settings → Connectors**.
Cliquez sur **+ Add custom connector**.
Collez `https://mcp.scanova.io/mcp` depuis le panneau.
Collez le **Client ID** et le **Client Secret** affichés dans l'onglet Claude du panneau.
Cliquez sur **Add**, puis sur **Connect**, et approuvez l'accès. Connectez-vous à Scanova lorsque vous y êtes invité.
Dans ChatGPT, ouvrez **Settings → Apps → Advanced settings** et activez **Developer mode**.
Créez une App et collez `https://mcp.scanova.io/mcp` comme URL de serveur.
Cliquez sur **Advanced OAuth settings** et collez le **Client ID** et le **Client Secret** affichés dans l'onglet ChatGPT du panneau.
Autorisez Scanova lorsque vous y êtes invité, puis activez-le depuis le menu des outils dans votre conversation.
Dans Perplexity, ouvrez **Customise → Connectors** et cliquez sur **+ Add Custom Connector**.
Ajoutez un nom et collez `https://mcp.scanova.io/mcp` comme URL de serveur.
Cliquez sur le bouton **Advanced** et collez le **Client ID** et le **Client Secret** affichés dans l'onglet Perplexity du panneau.
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](/fr/api-reference/management-api/overview) Scanova avec `environment=mcp`, le même type de token documenté dans [Creating an API token](/fr/api-reference/management-api/tokens/create). 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 :
```json Cursor (~/.cursor/mcp.json) theme={null}
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "YOUR_SCANOVA_MCP_TOKEN"
}
}
}
}
```
```json VS Code (~/.vscode/mcp.json) theme={null}
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "YOUR_SCANOVA_MCP_TOKEN"
}
}
}
}
```
```json Claude Desktop (claude_desktop_config.json) theme={null}
{
"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](/fr/mcp/available-tools) pour tout ce que votre assistant IA peut désormais faire.
## À voir aussi
* [MCP overview](/fr/mcp/overview) — ce que fait le serveur, les conditions d'accès, et le verrou de quota `INTEGRATION_MCP`.
* [Available tools](/fr/mcp/available-tools) — la liste complète et vérifiée des outils disponibles une fois connecté.
* [Create an API token](/fr/api-reference/management-api/tokens/create) — le même type de clé que génère l'alternative par token décrite ici, avec `environment=mcp`.
* [Management API overview](/fr/api-reference/management-api/overview) — l'architecture d'authentification à deux hôtes contre laquelle s'authentifie l'alternative par token.