mailinapp
Documentation menu

Servidor MCP

O MailInApp expõe um servidor MCP para que um cliente de IA externo — Claude Desktop, Claude Code, ou qualquer outra ferramenta compatível com MCP — possa construir e editar diretamente os projetos de e-mail da sua conta, da mesma forma que o copiloto de IA do estúdio faz. É o mesmo núcleo de uso de ferramentas nos dois casos: um cliente MCP e o painel do estúdio são apenas duas portas de entrada diferentes para o mesmo conjunto de edições.

Esta página cobre o caminho do desenvolvedor: seu próprio backend ou ferramentas de linha de comando se autenticando com uma chave de API que você mesmo gera, a mesma credencial que a Send API usa.

Endpoint e autenticação

https://mailinapp.com/api/mcp

Autentique com o mesmo cabeçalho Authorization: Bearer <apiKey> que a Send API usa — gere ou reutilize uma chave em Developers, no painel. Não existe uma credencial separada, específica para MCP, a gerenciar neste caminho; uma chave já representa "o próprio backend desta conta", então ela é confiável no mesmo nível aqui, com todas as ferramentas documentadas abaixo disponíveis independentemente do escopo.

O endpoint não tem estado (stateless): cada requisição é uma chamada MCP autocontida, então não há nada para manter ativo entre mensagens, nem uma etapa separada de conectar/desconectar além da configuração normal do seu cliente MCP.

Conectando o Claude Code

claude mcp add --transport http mailinapp https://mailinapp.com/api/mcp \
  --header "Authorization: Bearer mia_live_..."

O Claude Desktop e outros clientes MCP que aceitam um servidor HTTP remoto usam a mesma URL e o mesmo cabeçalho — consulte a documentação do seu próprio cliente para saber onde colá-los.

Ferramentas

Uma chave de API é confiável no nível completo de proprietário(a) da conta, então ela vê todas as ferramentas disponíveis — design de projeto, contatos e supressões, resultados de campanha e pedidos, envio (incluindo envios reais de campanha, não só testes), respostas de mailbox e de tickets, e uso do plano.

As ferramentas de edição de árvore (add_block/update_block/remove_block/move_block/set_theme, e afins) todas recebem um projectId inicial (obtido de list_projects/create_project) — um cliente MCP não tem nenhuma aba do estúdio aberta da qual inferi-lo. Todo tipo de bloco válido, seus pais aceitos e sua lista de campos são descritos ao modelo como parte do conjunto de ferramentas via list_block_types, então isso permanece sincronizado com quaisquer tipos de bloco que o estúdio ofereça no momento; você não precisa dizer a ele o que está disponível.

Como as edições são aplicadas

Cada chamada de ferramenta que altera dados é sua própria escrita atômica direto no projeto — não existe uma etapa de "aplicar" como no painel do estúdio, já que não há uma tela aberta para aplicar a alteração. Se você tiver o projeto aberto no estúdio no mesmo momento em que um cliente MCP o edita, seu próximo salvamento automático mostra o aviso normal de conflito "Alterado em outro lugar", exatamente como se um(a) colega de equipe o tivesse editado — recarregue para obter a alteração feita via MCP, ou salve como cópia para manter suas próprias edições em andamento.

Toda edição feita via MCP também é registrada na conversa do copiloto do projeto (marcada como vinda do MCP, não do painel do estúdio), então ela aparece no mesmo histórico exibido pelo painel do Copiloto de IA no estúdio.

Limites de taxa e disponibilidade por plano

  • Por chave de API: 60 requisições por minuto, independente de outras chaves na mesma conta.
  • Por conta: toda chamada de ferramenta consome de um contador mensal único (plan.connectorCallsMonthly, separado da própria cota de turnos do copiloto de IA do estúdio, já que uma chamada MCP nunca invoca um modelo de IA do próprio lado do MailInApp). Disponível com uma cota real em todos os planos, incluindo o Free — veja os preços para os números exatos, ou chame get_plan_usage para ler o uso do mês atual da sua conta até o momento.
  • Enviar campanhas reais por este caminho é medido do mesmo jeito que confirm_send, com o mesmo fluxo de confirmação e o mesmo limite de volume.