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

This page helps you unblock connecting an AI assistant to guito when something goes wrong: the connector doesn't appear, sign-in fails, or your plan doesn't cover the action you asked for. 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.pt/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, open **Tools** and enable guito. 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 authorization 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 authorize access over OAuth. If that window doesn't open or authorization doesn't complete:

    <Steps>
      <Step title="Sign in to guito">
        Use your guito account credentials in the window that opens. Access is authorized for your own account.
      </Step>

      <Step title="Authorize access">
        Approve the access request when the client shows it.
      </Step>

      <Step title="Re-authorize if needed">
        You can re-authorize at any time by repeating the connection steps in your client.
      </Step>
    </Steps>

    <Note>
      Your AI client reaches only your own data and 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">
    By default, the assistant queries and analyzes your data. Logging or creating entries requires the guito **Plus** plan.

    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 writes stay blocked.

    <Note>
      Any action that changes your records always asks for your confirmation before it saves. Nothing is modified without your approval.
    </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 allow 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. If you're not on Plus yet, see the options in [Plans and pricing](/en/account/plans-and-pricing). You have 14 days to exercise your right of withdrawal after subscribing.
  </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">
    Remove the guito connector in your AI client. You can re-authorize at any time by repeating the [setup steps](/en/ai/connect).
  </Accordion>
</AccordionGroup>

## Still need help?

If none of the situations above resolves your case, write to [support@guito.pt](mailto:support@guito.pt) and we'll help you connect your assistant.

## Learn more

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