Tally

officiel

Créer et modifier les formulaires Tally et analyser les soumissions

Que pouvez-vous faire avec Tally MCP ?

  • Créer des formulaires à partir d'une description — Demandez à l'assistant de créer un nouveau formulaire, comme un simple formulaire de contact, qui est enregistré en tant que brouillon privé jusqu'à ce que vous le publiiez.
  • Modifier des formulaires existants — Demandez des modifications à un formulaire via son URL, comme supprimer un champ, ajouter un captcha ou rendre un champ facultatif.
  • Publier des formulaires — Demandez à l'assistant de publier un formulaire brouillon lorsque vous êtes prêt à le partager.
  • Récupérer les soumissions de formulaires — Récupérez les soumissions d'un formulaire, éventuellement filtrées par statut et plage de dates, avec les libellés des questions et les données de réponse.
  • Lister et filtrer les formulaires — Listez les formulaires de vos espaces de travail accessibles et filtrez par nom, statut ou récence.

Documentation

Serveur MCP

Créez des formulaires Tally et listez des formulaires ou des soumissions à l'aide d'assistants IA via le Model Context Protocol

[!WARNING]

Le serveur MCP Tally est actuellement en version bêta et susceptible d'évoluer.

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) vous permet de créer des formulaires Tally et de récupérer des formulaires ou des soumissions en langage naturel via des assistants IA comme Claude.

URL du serveur

Le serveur MCP Tally est disponible à l'adresse :

https://api.tally.so/mcp

Authentification

Le serveur MCP Tally prend en charge deux méthodes d'authentification :

Option 1 : OAuth (recommandé)

La façon la plus simple de se connecter est via OAuth. De nombreux assistants IA prennent en charge l'authentification OAuth pour les serveurs MCP, ce qui vous permet de vous connecter en quelques clics sans gérer manuellement les clés API.

Lorsque votre assistant IA demande une authentification OAuth :

  1. Cliquez sur le bouton de connexion ou le lien d'autorisation
  2. Connectez-vous à votre compte Tally (si ce n'est pas déjà fait)
  3. Autorisez la connexion
  4. L'assistant IA configurera automatiquement la connexion

Option 2 : Clé API

Vous pouvez également vous authentifier à l'aide d'une clé API dans l'en-tête Authorization :

Authorization: Bearer tly-xxxx

En savoir plus sur comment obtenir votre clé API.

Configuration

Claude Desktop

Cette méthode fonctionne pour Claude Desktop et claude.ai, et s'applique à toutes les applications Claude prenant en charge les connecteurs, notamment Claude Chat, Claude Code et Claude Cowork.

  1. Ouvrez Claude Desktop (ou claude.ai dans votre navigateur) et accédez à Customize > Connectors > Add custom connector depuis la barre latérale de gauche.

    Claude connectors

  2. Donnez un nom au connecteur et indiquez l'URL du serveur MCP Tally.

https://api.tally.so/mcp
  1. Cliquez sur « Add » pour enregistrer le connecteur.

    Add Tally MCP connector

  2. Redémarrez Claude Desktop

  3. La première fois que vous utilisez le serveur MCP Tally, Claude ouvrira un flux OAuth pour s'authentifier avec votre compte Tally.

Claude Code CLI

Pour connecter Claude Code au serveur MCP Tally, exécutez la commande suivante dans votre terminal :

claude mcp add tally --transport http https://api.tally.so/mcp

Claude Code gérera automatiquement le flux OAuth lors de votre première utilisation du serveur MCP Tally. Vous pouvez vérifier la connexion en exécutant la commande /mcp dans Claude Code.

Cursor

  1. Ouvrez Cursor Settings > Tools & MCP
  2. Cliquez sur New MCP Server
  3. Collez le JSON suivant pour configurer le serveur MCP Tally :
{
  "mcpServers": {
    "tally": {
      "url": "https://api.tally.so/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Exemple d'utilisation

Une fois configuré, vous pouvez demander à votre assistant IA de créer des formulaires en langage naturel. Voici quelques exemples :

Création d'un formulaire de contact simple

Create a simple contact form

L'assistant IA créera automatiquement un formulaire de contact avec les champs habituellement attendus, selon sa compréhension de ce que doit contenir un formulaire de contact type. Les nouveaux formulaires restent des brouillons privés jusqu'à ce que vous demandiez à l'assistant de les publier.

Mise à jour du formulaire de contact

Si le formulaire généré ne correspond pas exactement à ce que vous souhaitiez, vous pouvez facilement le modifier en poursuivant la conversation :

We don't need the Company field, remove the consent checkbox and maybe add a captcha

L'assistant IA devrait correctement modifier le formulaire. Chaque modification est enregistrée immédiatement.

Création d'un formulaire avec des champs spécifiques

Vous pouvez également être explicite sur les champs exacts que vous souhaitez :

Create a contact form with these specific fields:
- Name (required)
- Email (required)
- Phone (optional)
- Message (required)
- Captcha (required)

L'assistant IA devrait créer un formulaire brouillon avec les champs spécifiés. Demandez-lui de publier le formulaire lorsque vous souhaitez le partager.

Mise à jour d'un formulaire existant

Update this form https://tally.so/r/a1B2c3
- Remove the phone number field
- Also add a captcha
- Make company field optional

L'assistant IA utilisera les outils MCP pour charger votre formulaire et effectuer les modifications demandées. Sur un formulaire en ligne, les modifications des questions et du contenu (y compris le logo, l'image de couverture et le texte du bouton d'envoi) restent non publiées jusqu'à ce que vous demandiez à l'assistant de les publier, tandis que les paramètres et les autres éléments de style s'appliquent immédiatement.

Récupération des soumissions de formulaire

Vous pouvez récupérer les soumissions de n'importe quel formulaire, avec des filtres optionnels par statut et plage de dates :

Show me all completed submissions for https://tally.so/r/a1B2c3 from January 2025

L'assistant IA récupérera et affichera les soumissions correspondantes pour votre formulaire, y compris les libellés des questions et les données de réponse.

Liste des formulaires

Vous pouvez lister les formulaires de tous vos espaces de travail accessibles et demander un filtrage par nom, statut ou récence :

Show my 10 most recently updated published forms

L'assistant IA appellera l'outil MCP de liste des formulaires et renverra les formulaires correspondants avec les détails clés tels que le nom du formulaire, l'URL, le statut et la date de dernière mise à jour.

Exemple d'utilisation avec Claude

Exemple d'utilisation de Tally MCP

Configuration du serveur MCP Tally avec OAuth et Claude

Configuration OAuth de Tally MCP

Cette documentation est créée et hébergée sur Mintlify, une plateforme de documentation pour développeurs.