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

# Troubleshooting

> Fixes for the most common issues when connecting an assistant.

Find your symptom below and follow the fix.

For the full setup steps, see [Connect your assistant](/en/ai/connect).

## Common issues

<AccordionGroup>
  <Accordion title="The connector doesn't appear or won't stay connected" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/unplug.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=e3d564e77f988fc0c036392f0a7c489a" width="24" height="24" data-path="icons/unplug.svg">
    Make sure you copied the connection URL exactly as shown and pasted it into your client's custom connector field:

    ```text theme={null}
    https://guito.app/api/mcp
    ```

    After pasting the URL, you still need to **turn guito on inside the conversation**: in Claude, open the connectors menu and enable guito; in ChatGPT, install the personal plugin and select **@guito** in a new **Work** chat. If the connector still doesn't respond, remove it and add it again, repeating the [setup steps](/en/ai/connect).
  </Accordion>

  <Accordion title="Sign-in or authorisation fails" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/key.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=ba5ac0d2bbcd81b2289f58fe2140806b" width="24" height="24" data-path="icons/key.svg">
    When you connect, a browser window opens so you can sign in to guito and authorise access. If that window doesn't open or authorisation doesn't complete, repeat the connection steps in your client — you can re-authorise at any time.

    <Note>
      Your AI client can access only your own data, never your credentials. Learn more in [Security and privacy](/en/ai/security).
    </Note>
  </Accordion>

  <Accordion title="The assistant can read, but can't log entries" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/lock.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=2c64d707c0cd14a575c718dfc9b45bc2" width="24" height="24" data-path="icons/lock.svg">
    It isn't your plan: the connector and write actions are both included in **Plus**.

    Some clients also ask you to grant write access the first time, or have a read-only setting of their own: approve the action when the client prompts you, and check the connector's permissions in your client if writing is still blocked.

    <Note>
      Approval requests depend on your assistant and its permissions. guito saves a change when the assistant calls the write tool; it does not ask for a second confirmation.
    </Note>
  </Accordion>

  <Accordion title="I'm using Gemini and can't add the connector" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/ban.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=590fd89c5c8e0dc22feac880cb4aafc9" width="24" height="24" data-path="icons/ban.svg">
    The Gemini app does not yet support adding custom MCP connectors. For now, use Claude, ChatGPT or another MCP-compatible client, such as Claude Code, Cursor or VS Code.
  </Accordion>

  <Accordion title="The connection asks for a plan" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/credit-card.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=bbd73fbf3ac94fbcfc402633266f1142" width="24" height="24" data-path="icons/credit-card.svg">
    AI assistants are available on the Plus plan and during the trial. When the trial ends, the assistant replies that Plus is needed, and guito's authorisation screen only offers to cancel. If you're not on Plus yet, see the options in [Plans and pricing](/en/account/plans-and-pricing). You have 14 days from your initial subscription to exercise your right of withdrawal. Automatic renewals are not eligible.
  </Accordion>

  <Accordion title="How do I disconnect the connector?" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/power.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=f9e2441dad8babfc6b3f4b843c138133" width="24" height="24" data-path="icons/power.svg">
    In guito, open the user menu, choose **Settings** and then **AI assistants**: every connected assistant has a **Revoke access** button, and that is what cuts off access on guito's side. Also remove the guito connector in your AI client. You can reconnect at any time by repeating the [setup steps](/en/ai/connect).
  </Accordion>
</AccordionGroup>

## Still need help?

If none of the fixes above solves your problem, write to [support@guito.app](mailto:support@guito.app) and we'll help you connect your assistant.

## Next

<CardGroup cols={2}>
  <Card title="Connect your assistant" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/plug.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=b1ab938ce1b1ff00ea2b8e0063153ae3" href="/en/ai/connect" width="24" height="24" data-path="icons/plug.svg">
    Step-by-step setup for Claude, ChatGPT and developer clients.
  </Card>

  <Card title="Security and privacy" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/shield.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=aa86e6b8d2ce3e22e3eb68020c3ca0b0" href="/en/ai/security" width="24" height="24" data-path="icons/shield.svg">
    How OAuth access protects your data and credentials.
  </Card>

  <Card title="What are AI assistants" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/bot.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=85408477b801cc545a799f34a6ffc3da" href="/en/ai/overview" width="24" height="24" data-path="icons/bot.svg">
    Learn what you can do with an assistant connected to guito.
  </Card>

  <Card title="Plans and pricing" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/credit-card.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=bbd73fbf3ac94fbcfc402633266f1142" href="/en/account/plans-and-pricing" width="24" height="24" data-path="icons/credit-card.svg">
    See what's included in the Plus plan.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.