# Servidor MCP do Tellnod

> O Tellnod é um servidor MCP remoto de e-mail marketing em `https://mcp.tellnod.com/mcp`: usa Streamable HTTP com OAuth 2.1, oferece ferramentas para marca, contatos, segmentos, rascunhos, pré-visualizações, envios e resultados, e mostra cards interativos nos clientes compatíveis com MCP Apps.

Canonical: https://tellnod.com/pt-BR/mcp-server  
Last updated: 2026-10-17  
Author: Tellnod team

## Endpoint e transporte

- **Endereço:** `https://mcp.tellnod.com/mcp`
- **Transporte:** Streamable HTTP. Não há nada para instalar nem executar no seu computador.
- **Clientes:** Claude (conector personalizado) e ChatGPT (servidor MCP personalizado). Passo a passo de configuração: [Conectar](https://tellnod.com/pt-BR/connect).
- **Cards interativos:** nos clientes compatíveis com MCP Apps, as ferramentas anexam um card `ui://tellnod/…`; os demais clientes recebem o mesmo resultado como texto.

## Autenticação

O login usa OAuth 2.1 com registro dinâmico de clientes: os clientes se registram sozinhos e você entra com sua conta Google no navegador. Os tokens de acesso ficam vinculados ao endereço do servidor MCP e são recusados em qualquer outro lugar.

Um cliente conectado pode ler e escrever rascunhos. **Enviar não é uma permissão do OAuth.** Para agendar um envio, uma pessoa precisa clicar em Confirm no card ou na página de confirmação na web, então um token sozinho nunca consegue enviar e-mails.

## Ferramentas

Cada ferramenta declara `readOnlyHint`, `destructiveHint`, `idempotentHint` e `openWorldHint`, para que o cliente mostre quais chamadas alteram dados.

### Somente leitura

- `get_workspace`, `get_overview`: conta, plano, limites e próximos passos.
- `fetch_brand`: lê o logo, as cores e as fontes do seu site.
- `search_contacts`, `get_contact`, `list_segments`, `estimate_audience`: encontram pessoas e estimam o tamanho de um público antes de salvá-lo.
- `render_preview`, `preview_inbox`, `preview_channels`, `list_templates`: o e-mail real, a linha na caixa de entrada e modelos para começar.
- `check_domain`: status do DNS do seu domínio de envio.
- `get_send`, `list_sends`, `get_campaign_results`, `compare_campaigns`: status e resultados dos envios.

### Escrita

- `save_brand`, `confirm_brand`: salvam a marca usada em todos os e-mails.
- `import_contacts`, `tag_contacts`, `create_segment`: contatos com status de consentimento e públicos salvos.
- `create_message_draft`, `update_message_draft`, `apply_template`: escrevem e revisam o e-mail.
- `add_domain`, `remove_domain`: envie a partir do seu próprio domínio.
- `send_test`: um e-mail de teste para você (até 20 por dia).
- `prepare_send`, `prepare_resend`: fixam os destinatários e mostram o card de confirmação.
- `cancel_send`: cancela um envio agendado.

> `confirm_send` só é visível para o card, não para o modelo, então o assistente não consegue concluir um envio sozinho.

## O envio em duas etapas

1. `prepare_send` fixa a lista de destinatários e devolve uma confirmação vinculada ao espaço de trabalho, à pessoa, à mensagem e a essa lista exata.
2. O card de confirmação mostra o número de destinatários, quem foi excluído e por quê, o horário de envio e a checklist de conformidade legal.
3. Clicar em Confirm agenda o envio. A confirmação é de uso único e expira em 30 minutos; preparar o envio de novo gera uma nova.
4. “Enviar agora” aguarda 5 minutos, e qualquer envio agendado pode ser cancelado até que saia.

## Limites e proteções

- Domínio de envio compartilhado (um endereço como hello@yourshop.tellnodmail.com): até 500 destinatários por campanha e 1.000 e-mails por mês. Com o seu próprio domínio verificado, esses limites deixam de valer.
- Plano Free: 500 contatos e 2.000 e-mails por mês.
- Os envios são pausados automaticamente com uma taxa de reclamações de 0,1% ou uma taxa de devolução de 2%.
- Toda campanha inclui links de descadastro, cabeçalhos de descadastro com um clique e um endereço postal.

## Ferramentas de WhatsApp e LINE

As ferramentas de WhatsApp e LINE usam os mesmos contatos, a mesma pré-visualização e o mesmo envio em duas etapas, e aparecem na lista de ferramentas quando o seu acesso a cada canal é liberado. WhatsApp e LINE aceitam pedidos de acesso antecipado. Veja [servidor MCP para LINE](https://tellnod.com/pt-BR/line-mcp-server).

## FAQ

### O servidor MCP do Tellnod é de código aberto?

O servidor é um serviço hospedado. O renderizador de pré-visualizações de e-mail, `preview-kit`, está previsto para ser publicado como pacote de código aberto.

### Posso usar a partir do meu próprio cliente MCP?

Qualquer cliente compatível com servidores MCP remotos via Streamable HTTP com login OAuth pode se conectar. Os cards só aparecem nos clientes compatíveis com MCP Apps.

### Uma chave de API pode enviar e-mails pelo servidor MCP?

Não. Não existem chaves de API com permissão de envio; todo envio exige que uma pessoa clique em Confirm.