Generator Labs

Monitoramento em tempo real e alertas para entregabilidade de e-mails, certificados SSL e configurações TLS.

Documentação

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem a sistemas externos e obtenham dados em tempo real em nome do usuário. A Generator Labs opera um servidor MCP hospedado para que qualquer ferramenta de IA compatível com MCP (Claude Desktop, ChatGPT, Cursor, GitHub Copilot e outras) possa ler seus dados de monitoramento de RBL e certificados, além de executar verificações sob demanda, sem que você precise escrever qualquer código de integração.

O Que Você Pode Fazer

Após a conexão, você pode pedir à sua ferramenta de IA coisas como:

  • "Quais dos meus hosts estão atualmente listados em alguma RBL?"
  • "Mostre-me certificados que expiram nos próximos 30 dias, agrupados por ambiente."
  • "Execute uma verificação de RBL em mail.example.com e me diga quais fontes o sinalizaram."
  • "Audite minha conta quanto à higiene de renovação de certificados nos últimos 90 dias."
  • "Quais alertas foram enviados esta semana e para quais contatos?"

A IA traduz a solicitação em uma ou mais chamadas de ferramenta na sua conta, retorna os resultados em formato conversacional e pode encadear perguntas de acompanhamento sem que você precise alternar de contexto para o portal.

Como Funciona

O endpoint MCP está hospedado em:

https://api.generatorlabs.com/4.0/mcp

Ele utiliza JSON-RPC 2.0 sobre HTTP Streamable, o transporte MCP padrão para servidores remotos. A autenticação usa uma das seguintes opções:

  • HTTP Basic com suas credenciais existentes de aplicação de API (Account SID + API key).
  • OAuth 2.1 com PKCE, incluindo Dynamic Client Registration (RFC 7591): o que a maioria das ferramentas de IA usa quando você clica em "Conectar" ou cola uma URL.

De qualquer forma, cada solicitação é executada contra a mesma aplicação de API por conta: seus limites de taxa e listas de permissão de IP existentes se aplicam, as concessões OAuth são vinculadas a uma aplicação de API específica escolhida no momento do consentimento, e você pode revogar o acesso a qualquer momento no Portal em Development ➡️ MCP OAuth.

mcp-1.png

Capacidades Disponíveis

O servidor atualmente expõe 21 ferramentas em quatro áreas:

ÁreaFerramentasEscopo necessário
Monitoramento de RBLListar/inspecionar hosts, mostrar listagens atuais, detalhar por fonte, executar verificações manuais, ver históricomcp:read, mcp:write
Monitoramento de certificadosListar/inspecionar monitores, encontrar certificados expirando ou com erros recentes, consultar detalhes de eventos, gerar auditorias de conformidademcp:read
NotificaçõesListar contatos, grupos de contatos, webhooks e alertas recentesmcp:read
Conta e saúdeResumo da conta, sonda de saúde do servidor MCPmcp:read

Além de três prompts predefinidos para fluxos de trabalho em várias etapas: auditoria de renovação de certificados, triagem de incidentes e revisão mensal de conformidade.

Consulte a Referência de Ferramentas para obter a lista completa com exemplos de prompts, e o Guia de Configuração para conectar a ferramenta de IA de sua escolha.

Escopos

As concessões OAuth solicitam um ou mais dos seguintes escopos:

  • mcp:read: acesso somente leitura a dados de monitoramento, contatos, alertas e informações da conta.
  • mcp:reports: leitura de páginas de relatórios públicos (um escopo separado e mais restrito para integrações de links de compartilhamento).
  • mcp:write: acionar verificações manuais de RBL. Este é o único escopo que gera cobrança (por verificação nos planos Ultimate, contra sua cota diária nos demais casos).

mcp:write não está incluído por padrão na maioria das integrações de ferramentas: quando uma ferramenta de IA o solicita, você o verá explicitamente listado na tela de consentimento antes de aprovar.

Como o MCP se Compara à API REST

O servidor MCP complementa a API REST; é uma interface majoritariamente de leitura, otimizada para consumo por ferramentas de IA:

API RESTMCP
Melhor paraCódigo personalizado, scripts, dashboardsFerramentas de IA conversacionais
TransporteHTTP + JSONJSON-RPC 2.0 sobre HTTP
AutenticaçãoHTTP Basic (API key)HTTP Basic + OAuth 2.1
SuperfícieLeitura + escrita completasLeitura + verificações manuais de RBL
Limites de taxaCompartilhados por aplicação de APICompartilhados por aplicação de API

Se você está escrevendo sua própria integração, use a API REST. Se você quer que seu assistente de IA acesse sua conta, use o MCP.