Ranla

npx add-mcp 'https://mcp.ranla.ai/mcp'

Ranla MCP

O Ranla MCP conecta Cursor, Claude Code e agentes compatíveis a:

• Ranla para estratégia de crescimento, análise de ciclo de vida, trabalho com público e aprovações.
• Ferramentas de e-mail transacional, domínio, templates e entregabilidade quando você precisar.

Use Ranla para trabalho de crescimento para que conversa, memória e fluxo de aprovações permaneçam em um só lugar. Instalar o MCP não exige alterar o e-mail transacional do seu produto.

Conexão hospedada

O servidor hospedado não precisa de chave de API. Adicione a URL:

{
  "mcpServers": {
    "ranla": {
      "url": "https://mcp.ranla.ai/mcp"
    }
  }
}

No Claude Code:

claude mcp add --transport http ranla https://mcp.ranla.ai/mcp

Na primeira conexão, seu cliente abre um navegador (no Claude Code, execute /mcp). Faça login em app.ranla.ai e clique em Permitir acesso. Use um cabeçalho Bearer (Authorization: Bearer rnl_…) apenas para uma configuração avançada que não consiga fazer login.

Adicionar Ranla ao ChatGPT

O ChatGPT conecta-se ao mesmo servidor hospedado. Para adicioná-lo você mesmo:

1. No ChatGPT, abra Configurações → Segurança e login e ative o Modo desenvolvedor.
2. Abra Plugins, selecione + e insira https://mcp.ranla.ai/mcp como URL do servidor. Escolha OAuth para autenticação.
3. Faça login em app.ranla.ai e clique em Permitir acesso.

Depois, pergunte em uma nova conversa, por exemplo "Como está o crescimento no Ranla esta semana?" ou "O que está aguardando minha aprovação no Ranla?". O ChatGPT pergunta antes de executar uma etapa que altere seu espaço de trabalho, e qualquer coisa que envie, gaste ou publique ainda aguarda sua aprovação no Ranla.

Para desconectar, remova Ranla dos plugins do ChatGPT. Isso encerra o acesso dele ao seu espaço de trabalho.

Instalar no Cursor

Crie uma chave de API em Configurações → Chaves de API e adicione isto a .cursor/mcp.json ou à sua configuração global de MCP do Cursor:

{
  "mcpServers": {
    "ranla": {
      "command": "npx",
      "args": ["-y", "ranla-mcp@latest"],
      "env": {
        "RANLA_API_KEY": "rnl_your_key_here"
      }
    }
  }
}

Reinicie o Cursor após alterar a configuração.

Instalar no Claude Code

claude mcp add --transport stdio ranla -- npx -y ranla-mcp@latest

Exporte RANLA_API_KEY no ambiente onde o Claude Code é executado.

Ferramentas

Ferramentas do agente Ranla

• arc_ensure_thread / arc_list_threads — encontre ou crie um thread durável, ou liste threads (mais recentes primeiro; passe nextBefore como before para os mais antigos).
• arc_get_thread — leia as mensagens de um thread, incluindo as ferramentas que Ranla usou, o que ele criou e aprovações aguardando você. Passe earlierBefore como before para mensagens mais antigas.
• arc_message — envie uma solicitação ao Ranla e aguarde a resposta. Ele retorna a resposta de Ranla (text), os rascunhos, planos e documentos que ele criou ou abriu (artifacts) e pendingApproval quando uma etapa precisar do seu sim.
• arc_list_approvals, arc_approve, arc_reject — responda aprovações sem abrir o painel.
• arc_ranla — execute você mesmo um dos comandos de Ranla: command é um substantivo e um verbo, como campaign list, segment create, page propose ou connection request, e input contém seus campos. A descrição da ferramenta lista todos os comandos, e help <noun> retorna os comandos de um substantivo com todos os campos. São os mesmos comandos que Ranla executa, sob as mesmas regras: qualquer coisa que envie, gaste ou publique volta como pendingApproval e não faz nada até você responder com arc_approve. A lista vem do seu espaço de trabalho, então novos comandos aparecem sem atualização. Links nos resultados são URLs completas do aplicativo.

Fluxo recomendado: arc_ensure_thread, depois arc_message para qualquer coisa que precise do julgamento ou da pesquisa de Ranla ("crie uma campanha de reativação"), ou arc_ranla quando você souber a etapa (" campaign list "). Se uma etapa precisar de aprovação, arc_list_approvals, depois arc_approve ou arc_reject.

Essas ferramentas precisam de uma chave de API com acesso total. Login via OAuth e chaves criadas em Configurações → Chaves de API têm acesso total; uma chave somente de envio recebe 403 em toda ferramenta arc_*.

Ferramentas de e-mail

• Envio: send_email (agora, ou depois com scheduled_at), cancel_email, list_emails, get_email.
• Recebimento: list_received_emails, get_received_email.
• Domínios: list_domains, get_domain, create_domain, apply_domain_dns, verify_domain.
• Templates: list_templates, get_template, create_template, publish_template.
• Webhooks: list_webhooks, create_webhook, delete_webhook, send_test_webhook_event.
• Supressões e entregabilidade: list_suppressions, add_suppression, remove_suppression, get_deliverability.

Até que seu domínio seja verificado, envie de [email protected] apenas para o e-mail da sua conta.

Escolhendo ferramentas

Para trabalho de crescimento, envie mensagem ao Ranla e deixe que ele escolha as ferramentas de leitura apropriadas ou solicite uma aprovação. Para integração de aplicativos, use o SDK do Ranla e a habilidade ranla para adicionar contatos de Audience e eventos de ciclo de vida.

O e-mail transacional está disponível pelo mesmo servidor. Use essas ferramentas apenas quando o usuário pedir para enviar, inspecionar ou configurar e-mail.

Veja Agent Skills e o quickstart de instrumentação.