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

# Cursor

> Adicione a Sailer como servidor MCP remoto em Customize, ou com quatro linhas de mcp.json.

Dez minutos. O Cursor fala Streamable HTTP, que é o que a Sailer serve.
Comece pela UI; `mcp.json` é a mesma coisa num arquivo.

A primeira conexão não consegue escrever. É deliberado.

<Steps>
  <Step title="O que você precisa">
    Cursor, e uma conta da Sailer cujo email pertence a um workspace. Você
    não precisa de um token de API, e não precisa de um Client ID.
  </Step>

  <Step title="Adicione o servidor CRM">
    **UI**

    1. Abra **Customize** na barra lateral.
    2. Abra **MCP**.
    3. Adicione um servidor novo.
    4. Cole `https://mcp.chatsailer.com/mcp/crm`.
    5. Salve. O Cursor trata um `url` como Streamable HTTP.

    **Não** preencha um OAuth Client ID / Secret estático. A Sailer não emite
    um para você, e o Cursor vai rodar o fluxo de browser sem ele.

    **`mcp.json`**

    Só o projeto (faça commit se o time inteiro deve receber):
    `.cursor/mcp.json`. Todo projeto: `~/.cursor/mcp.json`.

    ```json theme={null}
    {
      "mcpServers": {
        "sailer-crm": {
          "url": "https://mcp.chatsailer.com/mcp/crm"
        }
      }
    }
    ```

    Esse é o arquivo inteiro. Sem `headers`, sem bloco `auth`, sem `command`.
  </Step>

  <Step title="Autentique">
    O Cursor pede para você autenticar. O seu browser abre.

    Três telas, nesta ordem:

    1. **Auth0 sign-in** — o seu email e senha da Sailer. Já está logado?
       Este passo é pulado.
    2. **"Cursor wants to connect"** — um workspace é texto confirmado; vários
       é um dropdown. A lista de permissões combina com o workspace que você
       escolhe.
    3. Clique em **Approve**. Feche a aba.

    Em Customize, **sailer-crm** deve aparecer como connected com as tools
    listadas. Um ponto verde não é a prova — o próximo passo é.
  </Step>

  <Step title="Comprove">
    Abra um chat **Agent** novo (não um Ask simples que não consegue chamar
    tools) e digite:

    > Which Sailer workspace am I connected to?

    O Cursor vai chamar `whoami` e nomear o workspace, a organização pai, quem
    autorizou a conexão e os scopes que você concedeu.
  </Step>

  <Step title="Faça algo real">
    > How many contacts are in this workspace?

    > Describe the CRM schema — what custom fields does this workspace have?

    > Find contacts created in the last 7 days.

    > Find deals in Negotiation.

    [Ferramentas de CRM](/pt-BR/mcp/crm) é o catálogo. Writes precisam de uma
    reconexão — [Autenticação](/pt-BR/mcp/auth).
  </Step>
</Steps>

## Adicione o Studio também

A mesma UI, ou uma segunda entrada no `mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "sailer-crm": {
      "url": "https://mcp.chatsailer.com/mcp/crm"
    },
    "sailer-studio": {
      "url": "https://mcp.chatsailer.com/mcp/studio"
    }
  }
}
```

Autentique o Studio à parte. Um grant de CRM não vai funcionar lá.

[Ferramentas de Studio](/pt-BR/mcp/studio).

## Este cliente

**Tools demais no picker.** Desligue o Studio em Customize quando estiver
fazendo trabalho de CRM, e o contrário. Existem dois servidores para você
poder fazer isso.

**Connection failed.** Painel de Output (`Cmd+Shift+U` / `Ctrl+Shift+U`) →
**MCP Logs**. Quase sempre um typo na URL. Confirme que o servidor está no
ar:

```bash theme={null}
curl -s -o /dev/null -w '%{http_code}\n' https://mcp.chatsailer.com/healthz
```

`200` significa que a Sailer está bem e o problema é a config.

**Cloud Agents / CI.** OAuth num browser não vai rodar lá. Use um token de
workspace via interpolação — nunca um `sk_` literal num arquivo commitado:

```json theme={null}
{
  "mcpServers": {
    "sailer-crm": {
      "url": "https://mcp.chatsailer.com/mcp/crm",
      "headers": {
        "Authorization": "Bearer ${env:SAILER_API_TOKEN}"
      }
    }
  }
}
```

`whoami` vai reportar `credential: api_token` e `reads_company_wide: true`.
Veja [Autenticação](/pt-BR/mcp/auth).

**Trocar de workspace, ou conceder writes.** Tire o servidor em Customize (ou
apague a entrada do `mcp.json`), adicione de novo, escolha no consent.

Falhas compartilhadas (URL errada, email desconhecido, scope faltando) estão
em [Solução de problemas](/pt-BR/mcp/troubleshooting).