Skip to main content

​
Antes de começar

Você vai precisar de:
  • Uma conta ativa na plataforma Morada.ai com acesso a pelo menos um workspace
  • Um cliente compatível com MCP (Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code com Copilot Chat, etc.)
  • A URL do servidor: https://app.morada.ai/api/mcp
O servidor suporta OAuth 2.1 com Dynamic Client Registration. Em clientes compatíveis (Claude, Cursor, ChatGPT, VS Code), basta colar a URL — o login acontece pelo navegador. Para automações ou clientes sem suporte a OAuth, use uma API key.

​
Claude (Desktop e Claude.ai)

1

Abra Settings → Connectors

No Claude Desktop ou em claude.ai, vá em Settings → Connectors → Add custom connector.
2

Informe a URL

Cole https://app.morada.ai/api/mcp no campo de URL e dê um nome (ex.: Morada.ai).
3

Autentique pelo navegador

O Claude abre uma janela do navegador para login na Morada.ai. Após autenticar, você é levado a uma tela de consentimento listando os escopos solicitados.
4

Aprove o acesso

Revise os escopos (leitura de conversas, deals, etc.) e clique em Autorizar. O conector aparece como disponível para conversas.

​
Claude Code (CLI)

claude mcp add --transport http morada-platform https://app.morada.ai/api/mcp
Na primeira chamada, o Claude Code abre o navegador para autenticação OAuth. Para usar uma API key ao invés de OAuth: 
claude mcp add --transport http morada-platform https://app.morada.ai/api/mcp \
  --header "Authorization: Bearer mak_SUA_API_KEY"

​
Cursor

1

Abra as configurações de MCP

Em Cursor Settings → MCP → Add new MCP Server.
2

Cole a configuração

{
  "mcpServers": {
    "morada-platform": {
      "url": "https://app.morada.ai/api/mcp"
    }
  }
}
3

Autentique

O Cursor abre o navegador para autenticação OAuth na primeira utilização.

​
ChatGPT (Plus / Pro / Business / Enterprise)

1

Acesse Settings → Connectors

No ChatGPT, vá em Settings → Connectors → Add.
2

Adicione o conector personalizado

Selecione Custom MCP server, informe nome (Morada.ai) e URL https://app.morada.ai/api/mcp.
3

Autentique e aprove escopos

Faça login na Morada.ai e autorize os escopos solicitados.
A disponibilidade de conectores MCP customizados no ChatGPT depende do seu plano e região.

​
VS Code (GitHub Copilot Chat)

Edite .vscode/mcp.json (workspace) ou as configurações globais de MCP: 
{
  "servers": {
    "morada-platform": {
      "type": "http",
      "url": "https://app.morada.ai/api/mcp"
    }
  }
}
Abra o Copilot Chat em Agent Mode e o VS Code negocia OAuth automaticamente.

​
Configuração genérica (qualquer cliente MCP)

Para clientes compatíveis com Streamable HTTP transport, basta a URL: 
https://app.morada.ai/api/mcp
Para autenticação manual via API key, envie o header: 
Authorization: Bearer mak_SUA_API_KEY
O servidor publica o documento OAuth em https://app.morada.ai/api/mcp/well-known/oauth-authorization-server — clientes compatíveis usam esse documento para descobrir os endpoints automaticamente.

​
Verificando a conexão

Depois de conectar, peça ao assistente:
“Liste meus workspaces na Morada.”
Se aparecer a lista de workspaces aos quais você tem acesso, está tudo certo.
Se a ferramenta list_workspaces retornar vazio, verifique se o seu usuário tem acesso a algum workspace na plataforma. Para qualquer outro erro, consulte Autenticação.

​
Próximos passos

Autenticação

Detalhes sobre OAuth, API keys e gestão de escopos.

Ferramentas

O que cada tool faz e quais parâmetros aceita.