NueForm

Intégration MCP

Connectez votre plateforme d'IA préférée à NueForm avec le Model Context Protocol.

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 :

text
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

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 :

bash
claude mcp add nueform --transport http https://nueform.io/api/mcp

Ou ajoutez-le à votre .claude/settings.json :

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) :

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Windsurf

Ajoutez-le à votre configuration MCP dans les paramètres de Windsurf :

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Ajoutez-le à .vscode/mcp.json dans votre espace de travail :

json
{
  "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)

OutilDescription
list_formsLister les formulaires, avec recherche, pagination et filtres
get_formObtenir un formulaire avec toutes ses questions
create_formCréer un formulaire, avec des questions si vous le souhaitez
update_formMettre à jour les paramètres et les questions d'un formulaire (y compris auto_translate : NueLingo, Pro+)
delete_formSupprimer 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_formPublier 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_formDépublier un formulaire (formulaires d'équipe : administrateurs et propriétaires de l'équipe uniquement)
duplicate_formDupliquer 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)

OutilDescription
get_dashboard_analyticsStatistiques agrégées de tous les formulaires
get_form_analyticsStatistiques d'un formulaire précis
get_geo_pointsDonnées de dispersion géographique des réponses
get_temporal_responseRépartition des réponses par heure
get_question_timingDonnées de dispersion du temps par question

Réponses (5 outils)

OutilDescription
list_responsesLister les réponses, avec des filtres de date et de complétion
get_responseObtenir une réponse avec toutes ses valeurs
delete_responseSupprimer une réponse
export_responses_csvExporter toutes les réponses en CSV
bulk_delete_responsesSupprimer jusqu'à 100 réponses à la fois

Webhooks (6 outils)

OutilDescription
get_form_webhookObtenir la configuration du webhook d'un formulaire
update_form_webhookDéfinir ou retirer l'URL du webhook d'un formulaire
list_global_webhooksLister les endpoints de webhooks globaux (Pro+)
update_global_webhooksMettre à jour les webhooks globaux (Pro+)
get_webhook_secretObtenir le secret de signature des webhooks (Pro+)
regenerate_webhook_secretRégénérer le secret de signature (Pro+)

Équipes (12 outils)

OutilDescription
list_teamsLister toutes les équipes dont vous faites partie
create_teamCréer une équipe
get_teamObtenir les détails et les membres d'une équipe
update_teamModifier le nom de l'équipe
delete_teamSupprimer une équipe (propriétaire uniquement)
list_team_membersLister les membres de l'équipe
add_team_memberAjouter 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_memberChanger le rôle d'un membre (admin, editor ou viewer ; member est un alias obsolète de viewer)
remove_team_memberRetirer un membre (annule aussi ses invitations en attente à l'équipe)
list_invitationsLister 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_invitationInviter 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_invitationAnnuler une invitation en attente

Sessions Fuse (9 outils)

OutilDescription
list_fuse_sessionsLister les sessions Fuse d'un formulaire, chacune avec ses résultats en direct et ses participants
create_fuse_sessionDémarrer une session Fuse pour un formulaire (elle garde la configuration Fuse du formulaire telle qu'elle est maintenant)
get_fuse_sessionObtenir une session avec ses résultats en direct et ses participants
rename_fuse_sessionRenommer une session
pause_fuse_sessionMettre en pause une session active
resume_fuse_sessionReprendre une session en pause
archive_fuse_sessionArchiver une session
unarchive_fuse_sessionDésarchiver une session
delete_fuse_sessionSupprimer une session avec ses participants et ses actions (irréversible)

Composites (6 outils)

OutilDescription
list_compositesLister vos composites (groupes réutilisables de sous-champs pour les questions composites et les listes)
get_compositeObtenir un composite avec sa copie de travail et son état de publication
create_compositeCréer un composite vide en brouillon
update_compositeRemplacer la copie de travail d'un composite (les formulaires gardent la version publiée jusqu'à ce que vous publiiez)
publish_compositePublier la copie de travail : les formulaires qui utilisent le composite la reprennent à leur prochaine publication
delete_compositeSupprimer un composite qu'aucun formulaire n'utilise plus (les réponses collectées sont conservées)

Général (6 outils)

OutilDescription
get_userObtenir votre profil et les informations de votre plan
list_filesLister les fichiers importés
get_form_themeObtenir les paramètres de thème d'un formulaire
update_form_themeModifier les couleurs, les polices et le style
list_payment_accountsLister vos comptes Stripe Connect et vos comptes de paiement par nom, pour les questions de paiement
list_form_versionsLister les versions publiées d'un formulaire, de la plus récente à la plus ancienne

Voice Studio (8 outils)

OutilDescription
voice_estimateGratuit : ce que voice_generate dépenserait pour un texte ou un script, la durée de l'audio et si votre solde suffit
voice_generateFaire 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_listLes voix de catalogue de NueForm, les vôtres et celles de vos équipes, avec les identifiants nv_… à utiliser
voice_designConcevoir une voix à partir d'une description : 3 options qui disent chacune votre phrase d'exemple. Dépense des crédits (demande max_credits)
voice_saveGarder une option de conception comme voix : 50 000 crédits (5 $). Demande max_credits
voice_cloneCloner 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_listVotre Bibliothèque Voice Studio, ou celle d'une équipe, des plus récents aux plus anciens, avec recherche
library_getUn 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)

OutilDescription
studio_audio_mergeAudio 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_statusGratuit : l'avancement d'un lot (clips faits, en échec et restants) et les crédits utilisés
studio_voice_dropVoice 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_statusGratuit : la livraison à chaque destinataire, par appel ou SMS, ou non livrée et ce qui a été rendu
studio_time_capsuleTime 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_podcastPodcast 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_qrTalking 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)

OutilDescription
credits_balanceLes crédits que vous pouvez dépenser maintenant, les crédits inclus ce mois-ci et ceux qui expirent bientôt
credits_activityUn mois d'activité de crédits, du plus récent au plus ancien : débits, remboursements automatiques et attributions
rate_cardCe 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_get en 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_balance indique ce que cela vous permet de dépenser. studio_voice_drop et studio_time_capsule utilisent 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_analytics avec 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_form avec 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_csv et 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_list pour trouver Rosa, puis voice_generate avec max_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.

Dernière mise à jour : 22 novembre 2026