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 a Mia AI 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, o estúdio trata isso como a edição de um(a) colega: alterações em outros blocos são mescladas ao salvar e, se vocês dois mudaram o mesmo bloco, o salvamento automático pausa e oferece Mostrar o bloco, Recarregar a mais recente ou Salvar como cópia.
Toda edição feita via MCP também é registrada na conversa da Mia AI 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 da Mia AI 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 da Mia AI 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 chameget_plan_usagepara 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.