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

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](/pt/docs/mcp/), 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](https://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

**ChatGPT**

  Abra **Plugins**, pesquise **Emailit** e escolha **Connect**. Faça login, escolha os workspaces que serão permitidos e aprove o acesso. Consulte [ChatGPT](/pt/docs/mcp/chatgpt/).

**Codex**

```bash
codex plugin marketplace add emailit/emailit-plugins
```

  Abra `/plugins`, instale o **Emailit** e faça login quando for solicitado. Consulte [Codex](/pt/docs/mcp/codex/).

**Claude Code**

```bash
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](/pt/docs/mcp/claude/).

**Cursor**

  Instale o **Emailit** pelo Cursor Marketplace ou com `/add-plugin emailit` e depois escolha **Connect** ao lado de **emailit** em **Settings > MCP**. Consulte [Cursor](/pt/docs/mcp/cursor/).

**Grok**

```bash
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](/pt/docs/mcp/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 **Account → Connected 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](/pt/docs/mcp/tools/) desta documentação, então os nomes de ferramentas nas skills sempre existem no servidor.

---
Fonte: https://emailit.com/pt/docs/mcp/plugins-and-skills/