Tally MCP Server

Fornece a assistentes de IA acesso seguro às capacidades de gerenciamento de formulários do Tally.

Documentação

Servidor MCP Tally

Um servidor Model Context Protocol (MCP) que fornece a assistentes de IA acesso seguro aos recursos de gerenciamento de formulários do Tally.so.

Novo no Tally?

Use o selo acima para economizar 50% por 3 meses.
Ganharei uma pequena comissão (sem custo adicional para você) que ajuda a financiar a manutenção contínua deste projeto de código aberto.

Sobre

Servidor MCP Tally traz o poder do gerenciamento de formulários do Tally.so diretamente para o seu fluxo de trabalho de IA. Em vez de alternar entre seu assistente de IA e a interface web do Tally, basta descrever o que você precisa em linguagem natural e deixar a IA lidar com todas as interações com a API.

Por que Isso Existe

A criação e o gerenciamento de formulários não devem interromper seu fluxo. Seja você um desenvolvedor criando formulários de teste, um criador de conteúdo construindo páginas de registro ou qualquer pessoa que se veja constantemente alternando entre ferramentas, este servidor MCP mantém você na conversa.

Principais Recursos

🎯 Gerenciamento de Formulários em Linguagem Natural

Crie formulários descrevendo o que você precisa: "Crie um formulário de captação de clientes com nome, e-mail e detalhes do projeto"
Atualize formulários existentes sem abrir a interface do Tally
Clone formulários bem-sucedidos como modelos para uso futuro

🛡️ Operações em Massa com Segurança em Primeiro Lugar

Exclua vários formulários usando correspondência de padrões ("todos os formulários que começam com 'Teste E2E'")
Fluxo obrigatório de pré-visualização → confirmação → execução previne acidentes
Controles granulares de exclusão ("exclua todos os formulários de teste, exceto estes 3 modelos")

📊 Ciclo de Vida Completo do Formulário

Análises de respostas em tempo real e taxas de conclusão
Exporte envios para CSV/JSON
Gerenciamento de equipe e controles de permissão
Ferramentas de organização do espaço de trabalho

⚡ Experiência do Desenvolvedor

Construído em TypeScript com segurança total de tipos
Implantado no Cloudflare Workers para velocidade global
90% de cobertura de testes
Funciona com Claude Desktop, Cursor, Windsurf e qualquer cliente compatível com MCP

Perfeito Para

Desenvolvedores que criam muitos formulários de teste e precisam de limpeza fácil
Criadores de conteúdo que constroem formulários de registro para workshops e eventos
Equipes que gerenciam múltiplos projetos de formulários em espaços de trabalho
Qualquer pessoa cansada de clicar em construtores de formulários quando poderia simplesmente descrever o que deseja

Transforme o gerenciamento de formulários de uma tarefa que interrompe o contexto em uma parte integrada do seu fluxo de trabalho com IA.

🚀 Início Rápido

Etapa 0 – Crie uma conta Tally com desconto (opcional)

Se você ainda não tem uma conta Tally, aproveite o desconto de 50% para criadores antes de continuar. Você apoiará este repositório enquanto economiza dinheiro—vantagem dupla!

Opção 1: Integração com Claude.ai (Recomendada)

Use o pacote testado em batalha mcp-remote:

Configuração do 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"
      ]
    }
  }
}

Substitua YOUR_AUTH_TOKEN pelo seu token de autenticação pessoal do servidor.

Opção 2: Integração Direta (Cursor, etc.)

Para clientes que suportam cabeçalhos personalizados:

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

Opção 3: Proxy Local (Alternativa)

Se você preferir uma solução personalizada:

Inicie o proxy local:
```
npm run proxy
```
Configure o Claude.ai:
- URL do servidor: http://localhost:3001/mcp
- Transporte: http-stream
- Autenticação: Nenhuma

🔧 Configuração

O servidor usa seu token de autenticação pessoal para acessar com segurança seus dados do Tally.

Variáveis de Ambiente Necessárias:

TALLY_API_KEY: Sua chave de API do Tally (configurada no Cloudflare Workers)
AUTH_TOKEN: Token de autenticação do servidor (configurado no Cloudflare Workers)

🛡️ Segurança

✅ Autenticação em nível de servidor: Somente usuários autorizados podem acessar seus dados
✅ Ponte segura: mcp-remote lida com a autenticação de forma transparente
✅ Transporte criptografado: Todas as comunicações usam HTTPS
✅ Autenticação baseada em token: Abordagem padrão da indústria com token Bearer

🛠️ Ferramentas Disponíveis

create_form: Crie novos formulários Tally com campos personalizados
modify_form: Atualize configurações de formulários existentes
get_form: Obtenha informações detalhadas do formulário
list_forms: Navegue por todos os seus formulários
delete_form: Remova formulários que você não precisa mais
get_submissions: Acesse dados de envios de formulários
analyze_submissions: Obtenha insights das respostas dos formulários
share_form: Gere links de compartilhamento e códigos de incorporação
manage_workspace: Gerencie configurações do espaço de trabalho
manage_team: Gerenciamento de membros da equipe e permissões

📱 Suporte a Múltiplos Clientes

Clientes MCP Suportados:

✅ Claude.ai (via mcp-remote)
✅ Cursor (autenticado diretamente ou via mcp-remote)
✅ Windsurf (via mcp-remote)
✅ Qualquer cliente MCP que suporte transporte HTTP Stream

🔄 Desenvolvimento

Desenvolvimento Local

npm install
npm run dev

Testes

npm test
npm run test:coverage

Integração Contínua

No seu CI (por exemplo, GitHub Actions), execute:

npm ci
npm run test:coverage

O Jest aplica um limite de cobertura >90% via jest.config.js, fazendo com que o build falhe se a cobertura estiver abaixo desse nível.

Implantação

npm run build:worker
npx wrangler deploy

📚 Documentação

Protocolo MCP: Model Context Protocol
API Tally: Documentação para Desenvolvedores Tally
Cloudflare Workers: Documentação do Workers
mcp-remote: Pacote NPM

🤝 Contribuindo

Faça um fork do repositório
Crie um branch de funcionalidade
Faça suas alterações
Adicione testes
Envie um pull request

📄 Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

Construído por Chris Cameron • LearnWith.cc