> ## 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.
# Available tools
> Chaque outil que le serveur MCP de Scanova expose à un assistant IA connecté.
**Source de vérité de cette page.** Cette liste est transcrite directement depuis `list_mcp_tools()` dans [`src/mcp_http/registry.py`](https://github.com/trycon/scanova-mcp/blob/main/src/mcp_http/registry.py) du dépôt public `trycon/scanova-mcp` — exactement le code qui répond à l'appel `tools/list` d'un vrai client MCP contre `https://mcp.scanova.io/mcp`. Elle ne provient **pas** du README de ce dépôt, qui est obsolète : le README ne fait la promotion que de 7 outils de gestion des QR codes, alors que le serveur déployé en enregistre en réalité 42 répartis en 8 catégories. Le **Type** de chaque outil ci-dessous reflète sa véritable annotation MCP (`readOnlyHint`/`destructiveHint`) issue du même fichier.
Un assistant IA connecté appelle d'abord `initialize` (le serveur signale `protocolVersion: "2025-03-26"`, `serverInfo: { name: "scanova-mcp", version: "1.0.0" }`), puis `tools/list` pour découvrir tout ce qui suit, puis `tools/call` par outil. Les 42 outils agissent sur votre propre compte Scanova, avec les identifiants utilisés par votre client pour s'authentifier (voir [Setup](/fr/mcp/setup)).
## Passerelle vers la documentation Scanova
Permet à l'assistant de consulter ce site de documentation en direct, en cours de conversation.
| Tool | Type | Description |
| :--------------- | :------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `probe_docs_mcp` | Lecture seule | Vérifie la connectivité au serveur MCP de documentation de Scanova et liste ses outils disponibles. |
| `query_docs` | Lecture seule | Recherche dans la documentation API de Scanova (`mode="search"`), ou exécute une commande en lecture seule de type système de fichiers — `cat`, `head`, `rg`, `tree`, `jq` — contre la documentation (`mode="filesystem"`), par exemple pour lire directement une page de référence spécifique. |
## Conception des QR codes
| Tool | Type | Description |
| :---------------------- | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_qr_design_options` | Lecture seule | Renvoie le catalogue complet des options de design — motifs, styles de dégradé, formes d'œil, cadres, niveaux de correction d'erreur et polices — afin que l'assistant puisse proposer de vrais choix avant d'appeler `set_qr_design`. |
| `set_qr_design` | Écriture | Applique un design visuel à un QR code existant à partir de paramètres nommés conviviaux (motif, couleurs, forme d'œil, cadre, logo, etc.). Seuls les champs que vous précisez changent — tout le reste est conservé en fusionnant avec le design actuel du QR code. |
## Gestion des QR codes
| Tool | Type | Description |
| :------------------------- | :------------ | :-------------------------------------------------------------------------------------------------------------------------------- |
| `create_qr_code` | Écriture | Crée un nouveau QR code. |
| `list_qr_codes` | Lecture seule | Liste les QR codes et/ou pages du compte, avec pagination et recherche ; peut filtrer sur les QR codes seuls ou les pages seules. |
| `update_qr_code` | Écriture | Met à jour un QR code existant. |
| `retrieve_qr_code` | Lecture seule | Récupère les détails d'un QR code spécifique. |
| `download_qr_code` | Lecture seule | Télécharge l'image d'un QR code au format PNG, JPG, PDF, SVG ou EPS. |
| `activate_qr_code` | Écriture | Active un QR code. |
| `deactivate_qr_code` | Écriture | Désactive un QR code. |
| `delete_qr_code` | Destructif | Supprime définitivement un QR code. |
| `get_qr_categories` | Lecture seule | Liste les catégories de QR codes disponibles (URL, vCard, WiFi, Document, Social Media, etc.). |
| `download_qr_printable` | Lecture seule | Génère une version PDF optimisée pour l'impression d'un QR code. |
| `attach_form_to_qr` | Écriture | Rattache un formulaire de capture de leads à un QR code. |
| `detach_form_from_qr` | Écriture | Retire le formulaire de capture de leads d'un QR code. |
| `attach_lead_list_to_qr` | Écriture | Rattache une liste de leads à un QR code pour la capture de leads. |
| `detach_lead_list_from_qr` | Écriture | Retire la liste de leads d'un QR code. |
## Analytique
| Tool | Type | Description |
| :------------------ | :------------ | :------------------------------------------------------------------------------------------------------------------ |
| `get_account_stats` | Lecture seule | Récupère les compteurs d'utilisation au niveau du compte — total des QR codes, scans, utilisateurs, etc. |
| `get_qr_analytics` | Lecture seule | Récupère les indicateurs de performance d'un QR code, ventilés par appareil, géographie, date et autres dimensions. |
| `export_analytics` | Lecture seule | Exporte les analyses d'un QR code sous forme de rapport Excel ou PDF. |
| `export_raw_scans` | Lecture seule | Exporte les journaux de scan ligne par ligne au format CSV ou Excel, pour des pipelines BI personnalisés. |
## Gestion des dossiers
| Tool | Type | Description |
| :------------------------------ | :------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create_folder` | Écriture | Crée un nouveau dossier pour organiser des QR codes ou des pages. |
| `list_folders` | Lecture seule | Liste tous les dossiers d'un type donné (`qr` ou `page`). |
| `update_folder` | Écriture | Renomme un dossier existant. |
| `delete_folder` | Destructif | Supprime un dossier. La description propre de l'outil demande à l'assistant de d'abord confirmer avec vous si les QR codes contenus doivent être déplacés vers Uncategorized ou supprimés avec le dossier. |
| `move_qr_codes_to_folder` | Écriture | Déplace plusieurs QR codes vers un dossier. |
| `unassign_qr_codes_from_folder` | Écriture | Retire plusieurs QR codes d'un dossier (ils deviennent Uncategorized). |
## Formulaires
| Tool | Type | Description |
| :-------------- | :------------ | :--------------------------------------------------------------------------------------------- |
| `list_forms` | Lecture seule | Liste tous les formulaires de capture de leads, éventuellement filtrés par statut actif. |
| `retrieve_form` | Lecture seule | Récupère des informations détaillées sur un formulaire spécifique, y compris sa configuration. |
| `update_form` | Écriture | Met à jour le nom ou le statut actif d'un formulaire. |
| `delete_form` | Destructif | Supprime définitivement un formulaire. |
## Listes de leads
| Tool | Type | Description |
| :------------------- | :------------ | :------------------------------------------------------------------------------------------------------------- |
| `list_lead_lists` | Lecture seule | Liste toutes les listes de leads, éventuellement filtrées par statut actif. |
| `retrieve_lead_list` | Lecture seule | Récupère des informations détaillées sur une liste de leads spécifique, y compris sa configuration de webhook. |
| `update_lead_list` | Écriture | Met à jour le nom ou le statut actif d'une liste de leads. |
| `delete_lead_list` | Destructif | Supprime définitivement une liste de leads. |
## Gestion des utilisateurs
| Tool | Type | Description |
| :----------------- | :------------ | :------------------------------------------------------- |
| `list_users` | Lecture seule | Liste tous les utilisateurs du compte. |
| `get_user` | Lecture seule | Récupère les détails d'un utilisateur spécifique. |
| `add_user` | Écriture | Invite un nouvel utilisateur au compte par e-mail. |
| `remove_user` | Destructif | Retire un utilisateur du compte. |
| `list_user_roles` | Lecture seule | Liste tous les rôles utilisateur pouvant être attribués. |
| `update_user_role` | Écriture | Modifie le rôle d'un utilisateur existant. |
**Les outils destructifs sautent volontairement une boîte de dialogue de confirmation** — le protocole MCP n'a pas d'étape « êtes-vous sûr ? » intégrée ; toute confirmation qui a lieu dépend des propres conventions d'interface de votre client IA. Vérifiez ce qu'un appel à `delete_*` ou `remove_user` s'apprête à faire avant de l'approuver, de la même façon que pour toute autre action d'écriture que vous déléguez à un assistant.
## À voir aussi
* [MCP overview](/fr/mcp/overview) — ce qu'est le serveur, ce qu'il peut faire en un coup d'œil, et ses exigences d'accès.
* [MCP setup](/fr/mcp/setup) — connectez un client IA au serveur qui expose ces outils.
* [Management API overview](/fr/api-reference/management-api/overview) — l'API sous-jacente que ces outils appellent en votre nom.