Tally MCP Server
oficialCriar e editar formulários Tally e analisar envios
Documentação
Servidor MCP
Crie formulários do Tally e liste formulários ou envios usando assistentes de IA através do Model Context Protocol
O servidor MCP do Tally está atualmente em beta e sujeito a alterações.
O que é MCP?
O Model Context Protocol (MCP) permite que você crie formulários do Tally e recupere formulários ou envios usando linguagem natural através de assistentes de IA como o Claude.
URL do Servidor
O servidor MCP do Tally está disponível em:
https://api.tally.so/mcp
Autenticação
O servidor MCP do Tally suporta dois métodos de autenticação:
Opção 1: OAuth (Recomendado)
A maneira mais fácil de conectar é através de 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 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á automaticamente a conexão
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 o 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 informe a URL do servidor MCP do Tally.
https://api.tally.so/mcp
- Clique em "Adicionar" para salvar o conector.
- Reinicie o Claude Desktop
- Na primeira vez que usar o servidor MCP do Tally, o Claude abrirá um fluxo OAuth para autenticar com sua conta Tally.
Claude Code CLI
Para conectar o Claude Code ao servidor MCP do 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 do 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 do Tally:
{
"mcpServers": {
"tally": {
"url": "https://api.tally.so/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}
Exemplos de Uso
Uma vez 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, baseado em seu entendimento do que um formulário de contato típico deve incluir.
Atualizando o Formulário de Contato
Se o formulário gerado não for exatamente o que você queria, você pode modificá-lo facilmente fazendo um acompanhamento:
We don't need the Company field, remove the consent checkbox and maybe add a captcha
O assistente de IA deve modificar corretamente o formulário e salvá-lo.
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 com os campos especificados e salvá-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, fazer as alterações solicitadas e salvar a versão atualizada.
Buscando envios de formulário
Você pode buscar envios de qualquer formulário, com filtros opcionais para 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á os envios correspondentes ao 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 recenticidade:
Show my 10 most recently updated published forms
O assistente de IA chamará a ferramenta MCP de listar formulários e retornará os formulários correspondentes com detalhes chave como nome do formulário, URL, status e data da última atualização.