Skip to main content

​
O que é o MCP da Morada.ai?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem com segurança a sistemas externos. O servidor MCP da Morada.ai expõe a sua plataforma como um conjunto de ferramentas que qualquer cliente compatível pode usar para:
  • Consultar workspaces, conversas, mensagens e deals
  • Listar agentes Mia e integrações configuradas
  • Enviar mensagens ativas via templates do WhatsApp
  • Criar e listar templates de mensagem
  • Buscar KPIs e analytics do workspace
Tudo isso respeitando as permissões do usuário autenticado e o escopo concedido durante a autorização.

​
Endpoint

ItemValor
URL do servidor MCPhttps://app.morada.ai/api/mcp
TransporteStreamable HTTP
AutenticaçãoOAuth 2.1 (PKCE) ou API Key (mak_...)
Nome do servidormorada-platform
O servidor implementa OAuth 2.1 com Dynamic Client Registration (DCR). A maioria dos clientes MCP modernos descobre e registra automaticamente — basta informar a URL.

​
O que você pode fazer

Conversas

Listar conversas, ler histórico de mensagens e investigar atendimentos sem sair do seu assistente.

Deals

Buscar deals por status, período ou pessoa, com pessoa, produtos e responsável.

Agentes Mia

Descobrir os agentes Mia configurados em cada workspace.

Integrações

Listar conectores configurados (CV CRM, Meta, etc.) e seu status.

Templates do WhatsApp

Listar templates aprovados pela Meta e criar novos diretamente.

Mensagens ativas

Disparar mensagens via template para qualquer número, com variáveis customizadas.

Analytics

Consultar KPIs do dashboard por período e workspace.

Multi-workspace

Operar sobre todos os workspaces aos quais o usuário tem acesso, sem trocar de conta.

​
Quando usar o MCP

Em vez de abrir a plataforma para consultar deals, conversas ou KPIs, você pergunta diretamente ao Claude/ChatGPT: “Liste os deals abertos do workspace X criados nos últimos 7 dias” e o assistente executa a chamada.
“Me dê o volume de conversas e deals fechados nos últimos 30 dias do workspace X.” Sem precisar exportar planilha.
“Envie a template boas_vindas para o telefone +55 11 9… usando o agente 42.” Útil para ações pontuais sem entrar na UI.
“Pegue a conversa ID c_123 e me explique o que aconteceu nas últimas 50 mensagens.” O assistente lê o histórico e te entrega o resumo.

​
Segurança e permissões

  • Toda chamada exige um token de acesso (OAuth) ou API key vinculados a um usuário real da plataforma.
  • O usuário só enxerga workspaces aos quais tem acesso.
  • Cada ferramenta valida a permissão correspondente (ex.: send_active_message exige talk:edit).
  • Escopos OAuth restringem o que o cliente pode fazer mesmo que o usuário tenha permissão total.
Operações de escrita (send_active_message, create_message_template) modificam dados reais. O assistente deve sempre confirmar a intenção antes de executar.

​
Próximos passos

Instalação

Como conectar Claude, Cursor, ChatGPT, VS Code e outros clientes ao MCP da Morada.

Autenticação

OAuth 2.1, API keys e escopos disponíveis.

Ferramentas

Catálogo completo das tools expostas pelo servidor.