Tally

oficial

Crear y editar formularios de Tally y analizar envíos

¿Qué puedes hacer con Tally MCP?

  • Crear formularios a partir de una descripción — Pide al asistente que cree un nuevo formulario, como un formulario de contacto simple, que se guarda como borrador privado hasta que lo publiques.
  • Editar formularios existentes — Solicita cambios en un formulario por URL, como eliminar un campo, añadir un captcha o hacer que un campo sea opcional.
  • Publicar formularios — Pide al asistente que publique un formulario en borrador cuando estés listo para compartirlo.
  • Obtener envíos de formularios — Recupera los envíos de un formulario, opcionalmente filtrados por estado y rango de fechas, con las etiquetas de las preguntas y los datos de respuesta.
  • Listar y filtrar formularios — Lista los formularios de tus espacios de trabajo accesibles y filtra por nombre, estado o recencia.

Documentación

Servidor MCP

Crea formularios de Tally y lista formularios o envíos usando asistentes de IA a través del Model Context Protocol

[!WARNING]

El servidor MCP de Tally está actualmente en versión beta y sujeto a cambios.

¿Qué es MCP?

El Model Context Protocol (MCP) te permite crear formularios de Tally y recuperar formularios o envíos usando lenguaje natural a través de asistentes de IA como Claude.

URL del servidor

El servidor MCP de Tally está disponible en:

https://api.tally.so/mcp

Autenticación

El servidor MCP de Tally admite dos métodos de autenticación:

Opción 1: OAuth (recomendado)

La forma más sencilla de conectarse es mediante OAuth. Muchos asistentes de IA admiten la autenticación OAuth para servidores MCP, lo que te permite conectarte con solo unos clics sin gestionar manualmente las claves de API.

Cuando tu asistente de IA solicite autenticación OAuth:

  1. Haz clic en el botón de conexión o en el enlace de autorización
  2. Inicia sesión en tu cuenta de Tally (si aún no lo has hecho)
  3. Autoriza la conexión
  4. El asistente de IA configurará la conexión automáticamente

Opción 2: Clave de API

También puedes autenticarte usando una clave de API en el encabezado Authorization:

Authorization: Bearer tly-xxxx

Obtén más información sobre cómo obtener tu clave de API.

Configuración

Claude Desktop

Este método funciona para Claude Desktop y claude.ai, y se aplica a todas las aplicaciones de Claude que admiten conectores, incluidos Claude Chat, Claude Code y Claude Cowork.

  1. Abre Claude Desktop (o claude.ai en tu navegador) y ve a Customize > Connectors > Add custom connector en la barra lateral izquierda.

    Claude connectors

  2. Asigna un nombre al conector y la URL del servidor MCP de Tally.

https://api.tally.so/mcp
  1. Haz clic en "Add" para guardar el conector.

    Add Tally MCP connector

  2. Reinicia Claude Desktop

  3. La primera vez que uses el servidor MCP de Tally, Claude abrirá un flujo OAuth para autenticarse con tu cuenta de Tally.

Claude Code CLI

Para conectar Claude Code con el servidor MCP de Tally, ejecuta el siguiente comando en tu terminal:

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

Claude Code gestionará el flujo OAuth automáticamente la primera vez que uses el servidor MCP de Tally. Puedes verificar la conexión ejecutando el comando /mcp dentro de Claude Code.

Cursor

  1. Abre Cursor Settings > Tools & MCP
  2. Haz clic en New MCP Server
  3. Pega el siguiente JSON para configurar el servidor MCP de Tally:
{
  "mcpServers": {
    "tally": {
      "url": "https://api.tally.so/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Ejemplo de uso

Una vez configurado, puedes pedirle a tu asistente de IA que cree formularios usando lenguaje natural. Aquí tienes algunos ejemplos:

Crear un formulario de contacto sencillo

Create a simple contact form

El asistente de IA creará automáticamente un formulario de contacto con los campos que suele incluir, según su comprensión de lo que debe contener un formulario de contacto típico. Los formularios nuevos permanecen como borradores privados hasta que le pidas al asistente que los publique.

Actualizar el formulario de contacto

Si el formulario generado no es exactamente lo que querías, puedes modificarlo fácilmente con una petición de seguimiento:

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

El asistente de IA debería modificar el formulario correctamente. Cada cambio se guarda de inmediato.

Crear un formulario con campos específicos

Como alternativa, puedes ser explícito sobre exactamente qué campos quieres:

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

El asistente de IA debería crear un formulario en borrador con los campos especificados. Pídele que publique el formulario cuando quieras compartirlo.

Actualizar un formulario existente

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

El asistente de IA usará las herramientas MCP para cargar tu formulario y realizar los cambios solicitados. En un formulario publicado, los cambios en preguntas y contenido (incluidos el logotipo, la imagen de portada y el texto del botón de envío) permanecen sin publicar hasta que le pidas al asistente que los publique, mientras que la configuración y otros estilos se aplican de inmediato.

Obtener los envíos de un formulario

Puedes obtener los envíos de cualquier formulario, con filtros opcionales por estado y rango de fechas:

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

El asistente de IA obtendrá y mostrará los envíos que coincidan con tu formulario, incluidos las etiquetas de las preguntas y los datos de las respuestas.

Listar formularios

Puedes listar formularios de todos tus espacios de trabajo accesibles y solicitar filtrado por nombre, estado o fecha reciente:

Show my 10 most recently updated published forms

El asistente de IA llamará a la herramienta MCP de listar formularios y devolverá los formularios que coincidan con detalles clave como el nombre del formulario, la URL, el estado y la fecha de la última actualización.

Ejemplo de uso con Claude

Ejemplo de uso de Tally MCP

Configurar el servidor MCP de Tally usando OAuth con Claude

Configuración de OAuth de Tally MCP

Esta documentación está creada y alojada en Mintlify, una plataforma de documentación para desarrolladores.