Tally MCP Server

Proporciona a los asistentes de IA acceso seguro a las capacidades de gestión de formularios de Tally.

Documentación

Servidor MCP de Tally

Un servidor de Model Context Protocol (MCP) que brinda a los asistentes de IA acceso seguro a las capacidades de gestión de formularios de Tally.so.

¿Nuevo en Tally?

Usa la insignia de arriba para ahorrar 50% durante 3 meses.
Ganaré una pequeña comisión (sin costo adicional para ti) que ayuda a financiar el mantenimiento continuo de este proyecto de código abierto.

Acerca de

Servidor MCP de Tally lleva el poder de la gestión de formularios de Tally.so directamente a tu flujo de trabajo de IA. En lugar de cambiar de contexto entre tu asistente de IA y la interfaz web de Tally, simplemente describe lo que necesitas en lenguaje natural y deja que la IA maneje todas las interacciones con la API.

Por Qué Existe

La creación y gestión de formularios no debería interrumpir tu flujo. Ya seas un desarrollador creando formularios de prueba, un creador de contenido construyendo páginas de registro, o alguien que constantemente salta entre herramientas, este servidor MCP te mantiene en la conversación.

Características Clave

🎯 Gestión de Formularios en Lenguaje Natural

Crea formularios describiendo lo que necesitas: "Crea un formulario de admisión de clientes con nombre, correo electrónico y detalles del proyecto"
Actualiza formularios existentes sin abrir la interfaz de Tally
Clona formularios exitosos como plantillas para uso futuro

🛡️ Operaciones Masivas con Seguridad Primero

Elimina múltiples formularios usando coincidencia de patrones ("todos los formularios que comiencen con 'Prueba E2E'")
El flujo obligatorio de vista previa → confirmar → ejecutar previene accidentes
Controles de exclusión granulares ("elimina todos los formularios de prueba excepto estas 3 plantillas")

📊 Ciclo de Vida Completo del Formulario

Análisis de respuestas en tiempo real y tasas de finalización
Exporta envíos a CSV/JSON
Gestión de equipos y controles de permisos
Herramientas de organización del espacio de trabajo

⚡ Experiencia del Desarrollador

Construido en TypeScript con seguridad de tipos completa
Desplegado en Cloudflare Workers para velocidad global
90% de cobertura de pruebas
Funciona con Claude Desktop, Cursor, Windsurf y cualquier cliente compatible con MCP

Perfecto Para

Desarrolladores que crean muchos formularios de prueba y necesitan una limpieza fácil
Creadores de contenido que construyen formularios de registro para talleres y eventos
Equipos que gestionan múltiples proyectos de formularios en distintos espacios de trabajo
Cualquiera cansado de hacer clic en los constructores de formularios cuando podría simplemente describir lo que quiere

Transforma la gestión de formularios de una tarea que interrumpe el contexto a una parte fluida de tu flujo de trabajo impulsado por IA.

🚀 Inicio Rápido

Paso 0 – Crea una cuenta de Tally con descuento (opcional)

Si aún no tienes una cuenta de Tally, aprovecha el descuento del 50% para constructores antes de continuar. Apoyarás este repositorio mientras ahorras dinero: ¡todos ganan!

Opción 1: Integración con Claude.ai (Recomendada)

Usa el paquete probado en batalla mcp-remote:

Configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tally-remote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://tally-mcp.focuslab.workers.dev/mcp",
        "--header",
        "Authorization: Bearer YOUR_AUTH_TOKEN"
      ]
    }
  }
}

Reemplaza YOUR_AUTH_TOKEN con tu token de autenticación personal del servidor.

Opción 2: Integración Directa (Cursor, etc.)

Para clientes que admiten encabezados personalizados:

{
  "mcpServers": {
    "tally": {
      "url": "https://tally-mcp.focuslab.workers.dev/mcp",
      "transport": "http-stream",
      "headers": {
        "Authorization": "Bearer YOUR_AUTH_TOKEN"
      }
    }
  }
}

Opción 3: Proxy Local (Alternativa)

Si prefieres una solución personalizada:

Inicia el proxy local:
```
npm run proxy
```
Configura Claude.ai:
- URL del servidor: http://localhost:3001/mcp
- Transporte: http-stream
- Autenticación: Ninguna

🔧 Configuración

El servidor usa tu token de autenticación personal para acceder de forma segura a tus datos de Tally.

Variables de Entorno Requeridas:

TALLY_API_KEY: Tu clave de API de Tally (configurada en Cloudflare Workers)
AUTH_TOKEN: Token de autenticación del servidor (configurado en Cloudflare Workers)

🛡️ Seguridad

✅ Autenticación a nivel de servidor: Solo usuarios autorizados pueden acceder a tus datos
✅ Puente seguro: mcp-remote maneja la autenticación de forma transparente
✅ Transporte cifrado: Todas las comunicaciones usan HTTPS
✅ Autenticación basada en tokens: Enfoque estándar de la industria con tokens Bearer

🛠️ Herramientas Disponibles

create_form: Crea nuevos formularios de Tally con campos personalizados
modify_form: Actualiza configuraciones de formularios existentes
get_form: Obtén información detallada del formulario
list_forms: Explora todos tus formularios
delete_form: Elimina formularios que ya no necesitas
get_submissions: Accede a los datos de envíos de formularios
analyze_submissions: Obtén información de las respuestas de formularios
share_form: Genera enlaces para compartir y códigos de inserción
manage_workspace: Maneja la configuración del espacio de trabajo
manage_team: Gestión de miembros del equipo y permisos

📱 Soporte Multi-Cliente

Clientes MCP Compatibles:

✅ Claude.ai (a través de mcp-remote)
✅ Cursor (autenticado directamente o a través de mcp-remote)
✅ Windsurf (a través de mcp-remote)
✅ Cualquier cliente MCP que admita transporte HTTP Stream

🔄 Desarrollo

Desarrollo Local

npm install
npm run dev

Pruebas

npm test
npm run test:coverage

Integración Continua

En tu CI (por ejemplo, GitHub Actions), ejecuta:

npm ci
npm run test:coverage

Jest aplica un umbral de cobertura >90% a través de jest.config.js, lo que hace que la compilación falle si la cobertura está por debajo de este nivel.

Despliegue

npm run build:worker
npx wrangler deploy

📚 Documentación

Protocolo MCP: Model Context Protocol
API de Tally: Documentación para Desarrolladores de Tally
Cloudflare Workers: Documentación de Workers
mcp-remote: Paquete NPM

🤝 Contribuciones

Haz un fork del repositorio
Crea una rama de características
Realiza tus cambios
Agrega pruebas
Envía una solicitud de extracción

📄 Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.

Construido por Chris Cameron • LearnWith.cc