Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants d'IA d'interagir directement avec des services externes. Le serveur MCP de NueForm donne à votre IA un accès complet à votre espace de travail : formulaires, réponses, statistiques, équipes, webhooks, Voice Studio et plus encore.
Que pouvez-vous faire ?
Une fois MCP connecté, vous pouvez demander à votre IA des choses comme :
- « Quel est mon taux de complétion sur l'ensemble de mes formulaires ce mois-ci ? »
- « Crée une enquête de satisfaction client avec un score NPS. »
- « Exporte toutes les réponses du premier trimestre en CSV. »
- « Ajoute sarah@company.com à l'équipe Marketing. »
- « Quelles questions prennent le plus de temps à remplir ? »
- « Lis cette annonce avec la voix de Rosa. Ne dépense pas plus de 2 000 crédits. »
- « Combien de crédits me reste-t-il ce mois-ci ? »
Votre IA traduit automatiquement ces demandes en langage naturel en appels à l'API NueForm.
Prérequis
- Un compte NueForm (le plan gratuit suffit)
- Un client d'IA compatible MCP (voir les guides de configuration ci-dessous)
Guides de configuration
L'URL du serveur MCP de NueForm :
https://nueform.io/api/mcp
L'authentification passe par OAuth : votre client d'IA ouvre une fenêtre de navigateur pour que vous vous connectiez avec votre compte NueForm. Aucune clé API n'est nécessaire.
Claude Desktop
Ajoutez ceci à votre claude_desktop_config.json :
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
Redémarrez Claude Desktop. À la première utilisation, il vous sera demandé de vous connecter avec votre compte NueForm.
Claude Code (CLI)
Exécutez la commande suivante :
claude mcp add nueform --transport http https://nueform.io/api/mcp
Ou ajoutez-le à votre .claude/settings.json :
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
Cursor
Ajoutez-le à .cursor/mcp.json à la racine de votre projet (ou dans les paramètres globaux) :
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
Windsurf
Ajoutez-le à votre configuration MCP dans les paramètres de Windsurf :
{
"mcpServers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
VS Code (GitHub Copilot)
Ajoutez-le à .vscode/mcp.json dans votre espace de travail :
{
"servers": {
"nueform": {
"url": "https://nueform.io/api/mcp"
}
}
}
Autres clients MCP
Tout client compatible avec le transport MCP HTTP Streamable peut se connecter à NueForm. Indiquez-lui :
- URL du serveur :
https://nueform.io/api/mcp - Authentification : OAuth 2.0 (le client doit gérer le flux automatiquement)
Outils disponibles
Le serveur MCP de NueForm propose 75 outils répartis en 11 catégories :
Formulaires (8 outils)
| Outil | Description |
|---|---|
list_forms | Lister les formulaires, avec recherche, pagination et filtres |
get_form | Obtenir un formulaire avec toutes ses questions |
create_form | Créer un formulaire, avec des questions si vous le souhaitez |
update_form | Mettre à jour les paramètres et les questions d'un formulaire (y compris auto_translate : NueLingo, Pro+) |
delete_form | Supprimer un formulaire et toutes ses données (un formulaire avec des contrats signés demande delete_signed_contracts: true, ce qui supprime aussi définitivement les contrats) |
publish_form | Publier un formulaire avec les mêmes vérifications que le bouton Publier de l'éditeur (crée une version ; renvoie des avertissements, ou une erreur listant les questions à corriger) |
unpublish_form | Dépublier un formulaire (formulaires d'équipe : administrateurs et propriétaires de l'équipe uniquement) |
duplicate_form | Dupliquer un formulaire avec toutes ses questions |
Les formulaires sont enregistrés comme brouillons. publish_form (ou published: true dans create_form et update_form) effectue les mêmes vérifications que le bouton Publier de l'éditeur : seuls les administrateurs et propriétaires d'une équipe peuvent publier ses formulaires, les fonctionnalités Pro suivent le plan du propriétaire du formulaire, et les questions de réservation, d'étape d'e-mail, Fuse et composites doivent être entièrement configurées. Si une vérification échoue, rien n'est publié et l'outil renvoie la raison, les questions à corriger et une indication pour votre IA. Un formulaire créé avec published: true est quand même créé comme brouillon lorsque sa publication est bloquée.
Statistiques (5 outils)
| Outil | Description |
|---|---|
get_dashboard_analytics | Statistiques agrégées de tous les formulaires |
get_form_analytics | Statistiques d'un formulaire précis |
get_geo_points | Données de dispersion géographique des réponses |
get_temporal_response | Répartition des réponses par heure |
get_question_timing | Données de dispersion du temps par question |
Réponses (5 outils)
| Outil | Description |
|---|---|
list_responses | Lister les réponses, avec des filtres de date et de complétion |
get_response | Obtenir une réponse avec toutes ses valeurs |
delete_response | Supprimer une réponse |
export_responses_csv | Exporter toutes les réponses en CSV |
bulk_delete_responses | Supprimer jusqu'à 100 réponses à la fois |
Webhooks (6 outils)
| Outil | Description |
|---|---|
get_form_webhook | Obtenir la configuration du webhook d'un formulaire |
update_form_webhook | Définir ou retirer l'URL du webhook d'un formulaire |
list_global_webhooks | Lister les endpoints de webhooks globaux (Pro+) |
update_global_webhooks | Mettre à jour les webhooks globaux (Pro+) |
get_webhook_secret | Obtenir le secret de signature des webhooks (Pro+) |
regenerate_webhook_secret | Régénérer le secret de signature (Pro+) |
Équipes (12 outils)
| Outil | Description |
|---|---|
list_teams | Lister toutes les équipes dont vous faites partie |
create_team | Créer une équipe |
get_team | Obtenir les détails et les membres d'une équipe |
update_team | Modifier le nom de l'équipe |
delete_team | Supprimer une équipe (propriétaire uniquement) |
list_team_members | Lister les membres de l'équipe |
add_team_member | Ajouter par e-mail un utilisateur NueForm existant (rôle admin, editor ou viewer, viewer par défaut ; member est un alias obsolète de viewer). Pour une adresse sans compte, utilisez create_invitation |
update_team_member | Changer le rôle d'un membre (admin, editor ou viewer ; member est un alias obsolète de viewer) |
remove_team_member | Retirer un membre (annule aussi ses invitations en attente à l'équipe) |
list_invitations | Lister les invitations en attente d'une équipe, des plus récentes aux plus anciennes, y compris celles qui ont expiré (signalées par expired : une invitation expirée ne peut plus être acceptée et n'occupe plus de siège ; delete_invitation la supprime). Les jetons de lien ne sont inclus que pour les propriétaires et les administrateurs |
create_invitation | Inviter quelqu'un par e-mail : NueForm lui envoie l'invitation (rôle admin, editor ou viewer, viewer par défaut ; member est un alias obsolète de viewer) |
delete_invitation | Annuler une invitation en attente |
Sessions Fuse (9 outils)
| Outil | Description |
|---|---|
list_fuse_sessions | Lister les sessions Fuse d'un formulaire, chacune avec ses résultats en direct et ses participants |
create_fuse_session | Démarrer une session Fuse pour un formulaire (elle garde la configuration Fuse du formulaire telle qu'elle est maintenant) |
get_fuse_session | Obtenir une session avec ses résultats en direct et ses participants |
rename_fuse_session | Renommer une session |
pause_fuse_session | Mettre en pause une session active |
resume_fuse_session | Reprendre une session en pause |
archive_fuse_session | Archiver une session |
unarchive_fuse_session | Désarchiver une session |
delete_fuse_session | Supprimer une session avec ses participants et ses actions (irréversible) |
Composites (6 outils)
| Outil | Description |
|---|---|
list_composites | Lister vos composites (groupes réutilisables de sous-champs pour les questions composites et les listes) |
get_composite | Obtenir un composite avec sa copie de travail et son état de publication |
create_composite | Créer un composite vide en brouillon |
update_composite | Remplacer la copie de travail d'un composite (les formulaires gardent la version publiée jusqu'à ce que vous publiiez) |
publish_composite | Publier la copie de travail : les formulaires qui utilisent le composite la reprennent à leur prochaine publication |
delete_composite | Supprimer un composite qu'aucun formulaire n'utilise plus (les réponses collectées sont conservées) |
Général (6 outils)
| Outil | Description |
|---|---|
get_user | Obtenir votre profil et les informations de votre plan |
list_files | Lister les fichiers importés |
get_form_theme | Obtenir les paramètres de thème d'un formulaire |
update_form_theme | Modifier les couleurs, les polices et le style |
list_payment_accounts | Lister vos comptes Stripe Connect et vos comptes de paiement par nom, pour les questions de paiement |
list_form_versions | Lister les versions publiées d'un formulaire, de la plus récente à la plus ancienne |
Voice Studio (8 outils)
| Outil | Description |
|---|---|
voice_estimate | Gratuit : ce que voice_generate dépenserait pour un texte ou un script, la durée de l'audio et si votre solde suffit |
voice_generate | Faire lire un texte par une voix, ou un script à plusieurs voix, et le garder dans votre Bibliothèque. Dépense des crédits (demande max_credits) |
voices_list | Les voix de catalogue de NueForm, les vôtres et celles de vos équipes, avec les identifiants nv_… à utiliser |
voice_design | Concevoir une voix à partir d'une description : 3 options qui disent chacune votre phrase d'exemple. Dépense des crédits (demande max_credits) |
voice_save | Garder une option de conception comme voix : 50 000 crédits (5 $). Demande max_credits |
voice_clone | Cloner une voix à partir d'un enregistrement de 30 à 60 secondes disponible à un lien public, avec sa transcription et rights_confirmed: true : 50 000 crédits (5 $). Demande max_credits |
library_list | Votre Bibliothèque Voice Studio, ou celle d'une équipe, des plus récents aux plus anciens, avec recherche |
library_get | Un clip, avec un lien de téléchargement valable 15 minutes une fois l'audio prêt |
Quand NueForm nettoie les enregistrements de voix de votre compte, la réponse de voice_clone contient aussi sample_cleanup : cleaned (si une copie nettoyée a été faite), used (cleaned ou original : l'enregistrement à partir duquel la voix a été faite), steps (ce qui a été fait : noise, hum, rumble, clicks, echo, sibilance, level), voice_check (passed, not_needed, fell_back, ou skipped quand le nettoyage n'a pas pu se faire) et fallback (0 comme prévu, 1 un nettoyage plus léger, 2 l'original conservé). Sans sample_cleanup, l'enregistrement a été utilisé tel quel. echo signifie que l'écho de la pièce a été réduit : pour cette étape, une copie de l'enregistrement est traitée sur les serveurs de notre fournisseur de GPU (elle n'y est pas conservée), et elle n'est utilisée que si la voix sonne toujours pareil.
Studio Apps (7 outils)
| Outil | Description |
|---|---|
studio_audio_merge | Audio Merge : un script avec des espaces réservés {variable} et une ligne de valeurs par clip ; chaque ligne devient son propre clip dans votre Bibliothèque. Les lignes auxquelles il manque une valeur sont ignorées et non facturées. Dépense des crédits (demande max_credits) |
studio_audio_merge_status | Gratuit : l'avancement d'un lot (clips faits, en échec et restants) et les crédits utilisés |
studio_voice_drop | Voice Drop : un message vocal envoyé à des téléphones. Un seul destinataire avec recipient_expects_message: true est un appel personnel ; sinon, l'envoi se fait d'abord par SMS vers les numéros des États-Unis et du Canada ; sont appelés les personnes qui répondent CALL et les numéros que nos SMS n'atteignent pas (hors États-Unis et Canada, si votre forfait permet d'y appeler). Demande un premier achat de crédits et une adresse e-mail vérifiée. Dépense des crédits (demande max_credits) |
studio_voice_drop_status | Gratuit : la livraison à chaque destinataire, par appel ou SMS, ou non livrée et ce qui a été rendu |
studio_time_capsule | Time Capsule : des messages livrés aux jours choisis, à 9 h dans le fuseau horaire du destinataire, par appel, SMS ou e-mail. Un appel demande recipient_expects_message: true. Dépense des crédits (demande max_credits) |
studio_podcast | Podcast from Anything : un épisode à deux animateurs à partir d'un lien ou d'un texte. Le script est écrit gratuitement ; l'épisode n'est produit que si son coût exact tient dans max_credits |
studio_talking_qr | Talking QR : un code QR imprimable qui lit un message vocal quand on le scanne. Hébergement gratuit ; la nouvelle voix dépense des crédits (demande max_credits) |
Crédits (3 outils)
| Outil | Description |
|---|---|
credits_balance | Les crédits que vous pouvez dépenser maintenant, les crédits inclus ce mois-ci et ceux qui expirent bientôt |
credits_activity | Un mois d'activité de crédits, du plus récent au plus ancien : débits, remboursements automatiques et attributions |
rate_card | Ce que coûte chaque action en crédits |
Dépenser des crédits
Les outils qui dépensent des crédits (voice_generate, voice_design, voice_save, voice_clone, studio_audio_merge, studio_voice_drop, studio_time_capsule, studio_podcast et studio_talking_qr) demandent max_credits : le maximum qu'un appel peut dépenser (10 000 crédits = 1 $). Sans ce paramètre, ou si l'appel coûterait plus, rien n'est dépensé et l'outil répond avec le coût exact, pour que votre IA puisse d'abord vous demander.
- La voix coûte 1 crédit par caractère prononcé, dans toutes les langues. Refaire le même clip dans les 30 jours est gratuit, et les lignes qui échouent sont remboursées automatiquement.
- Une nouvelle voix, conçue et enregistrée ou clonée, coûte 50 000 crédits (5 $).
- Les mêmes règles que dans l'application s'appliquent : le texte est vérifié selon la politique d'utilisation avant tout débit, et enregistrer ou cloner une voix demande un premier achat de crédits et une adresse e-mail vérifiée. Ne clonez que des voix que vous avez le droit d'utiliser.
- Si un appel dépasse le délai, relancez-le avec les mêmes arguments et la même
idempotency_key(8 à 100 lettres, chiffres,-ou_; chaque réponse indique celle qui est utilisée) : vous recevez le résultat du premier appel au lieu de payer deux fois. - Les liens audio sont valables 15 minutes.
library_geten fournit un nouveau. - La voix, les nouvelles voix et les Studio Apps qui produisent de la voix sont payées avec ce que vous avez choisi dans Payer Voice Studio avec dans votre Portefeuille : vos propres crédits, sauf si vous avez choisi une équipe (une voix que vous créez appartient alors à l'équipe).
credits_balanceindique ce que cela vous permet de dépenser.studio_voice_dropetstudio_time_capsuleutilisent toujours vos propres crédits. Si l'équipe ne peut pas payer, rien n'est dépensé et la réponse explique pourquoi. - Les crédits ne s'achètent pas, ne s'offrent pas et ne se rechargent pas automatiquement par MCP : faites-le dans votre Portefeuille dans NueForm.
Pour de gros volumes depuis votre propre code, l'API vocale facture 0,4 crédit par caractère.
Exemples d'utilisation
Analyser les performances d'un formulaire
Vous : « Quel est le taux de complétion de mon formulaire Avis clients ce mois-ci ? »
IA : Utilise
get_form_analyticsavec des filtres de date, puis répond : « Votre formulaire Avis clients a un taux de complétion de 73 % ce mois-ci (219 réponses complètes sur 300 au total). C'est mieux que les 68 % du mois dernier. »
Créer un formulaire
Vous : « Crée une enquête de satisfaction client rapide de 3 questions : une note, un champ de commentaire et un champ e-mail. »
IA : Utilise
create_formavec une liste de questions, puis confirme : « C'est fait ! J'ai créé l'« Enquête de satisfaction client » avec 3 questions. Voulez-vous que je la publie ? »
Gérer les réponses
Vous : « Exporte toutes les réponses de mon formulaire Candidature en CSV pour que je puisse les relire dans un tableur. »
IA : Utilise
export_responses_csvet renvoie les données CSV, que vous pouvez enregistrer dans un fichier.
Créer une voix off
Vous : « Lis nos nouveaux horaires avec la voix de Rosa. Ne dépense pas plus de 2 000 crédits. »
IA : Utilise
voices_listpour trouver Rosa, puisvoice_generateavecmax_credits: 2000, et répond : « C'est fait. Cela a coûté 612 crédits. Voici l'audio ; le lien est valable 15 minutes. »
Dépannage
« Authentication failed »
Vérifiez que vous êtes connecté au bon compte NueForm. Essayez de déconnecter puis de reconnecter le serveur MCP dans votre client d'IA.
« Permission denied » sur les outils de webhooks ou d'équipes
Certains outils demandent un plan précis (Pro ou Enterprise) ou un rôle d'équipe (administrateur ou propriétaire). Vérifiez votre plan sur la page de facturation.
Les outils n'apparaissent pas
Redémarrez votre client d'IA après avoir ajouté la configuration MCP. Certains clients doivent être entièrement redémarrés pour détecter un nouveau serveur MCP.
« not_started » avec un outil Voice Studio
Rien n'a été dépensé : l'appel n'avait pas de max_credits, ou le coût était plus élevé. La réponse indique le coût exact ; renvoyez l'appel avec un max_credits au moins égal.
Limites de requêtes
Le serveur MCP de NueForm applique les mêmes limites par minute que l'API REST (100 requêtes par minute, 500 avec Enterprise), comptées par utilisateur et séparément de vos clés API. Chaque requête compte, y compris chacune dans un lot, et un lot peut contenir au maximum 10 requêtes. Si vous enchaînez beaucoup de requêtes, l'IA devra peut-être attendre entre deux appels.