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

# Instalação

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

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

<Info>
  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](/mcp/autenticacao#api-key).
</Info>

## Claude (Desktop e Claude.ai)

<Steps>
  <Step title="Abra Settings → Connectors">
    No Claude Desktop ou em [claude.ai](https://claude.ai), vá em **Settings** → **Connectors** → **Add custom connector**.
  </Step>

  <Step title="Informe a URL">
    Cole `https://app.morada.ai/api/mcp` no campo de URL e dê um nome (ex.: `Morada.ai`).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Aprove o acesso">
    Revise os escopos (leitura de conversas, deals, etc.) e clique em **Autorizar**. O conector aparece como disponível para conversas.
  </Step>
</Steps>

## Claude Code (CLI)

```bash theme={null}
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:

```bash theme={null}
claude mcp add --transport http morada-platform https://app.morada.ai/api/mcp \
  --header "Authorization: Bearer mak_SUA_API_KEY"
```

## Cursor

<Steps>
  <Step title="Abra as configurações de MCP">
    Em **Cursor Settings** → **MCP** → **Add new MCP Server**.
  </Step>

  <Step title="Cole a configuração">
    ```json theme={null}
    {
      "mcpServers": {
        "morada-platform": {
          "url": "https://app.morada.ai/api/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Autentique">
    O Cursor abre o navegador para autenticação OAuth na primeira utilização.
  </Step>
</Steps>

## ChatGPT (Plus / Pro / Business / Enterprise)

<Steps>
  <Step title="Acesse Settings → Connectors">
    No ChatGPT, vá em **Settings** → **Connectors** → **Add**.
  </Step>

  <Step title="Adicione o conector personalizado">
    Selecione **Custom MCP server**, informe nome (`Morada.ai`) e URL `https://app.morada.ai/api/mcp`.
  </Step>

  <Step title="Autentique e aprove escopos">
    Faça login na Morada.ai e autorize os escopos solicitados.
  </Step>
</Steps>

<Note>
  A disponibilidade de conectores MCP customizados no ChatGPT depende do seu plano e região.
</Note>

## VS Code (GitHub Copilot Chat)

Edite `.vscode/mcp.json` (workspace) ou as configurações globais de MCP:

```json theme={null}
{
  "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.

<Tip>
  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](/mcp/autenticacao).
</Tip>

## Próximos passos

<Columns cols={2}>
  <Card title="Autenticação" icon="key" href="/mcp/autenticacao">
    Detalhes sobre OAuth, API keys e gestão de escopos.
  </Card>

  <Card title="Ferramentas" icon="wrench" href="/mcp/ferramentas">
    O que cada tool faz e quais parâmetros aceita.
  </Card>
</Columns>