# Servidor MCP do Emailit

> Conecte ChatGPT, Claude, Cursor, Codex, Grok e outras ferramentas de IA ao Emailit com o servidor MCP hospedado, login via OAuth e toda a API v2 como ferramentas.

O servidor MCP do Emailit conecta assistentes de IA à sua conta do Emailit pelo [Model Context Protocol](https://modelcontextprotocol.io). Peça em linguagem natural para enviar um e-mail, adicionar e verificar um domínio, descobrir por que uma mensagem deu bounce, montar uma lista de contatos ou lançar uma campanha, e o assistente chama a ferramenta correspondente do Emailit.

O Emailit hospeda o servidor. Não há nada para instalar nem chave de API para colar: você faz login no Emailit no navegador, escolhe os workspaces que o assistente pode usar e aprova o acesso.

| | |
| --- | --- |
| **URL do servidor** | `https://api.emailit.com/mcp` |
| **Transporte** | Streamable HTTP (sem estado, `POST`) |
| **Login** | OAuth 2.1 com PKCE ou uma chave de API como bearer token |
| **Ferramentas** | 109, cobrindo toda a API v2 |
| **Descoberta** | `https://api.emailit.com/.well-known/oauth-protected-resource/mcp` |

## Conectar a sua ferramenta de IA

| Cliente | Como conectar | Guia |
| --- | --- | --- |
| ChatGPT | Plugin do Emailit | [ChatGPT](/pt/docs/mcp/chatgpt/) |
| Claude (claude.ai, Desktop e celular) | Conector do Emailit | [Claude](/pt/docs/mcp/claude/) |
| Claude Code | Plugin do Emailit ou `claude mcp add` | [Claude Code](/pt/docs/mcp/claude/#claude-code) |
| Cursor | Plugin do Emailit ou **Add to Cursor** | [Cursor](/pt/docs/mcp/cursor/) |
| Codex | Plugin do Emailit ou `codex mcp add` | [Codex](/pt/docs/mcp/codex/) |
| Grok | Conector do grok.com, plugin do Grok Build ou a API da xAI | [Grok](/pt/docs/mcp/grok/) |
| VS Code, Windsurf, Zed e outros | URL do servidor MCP remoto | [Outros clientes](/pt/docs/mcp/other-clients/) |

Em qualquer outro cliente MCP, adicione um servidor remoto (Streamable HTTP) com a URL `https://api.emailit.com/mcp`. Os clientes compatíveis com a autorização do MCP encontram o login automaticamente pela URL de descoberta acima, então a URL é tudo de que eles precisam.

Os [plugins do Emailit](/pt/docs/mcp/plugins-and-skills/) para ChatGPT, Codex, Claude Code, Cursor e Grok adicionam skills ao servidor: orientações que ensinam o assistente a configurar domínios, corrigir problemas de entregabilidade, executar campanhas, verificar webhooks e escolher um SDK.

## O que acontece quando você se conecta

1. **Faça login.** A sua ferramenta de IA abre uma página de login do Emailit. Digite o seu e-mail e a sua senha e, se você usa autenticação de dois fatores, o código do app autenticador.

2. **Escolha os workspaces.** Escolha **All my workspaces**, que inclui os workspaces que você criar ou em que entrar depois, ou **Only these workspaces** com os que você marcar. Se você permitir mais de um, escolha aquele por onde a ferramenta começa.

3. **Permita o acesso.** Revise o acesso que a ferramenta solicita (`sending` ou `full`) e selecione **Allow access**.

A ferramenta recebe um token de acesso que dura 15 minutos e um token de atualização que a mantém conectada por até 60 dias de inatividade. Os tokens de atualização mudam a cada uso, e reutilizar um token antigo revoga a conexão. Todas as conexões aparecem em **Account → Connected apps**.

## Vários workspaces

Uma conexão cobre todos os workspaces que você permitiu, então você pode gerenciar várias marcas ou contas de clientes no mesmo chat. Cite o workspace no pedido:

> “No Acme Client, liste os domínios.”

O assistente passa `workspace: "Acme Client"` apenas para essa chamada de ferramenta. Ele aceita um ID de workspace ou o nome exato do workspace e não altera o workspace padrão da conexão, então dois chats trabalhando em workspaces diferentes ao mesmo tempo não atrapalham um ao outro.

- “Quais workspaces do Emailit você pode usar?” lista os workspaces permitidos e o seu papel em cada um.
- “Mude para o meu workspace Marketing” altera o padrão para os próximos pedidos que não citarem um workspace.
- Para adicionar ou remover workspaces, abra **Account → Connected apps** e escolha **Edit access**. As alterações valem a partir da próxima requisição do app, sem reconectar.
- Se você sair de um workspace ou alguém remover você, o app também perde o acesso a ele.

A ferramenta trabalha com o seu papel em cada workspace, como no painel: membros com o papel Member não podem gerenciar chaves de API nem excluir domínios. Consulte [Workspaces e permissões](/pt/docs/mcp/workspaces-and-permissions/).

## Níveis de acesso

| Escopo | O que a ferramenta pode fazer |
| --- | --- |
| `sending` | Enviar, agendar, reagendar, cancelar, tentar de novo e encaminhar e-mails. Consultar e trocar de workspace. |
| `full` | Tudo da API v2: domínios, relatórios DMARC, templates, chaves de API, listas de contatos, contatos, supressões, webhooks, campanhas, automações, formulários, verificação de e-mails, eventos e criação de workspaces. |

A maioria das ferramentas de IA pede os dois escopos. Se uma conexão sem `full` chamar uma ferramenta que precisa dele, a ferramenta retorna um erro pedindo que você reconecte com acesso total. Os clientes compatíveis com autorização incremental (step-up), como o ChatGPT, mostram de novo a tela de aprovação.

## Reduzir a lista de ferramentas

Alguns clientes limitam quantas ferramentas carregam. Adicione estas opções à URL do servidor, ou envie-as como cabeçalhos, para expor menos ferramentas:

| Opção | Query | Cabeçalho | Exemplo |
| --- | --- | --- | --- |
| Apenas alguns toolsets | `?toolsets=` | `X-MCP-Toolsets` | `emails,domains,events` |
| Ocultar as ferramentas de escrita | `?read_only=true` | `X-MCP-Readonly` | `true` |

Por exemplo, `https://api.emailit.com/mcp?toolsets=emails,domains&read_only=true` dá ao assistente acesso de leitura apenas a e-mails e domínios. As ferramentas de workspace são sempre incluídas. Consulte [Toolsets e modo somente leitura](/pt/docs/mcp/toolsets/) para ver a lista completa.

## Usar uma chave de API

Servidores, scripts, jobs de CI e agentes headless não conseguem abrir um navegador para fazer login. [Crie uma chave de API](/pt/docs/developers/api-keys/) e envie-a como bearer token:

```json title="mcp.json"
{
  "mcpServers": {
    "emailit": {
      "url": "https://api.emailit.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}
```

Uma chave de API fica vinculada ao workspace em que foi criada e não acessa outros workspaces, e o servidor só lista as ferramentas que o escopo da chave permite. Prefira OAuth em apps de desktop e de chat, porque uma chave salva em um arquivo de configuração pode vazar.

## Desconectar um app

Abra **Account → Connected apps**. A página lista todas as ferramentas de IA e apps que você aprovou, com os workspaces que cada um pode usar, o nível de acesso e quando se conectou. Escolha **Edit access** para alterar os workspaces ou **Revoke access** para cortar o acesso: os tokens param de funcionar imediatamente. Consulte [Apps conectados](/pt/docs/account/connected-apps/).

> **Atenção:** Remover o servidor da sua ferramenta de IA não revoga o acesso dela no Emailit. Use **Connected apps** para isso.

## Segurança

- **Ferramentas rotuladas.** Toda ferramenta traz anotações MCP (somente leitura, destrutiva, mundo aberto), para que os clientes possam perguntar antes de executar qualquer coisa que escreva, exclua ou acesse o mundo externo.
- **Instruções embutidas.** O servidor orienta os assistentes a confirmar destinatários, remetente e conteúdo antes de enviar e-mails reais, a buscar os IDs em vez de adivinhá-los e a perguntar antes de excluir ou cancelar qualquer coisa.
- **Conteúdo não confiável.** Corpos de e-mails, campos de contatos e respostas de formulários podem conter texto escrito por outras pessoas. Revise o que o assistente pretende fazer antes de aprovar um envio ou uma exclusão.
- **Verificações de rede.** As URLs de webhook são verificadas para que as requisições não alcancem redes privadas.
- **O seu papel vale.** Os assistentes nunca podem fazer mais do que você em cada workspace.
- **As chaves ficam fora do código.** Nunca faça commit de chaves de API; a regra do Cursor no plugin do Emailit alerta o agente sobre isso.

## Próximos passos

  - [Referência de ferramentas](/pt/docs/mcp/tools/): Todas as ferramentas, com tipo, escopo e argumentos.
  - [Plugins e skills](/pt/docs/mcp/plugins-and-skills/): O que os plugins do Emailit adicionam em cada cliente.
  - [Workspaces e permissões](/pt/docs/mcp/workspaces-and-permissions/): Acesso aos workspaces, papéis, escopos e tokens.
  - [Solução de problemas](/pt/docs/mcp/troubleshooting/): Corrija problemas de login, de escopo, de workspace e de carregamento de ferramentas.

---
Fonte: https://emailit.com/pt/docs/mcp/