Tally
oficialCriar e editar formulários Tally e analisar envios
O que você pode fazer com Tally MCP?
- Criar formulários a partir de linguagem natural — Peça ao seu assistente para criar um formulário de contato com os campos que você especificar, e ele gerará um rascunho privado.
- Editar formulários existentes — Solicite alterações como remover campos ou adicionar um captcha a um formulário compartilhando sua URL.
- Publicar ou atualizar formulários ao vivo — Peça para publicar um rascunho ou fazer alterações em perguntas e conteúdo de um formulário publicado que permanecem não publicadas até você aprovar.
- Buscar envios de formulários — Peça os envios concluídos de uma URL de formulário, opcionalmente filtrados por status ou intervalo de datas.
- Listar e filtrar formulários — Peça para ver seus formulários em todos os espaços de trabalho, filtrados por nome, status ou recência, com detalhes importantes como URL e data da última atualização.
Documentação
Servidor MCP
Crie formulários Tally e liste formulários ou respostas usando assistentes de IA por meio do Model Context Protocol
O servidor MCP Tally está atualmente em beta e sujeito a alterações.
O que é MCP?
O Model Context Protocol (MCP) permite que você crie formulários Tally e recupere formulários ou respostas usando linguagem natural por meio de assistentes de IA como o Claude.
URL do servidor
O servidor MCP Tally está disponível em:
https://api.tally.so/mcp
Autenticação
O servidor MCP Tally suporta dois métodos de autenticação:
Opção 1: OAuth (Recomendado)
A maneira mais fácil de conectar é por meio do OAuth. Muitos assistentes de IA suportam autenticação OAuth para servidores MCP, permitindo que você conecte com apenas alguns cliques sem gerenciar chaves de API manualmente.
Quando seu assistente de IA solicitar autenticação OAuth:
- Clique no botão de conectar ou no link de autorização
- Faça login na sua conta Tally (se ainda não estiver logado)
- Autorize a conexão
- O assistente de IA configurará a conexão automaticamente
Opção 2: Chave de API
Você também pode autenticar usando uma chave de API no cabeçalho Authorization:
Authorization: Bearer tly-xxxx
Saiba mais sobre como obter sua chave de API.
Configuração
Claude Desktop
Este método funciona para Claude Desktop e claude.ai, e se aplica a todos os aplicativos Claude que suportam conectores, incluindo Claude Chat, Claude Code e Claude Cowork.
- Abra o Claude Desktop (ou claude.ai no seu navegador) e navegue até Personalizar > Conectores > Adicionar conector personalizado na barra lateral esquerda.
- Dê um nome ao conector e a URL do servidor MCP Tally.
https://api.tally.so/mcp
- Clique em "Adicionar" para salvar o conector.
- Reinicie o Claude Desktop
- Na primeira vez que você usar o servidor MCP Tally, o Claude abrirá um fluxo OAuth para autenticar com sua conta Tally.
Claude Code CLI
Para conectar o Claude Code ao servidor MCP Tally, execute o seguinte comando no seu terminal:
claude mcp add tally --transport http https://api.tally.so/mcp
O Claude Code lidará com o fluxo OAuth automaticamente quando você usar o servidor MCP Tally pela primeira vez. Você pode verificar a conexão executando o comando /mcp dentro do Claude Code.
Cursor
- Abra Configurações do Cursor > Ferramentas e MCP
- Clique em Novo servidor MCP
- Cole o seguinte JSON para configurar o servidor MCP Tally:
{
"mcpServers": {
"tally": {
"url": "https://api.tally.so/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}
Exemplo de uso
Depois de configurado, você pode pedir ao seu assistente de IA para criar formulários usando linguagem natural. Aqui estão alguns exemplos:
Criando um formulário de contato simples
Create a simple contact form
O assistente de IA criará automaticamente um formulário de contato com campos comumente esperados, com base em seu entendimento do que um formulário de contato típico deve incluir. Novos formulários permanecem como rascunhos privados até que você peça ao assistente para publicá-los.
Atualizando o formulário de contato
Se o formulário gerado não for exatamente o que você queria, você pode modificá-lo facilmente com uma solicitação de acompanhamento:
We don't need the Company field, remove the consent checkbox and maybe add a captcha
O assistente de IA deve modificar o formulário corretamente. Cada alteração é salva imediatamente.
Criando um formulário com campos específicos
Alternativamente, você pode ser explícito sobre exatamente quais campos deseja:
Create a contact form with these specific fields:
- Name (required)
- Email (required)
- Phone (optional)
- Message (required)
- Captcha (required)
O assistente de IA deve criar um formulário de rascunho com os campos especificados. Peça para publicar o formulário quando quiser compartilhá-lo.
Atualizando um formulário existente
Update this form https://tally.so/r/a1B2c3
- Remove the phone number field
- Also add a captcha
- Make company field optional
O assistente de IA usará as ferramentas MCP para carregar seu formulário e fazer as alterações solicitadas. Em um formulário ativo, alterações em perguntas e conteúdo (incluindo logotipo, imagem de capa e texto do botão de envio) permanecem não publicadas até que você peça ao assistente para publicá-las, enquanto configurações e outros estilos são aplicados imediatamente.
Buscando respostas de formulários
Você pode buscar respostas de qualquer formulário, com filtros opcionais por status e intervalo de datas:
Show me all completed submissions for https://tally.so/r/a1B2c3 from January 2025
O assistente de IA buscará e exibirá as respostas correspondentes do seu formulário, incluindo rótulos de perguntas e dados de resposta.
Listando formulários
Você pode listar formulários em seus espaços de trabalho acessíveis e solicitar filtragem por nome, status ou recência:
Show my 10 most recently updated published forms
O assistente de IA chamará a ferramenta MCP de listagem de formulários e retornará formulários correspondentes com detalhes importantes, como nome do formulário, URL, status e data da última atualização.