Tally

oficial

Criar e editar formulários Tally e analisar envios

O que você pode fazer com Tally MCP?

  • Criar formulários a partir de uma descrição — Peça ao assistente para criar um novo formulário, como um formulário de contato simples, que é salvo como rascunho privado até que você o publique.
  • Editar formulários existentes — Solicite alterações em um formulário por URL, como remover um campo, adicionar um captcha ou tornar um campo opcional.
  • Publicar formulários — Peça ao assistente para publicar um formulário em rascunho quando estiver pronto para compartilhá-lo.
  • Buscar envios de formulários — Recupere envios de um formulário, opcionalmente filtrados por status e intervalo de datas, com rótulos de perguntas e dados de resposta.
  • Listar e filtrar formulários — Liste formulários em todos os seus workspaces acessíveis e filtre por nome, status ou recência.

Documentação

Servidor MCP

Crie formulários Tally e liste formulários ou envios usando assistentes de IA por meio do Model Context Protocol

[!WARNING]

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 Tally e recupere formulários ou envios usando linguagem natural por meio 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 oferece suporte a 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 oferecem suporte à autenticação OAuth para servidores MCP, permitindo que você se conecte com apenas alguns cliques, sem gerenciar chaves de API manualmente.

Quando seu assistente de IA solicitar autenticação OAuth:

  1. Clique no botão de conexão ou no link de autorização
  2. Faça login na sua conta Tally (se ainda não estiver conectado)
  3. Autorize a conexão
  4. 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 o Claude Desktop e o claude.ai, e se aplica a todos os aplicativos Claude que oferecem suporte a conectores, incluindo Claude Chat, Claude Code e Claude Cowork.

  1. Abra o Claude Desktop (ou o claude.ai no seu navegador) e navegue até Customize > Connectors > Add custom connector na barra lateral à esquerda.

    Claude connectors

  2. Dê um nome ao conector e informe a URL do servidor MCP do Tally.

https://api.tally.so/mcp
  1. Clique em "Add" para salvar o conector.

    Add Tally MCP connector

  2. Reinicie o Claude Desktop

  3. Na primeira vez que você 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 na primeira vez que você usar o servidor MCP do Tally. Você pode verificar a conexão executando o comando /mcp dentro do Claude Code.

Cursor

  1. Abra Cursor Settings > Tools & MCP
  2. Clique em New MCP Server
  3. 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"
      }
    }
  }
}

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 os 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 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 o formulário corretamente. Toda alteração é salva imediatamente.

Criando um formulário com campos específicos

Como alternativa, 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 em rascunho com os campos especificados. Peça a ele 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 publicado, as alterações em perguntas e conteúdo (incluindo o logotipo, a imagem de capa e o 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 envios de formulários

Você pode buscar envios 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á 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 todos os 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á os formulários correspondentes com detalhes importantes, como nome do formulário, URL, status e data da última atualização.

Exemplo de uso com o Claude

Exemplo de uso do Tally MCP

Configurando o servidor MCP do Tally usando OAuth com o Claude

Configuração OAuth do Tally MCP

Esta documentação é criada e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.