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

# Solución de problemas

> Las fallas que la gente realmente pega. Reintentar un error de insufficient-scope no va a ayudar.

Los detalles de cada cliente viven en el tutorial de ese cliente. Esta página
es la lista compartida.

<AccordionGroup>
  <Accordion title="Couldn't reach the MCP server">
    Casi siempre un typo en la URL. Es `/mcp/crm` o `/mcp/studio`, no `/crm`
    y no `/mcp`.

    Primero comprueba que el servidor esté arriba:

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

    `200` significa que Sailer está bien y el problema es tu URL o la config
    del cliente.
  </Accordion>

  <Accordion title="No Sailer account for this sign-in">
    El email que usaste en Auth0 no es miembro de ningún workspace de Sailer.
    Inicia sesión con la dirección que usa tu cuenta de Sailer, o pídele a un
    admin que te invite.
  </Accordion>

  <Accordion title="No workspace available">
    Tu cuenta existe pero no pertenece a ningún workspace. Un admin tiene que
    agregarte a uno.
  </Accordion>

  <Accordion title="Consent shows fewer permissions than I expected">
    Está mostrando lo que *tu rol* en ese workspace puede otorgar. Lo tachado
    es un scope que tu rol no puede ceder, así que no se incluye. Pídele a un
    admin que amplíe el rol si lo necesitas.

    La primera conexión es [solo lecturas](/es/mcp/auth) a propósito. Los
    writes son una reconexión, no un checkbox que se te pasó.
  </Accordion>

  <Accordion title="I want a different workspace, or I want to write">
    Una conexión está ligada a un workspace durante su vida. El binding vive
    dentro del token, por eso ninguna URL nombra una company.

    Quita el conector y agrégalo de nuevo, luego elige el otro workspace — o
    aprueba los scopes de write — en el consent. La misma reconexión para
    ambos.

    No puedes apuntar una URL a dos workspaces a la vez.
  </Accordion>

  <Accordion title="CRM token on Studio, or the other way around">
    Los tokens OAuth se emiten para exactamente un servidor. Usar un grant de
    CRM en Studio es **401**, no 403. Un desajuste de audience no es un scope
    faltante. Vuelve a conectar a la otra URL. Reintentar va a loopear.
  </Accordion>

  <Accordion title="The connector has no Sailer logo">
    Esperado para un conector custom. Claude y ChatGPT solo renderizan un logo
    para los listings del directorio, donde el icon se sube por separado. El
    servidor sí publica su icon; esos clientes aún no lo leen aquí.
  </Accordion>

  <Accordion title="Unknown field, not found, missing scope">
    Los errores MCP están escritos para el modelo, que está a punto de decidir
    qué hacer después.

    * **Unknown field** — nombra la key y a menudo una sugerencia. Llama
      `describe_schema`. No reintentes la misma key.
    * **Not found** — borrado, otro workspace, o fuera de tu ACL. El mismo
      siguiente paso: lista o busca de nuevo. No reintentes el id.
    * **Missing scope** — el mensaje nombra los scopes y dice que reintentar
      no va a ayudar. No va a ayudar. [Vuelve a conectar](/es/mcp/auth) y
      otórgales.

    Un 401 en la capa HTTP (token expirado o de audience incorrecto) es
    distinto: el cliente debería reautorizar, no el modelo reintentar la tool.
  </Accordion>
</AccordionGroup>