Servidor MCP do Emailit

O servidor MCP do Emailit conecta assistentes de IA à sua conta do Emailit pelo Model Context Protocol. 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.

Conectar a sua ferramenta de IA

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 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.

Níveis de acesso

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:

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 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 e envie-a como bearer token:

{
  "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.

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