Tally

oficial

Crear y editar formularios de Tally y analizar envíos

¿Qué puedes hacer con Tally MCP?

  • Crear un nuevo formulario — pídele a tu asistente que cree un formulario (por ejemplo, un formulario de contacto) con los campos que especifiques, y lo creará y guardará en Tally.
  • Actualizar un formulario existente — proporciona la URL del formulario y describe los cambios, como agregar, eliminar o modificar campos, y el asistente los aplicará.
  • Listar tus formularios — solicita formularios en todos los espacios de trabajo con filtros como nombre, estado o actualidad usando list_forms.
  • Obtener envíos de formularios — recupera los envíos de un formulario por URL, opcionalmente filtrados por estado o rango de fechas usando get_submissions.

Documentación

Servidor MCP

Crea formularios de Tally y lista formularios o envíos usando asistentes de IA a través del Protocolo de Contexto de Modelo

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

¿Qué es MCP?

El Protocolo de Contexto de Modelo (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 fácil de conectarse es a través de OAuth. Muchos asistentes de IA admiten autenticación OAuth para servidores MCP, lo que te permite conectarte con solo unos clics sin gestionar manualmente las claves API.

Cuando tu asistente de IA solicite autenticación OAuth:

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

Opción 2: Clave API

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

Authorization: Bearer tly-xxxx

Aprende más sobre cómo obtener tu clave 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 admitan conectores, incluyendo Claude Chat, Claude Code y Claude Cowork.

  1. Abre Claude Desktop (o claude.ai en tu navegador) y navega a Personalizar > Conectores > Agregar conector personalizado desde la barra lateral izquierda. Claude connectors
  2. Dale un nombre al conector y la URL del servidor MCP de Tally.
https://api.tally.so/mcp
  1. Haz clic en "Agregar" 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 al servidor MCP de Tally, ejecuta el siguiente comando en tu terminal:

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

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

Cursor

  1. Abre Configuración de Cursor > Herramientas y MCP
  2. Haz clic en Nuevo servidor MCP
  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"
      }
    }
  }
}

Ejemplos de uso

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

Crear un formulario de contacto simple

Create a simple contact form

El asistente de IA creará automáticamente un formulario de contacto con los campos comúnmente esperados basándose en su comprensión de lo que un formulario de contacto típico debería incluir.

Actualizar el formulario de contacto

Si el formulario generado no es exactamente lo que querías, puedes modificarlo fácilmente haciendo un seguimiento:

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

El asistente de IA debería modificar correctamente el formulario y guardarlo.

Crear un formulario con campos específicos

Alternativamente, puedes ser explícito sobre exactamente qué campos deseas:

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 con los campos especificados y guardarlo.

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, realizar los cambios solicitados y guardar la versión actualizada.

Obtener envíos de formularios

Puedes obtener 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 coincidentes para tu formulario, incluyendo etiquetas de preguntas y datos de respuesta.

Listar formularios

Puedes listar formularios en tus espacios de trabajo accesibles y solicitar filtrado por nombre, estado o antigüedad:

Show my 10 most recently updated published forms

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

Ejemplo de uso con Claude

Configurar el servidor MCP de Tally usando OAuth con Claude