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

# Solução de problemas

> As falhas que as pessoas realmente encontram. Tentar de novo um erro de insufficient-scope não vai ajudar.

Nits específicos de cada cliente ficam no tutorial daquele cliente. Esta
página é a lista compartilhada.

<AccordionGroup>
  <Accordion title="Couldn't reach the MCP server">
    Quase sempre um typo na URL. É `/mcp/crm` ou `/mcp/studio`, não `/crm` e
    não `/mcp`.

    Cheque se o servidor está no ar primeiro:

    ```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 sua URL ou a
    config do cliente.
  </Accordion>

  <Accordion title="No Sailer account for this sign-in">
    O email que você usou no Auth0 não é membro de nenhum workspace da
    Sailer. Entre com o endereço que a sua conta da Sailer usa, ou peça a um
    admin para te convidar.
  </Accordion>

  <Accordion title="No workspace available">
    A sua conta existe mas não pertence a nenhum workspace. Um admin precisa
    te adicionar a um.
  </Accordion>

  <Accordion title="Consent shows fewer permissions than I expected">
    Está mostrando o que *o seu papel* naquele workspace consegue conceder.
    Qualquer coisa riscada é um scope que o seu papel não pode ceder, então
    não entra. Peça a um admin para ampliar o papel se você precisar.

    A primeira conexão é [só leituras](/pt-BR/mcp/auth) de propósito. Writes
    são uma reconexão, não um checkbox que você deixou passar.
  </Accordion>

  <Accordion title="I want a different workspace, or I want to write">
    Uma conexão fica ligada a um workspace pela vida dela. O binding vive
    dentro do token, por isso nenhuma URL nomeia uma company.

    Tire o conector e adicione de novo, depois escolha o outro workspace — ou
    aprove os scopes de write — no consent. A mesma reconexão para os dois.

    Você não consegue apontar uma URL para dois workspaces ao mesmo tempo.
  </Accordion>

  <Accordion title="CRM token on Studio, or the other way around">
    Tokens OAuth são emitidos para exatamente um servidor. Usar um grant de
    CRM no Studio é **401**, não 403. Descompasso de audience não é scope
    faltando. Reconecte na outra URL. Tentar de novo vai loopar.
  </Accordion>

  <Accordion title="The connector has no Sailer logo">
    Esperado para um conector custom. Claude e ChatGPT só renderizam logo
    para listings do diretório, onde o icon é enviado à parte. O servidor
    publica o seu icon; esses clientes ainda não o leem aqui.
  </Accordion>

  <Accordion title="Unknown field, not found, missing scope">
    Erros MCP são escritos para o modelo, que está prestes a decidir o que
    fazer em seguida.

    * **Unknown field** — nomeia a key e muitas vezes uma sugestão. Chame
      `describe_schema`. Não tente de novo a mesma key.
    * **Not found** — apagado, outro workspace, ou fora do seu ACL. O mesmo
      próximo passo: liste ou busque de novo. Não tente de novo o id.
    * **Missing scope** — a mensagem nomeia os scopes e diz que tentar de
      novo não vai ajudar. Não vai. [Reconecte](/pt-BR/mcp/auth) e conceda.

    Um 401 na camada HTTP (token expirado ou de audience errada) é diferente:
    o cliente deve reautorizar, não o modelo tentar a tool de novo.
  </Accordion>
</AccordionGroup>