> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morada.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> O servidor MCP da Morada.ai permite que assistentes de IA — como Claude, Cursor, ChatGPT e VS Code — leiam e atuem diretamente sobre seus workspaces, conversas, deals, agentes e integrações.

## 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

| Item                | Valor                                   |
| ------------------- | --------------------------------------- |
| URL do servidor MCP | `https://app.morada.ai/api/mcp`         |
| Transporte          | Streamable HTTP                         |
| Autenticação        | OAuth 2.1 (PKCE) ou API Key (`mak_...`) |
| Nome do servidor    | `morada-platform`                       |

<Info>
  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.
</Info>

## O que você pode fazer

<CardGroup cols={2}>
  <Card title="Conversas" icon="messages">
    Listar conversas, ler histórico de mensagens e investigar atendimentos sem sair do seu assistente.
  </Card>

  <Card title="Deals" icon="handshake">
    Buscar deals por status, período ou pessoa, com pessoa, produtos e responsável.
  </Card>

  <Card title="Agentes Mia" icon="robot">
    Descobrir os agentes Mia configurados em cada workspace.
  </Card>

  <Card title="Integrações" icon="puzzle-piece">
    Listar conectores configurados (CV CRM, Meta, etc.) e seu status.
  </Card>

  <Card title="Templates do WhatsApp" icon="whatsapp">
    Listar templates aprovados pela Meta e criar novos diretamente.
  </Card>

  <Card title="Mensagens ativas" icon="paper-plane">
    Disparar mensagens via template para qualquer número, com variáveis customizadas.
  </Card>

  <Card title="Analytics" icon="chart-line">
    Consultar KPIs do dashboard por período e workspace.
  </Card>

  <Card title="Multi-workspace" icon="building">
    Operar sobre todos os workspaces aos quais o usuário tem acesso, sem trocar de conta.
  </Card>
</CardGroup>

## Quando usar o MCP

<AccordionGroup>
  <Accordion title="Atendimento e operação assistidos por IA">
    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.
  </Accordion>

  <Accordion title="Relatórios e análises pontuais">
    *"Me dê o volume de conversas e deals fechados nos últimos 30 dias do workspace X."* Sem precisar exportar planilha.
  </Accordion>

  <Accordion title="Disparos pontuais de mensagem">
    *"Envie a template `boas_vindas` para o telefone +55 11 9... usando o agente 42."* Útil para ações pontuais sem entrar na UI.
  </Accordion>

  <Accordion title="Investigação de incidentes">
    *"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.
  </Accordion>
</AccordionGroup>

## 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.

<Warning>
  Operações de escrita (`send_active_message`, `create_message_template`) modificam dados reais. O assistente deve sempre confirmar a intenção antes de executar.
</Warning>

## Próximos passos

<Columns cols={3}>
  <Card title="Instalação" icon="download" href="/mcp/instalacao">
    Como conectar Claude, Cursor, ChatGPT, VS Code e outros clientes ao MCP da Morada.
  </Card>

  <Card title="Autenticação" icon="key" href="/mcp/autenticacao">
    OAuth 2.1, API keys e escopos disponíveis.
  </Card>

  <Card title="Ferramentas" icon="wrench" href="/mcp/ferramentas">
    Catálogo completo das tools expostas pelo servidor.
  </Card>
</Columns>