@myago/mcp-server 🤖

O servidor oficial do Model Context Protocol (MCP) para o Myago Email Marketing.
Permite que Inteligências Artificiais (como Claude Desktop, Cursor e outros agentes) gerenciem sua conta Myago diretamente através de comandos em linguagem natural.

✨ Funcionalidades (AI Tools)

Uma vez conectado, seu assistente de IA ganha permissão para:

• 👥 Contatos: Listar, pesquisar e criar novos contatos com tags.
• 📧 Campanhas: Listar campanhas e disparar envios existentes para sua base.
• 🎨 Templates: Listar templates e criar novos modelos diretamente via código HTML gerado pela própria IA.
• 📊 Métricas: Consultar a saúde da conta e KPIs de engajamento em tempo real.

🚀 Instalação e Configuração

Pré-requisitos

• Node.js (v18 ou superior) instalado.
• Uma API Key do Myago (Disponível para planos PRO e Business em Configurações > API Keys).

No Claude Desktop

Adicione a configuração abaixo ao seu arquivo claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "myago": {
      "command": "npx",
      "args": ["-y", "@myago/mcp-server"],
      "env": {
        "MYAGO_API_KEY": "SUA_CHAVE_API_AQUI",
        "MYAGO_BASE_URL": "https://api.myago.com.br"
      }
    }
  }
}

No Cursor

1. Vá em Settings > Cursor Settings > Features > MCP.
2. Clique em "+ Add New MCP Server".
3. Configure como:
   • Name: Myago
   • Type: command
   • Command: npx -y @myago/mcp-server
4. Adicione a variável de ambiente MYAGO_API_KEY com seu token.

🛠️ Ferramentas Disponíveis (Referência)

| Ferramenta | Descrição | |---|---| | list_contacts | Retorna lista de contatos paginada. | | create_contact | Adiciona um novo lead (nome, email, tags). | | list_templates | Mostra todos os templates salvos. | | create_template | Salva um novo HTML como template. | | list_campaigns | Mostra histórico e status de campanhas. | | send_campaign | Dispara uma campanha existente para a base. | | get_dashboard_metrics | Resumo de entregabilidade e cliques. |

🔒 Segurança

O servidor MCP opera via stdio (entrada/saída padrão), garantindo que seus dados nunca saiam do seu ambiente local, exceto para as chamadas autorizadas para a API oficial do Myago via HTTPS.

📄 Licença

MIT © Myago