Referência

Plugins e skills do Emailit

O plugin oficial do Emailit para ChatGPT, Codex, Claude Code, Cursor e Grok reúne o servidor MCP hospedado, skills e uma regra que mantém os segredos fora do código.

Atualizado em 2 de out. de 2026

O plugin do Emailit reúne tudo o que um assistente de IA precisa para trabalhar com o Emailit: uma conexão com o servidor MCP hospedado, skills que ensinam ao assistente como o Emailit funciona e uma regra do Cursor para o manuseio seguro de segredos. Ele é de código aberto e está em github.com/emailit/emailit-plugins (MIT).

Você faz login com a sua conta do Emailit via OAuth e escolhe quais workspaces o plugin pode usar: todos ou apenas os que você selecionar. Nenhuma chave de API fica guardada no plugin.

O que está incluído

Parte	O que faz
Servidor MCP	`https://api.emailit.com/mcp`, com 109 ferramentas para e-mails, domínios, DMARC, templates, listas de contatos, contatos, supressões, campanhas, automações, formulários, verificação, webhooks, eventos, chaves de API e workspaces
Skill `emailit`	Escolha entre as ferramentas MCP e a API REST, envio seguro, IDs, paginação, erros e a lista completa de ferramentas
Skill `emailit-get-started`	Conectar, confirmar o workspace, conferir um domínio e enviar um primeiro e-mail de teste
Skill `emailit-domain-setup`	Adicionar um domínio, publicar os registros DNS em qualquer provedor, verificar e corrigir registros com falha
Skill `emailit-deliverability`	Bounces, chegada à pasta de spam, supressões, relatórios DMARC e verificação de listas, respondidos com dados da sua conta
Skill `emailit-campaigns`	Listas de contatos, contatos, campanhas, automações e formulários de inscrição, com envio seguro
Skill `emailit-webhooks`	Eventos, filtros, verificação de assinaturas, payloads em lote, novas tentativas e depuração
Skill `emailit-sdk`	Código de produção para os SDKs de Node.js, Python, PHP, Laravel, Go, Ruby, Java, .NET e Rust, além de SMTP
Regra do Cursor	Mantém as chaves de API do Emailit (`secret_…`) e os segredos de webhook (`whsec_…`) fora do código-fonte e os lê de `EMAILIT_API_KEY` e `EMAILIT_WEBHOOK_SECRET`

As skills são carregadas sob demanda: o assistente lê uma skill quando o seu pedido corresponde a ela; por exemplo, “por que o meu e-mail deu bounce” carrega emailit-deliverability.

Instalação

Abra Plugins, pesquise Emailit e escolha Connect. Faça login, escolha os workspaces que serão permitidos e aprove o acesso. Consulte ChatGPT.

Terminal

codex plugin marketplace add emailit/emailit-plugins

Abra /plugins, instale o Emailit e faça login quando for solicitado. Consulte Codex.

Terminal

claude plugin marketplace add emailit/emailit-plugins
claude plugin install emailit@emailit-plugins

Execute /mcp, selecione emailit e escolha Authenticate. No claude.ai, no Claude Desktop e no celular, use o conector do Emailit. Consulte Claude.

Instale o Emailit pelo Cursor Marketplace ou com /add-plugin emailit e depois escolha Connect ao lado de emailit em Settings > MCP. Consulte Cursor.

Terminal

grok plugin marketplace add emailit/emailit-plugins
grok plugin install emailit --trust

No grok.com, adicione um conector personalizado com https://api.emailit.com/mcp. Consulte Grok.

Acesso e segurança

OAuth 2.1 com PKCE. O assistente nunca vê a sua senha. Você aprova o acesso sending (enviar e gerenciar os e-mails enviados) ou o acesso full (tudo) e escolhe os workspaces.
Confirmação antes de qualquer impacto. As ferramentas que enviam e-mails, excluem dados ou chamam URLs externas são rotuladas para que o cliente pergunte a você antes, e as skills orientam o assistente a pedir confirmação.
Revogue a qualquer momento em AccountConnected apps.
Clientes headless, como a API da xAI e jobs de CI, podem enviar uma chave de API do Emailit como Authorization: Bearer <key> para o mesmo servidor. Use uma chave Sending Only sempre que possível.

Endpoints que o plugin usa

O plugin se comunica apenas com o Emailit:

Endpoint	Finalidade
`https://api.emailit.com/mcp`	Servidor MCP hospedado (Streamable HTTP)
`https://api.emailit.com/.well-known/oauth-protected-resource/mcp`	Metadados do recurso protegido OAuth
`https://api.emailit.com/.well-known/oauth-authorization-server`	Metadados do servidor de autorização OAuth
`https://api.emailit.com/oauth/register`	Registro dinâmico de clientes
`https://api.emailit.com/oauth/authorize`	Login e consentimento
`https://api.emailit.com/oauth/token`	Troca e atualização de tokens
`https://api.emailit.com/oauth/revoke`	Revogação de tokens
`https://api.emailit.com/v2`	API REST, usada pelo código que a skill de SDK escreve no seu projeto
`smtp.emailit.com:587`	SMTP, apenas se o seu projeto estiver configurado para usá-lo

Manifestos

O repositório traz um manifesto por cliente:

Arquivo	Lido por
`plugin.json`, `mcp.json`	ChatGPT, Codex e outros clientes de Agent Plugins
`.cursor-plugin/`	Cursor
`.claude-plugin/`, `.mcp.json`	Claude Code, o diretório do Claude e Grok
`.grok-plugin/plugin.json`	Grok
`.agents/plugins/marketplace.json`	O marketplace do Codex

A referência de ferramentas das skills é gerada a partir do catálogo de ferramentas do servidor MCP, a mesma fonte da referência de ferramentas desta documentação, então os nomes de ferramentas nas skills sempre existem no servidor.