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

# Ligar o seu assistente

> Passo a passo para ligar o Claude, o ChatGPT e clientes para programadores.

Este guia mostra-lhe como ligar um assistente de IA como o Claude ou o ChatGPT às suas finanças no guito, para perguntar sobre os seus dados a partir do assistente que já usa. A ligação é feita colando um URL e iniciando sessão uma vez, sem configuração adicional na aplicação.

<Info>
  Disponível no plano Plus e durante o período experimental do plano Plus de 14 dias. Quando o período experimental termina sem subscrição, o acesso pelo conector deixa de funcionar, mesmo que já o tenha configurado no cliente. Para saber o que os assistentes podem fazer depois de ligados, veja [O que são os Assistentes IA](/pt/ai/overview).
</Info>

## Endereço de conexão

Copie este endereço e cole-o no seu assistente de IA ao adicionar um conector personalizado.

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

## Ligar por cliente

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="Abrir os conectores">
        No Claude, abra **Personalizar** e depois **Conectores**.
      </Step>

      <Step title="Adicionar conector personalizado">
        Clique no **+** e depois em **Adicionar conector personalizado**.
      </Step>

      <Step title="Colar o endereço">
        Cole o endereço de conexão (`https://guito.pt/api/mcp`) e confirme.
      </Step>

      <Step title="Iniciar sessão e autorizar">
        Abre-se uma janela do navegador. Inicie sessão no guito e autorize o acesso por OAuth.
      </Step>

      <Step title="Ativar numa conversa">
        Numa conversa, clique no **+** (canto inferior), escolha **Conectores** e ative o guito.
      </Step>
    </Steps>

    <Note>
      Disponível nos planos gratuito (um conector), Pro, Max, Team e Enterprise do Claude.
    </Note>
  </Tab>

  <Tab title="ChatGPT">
    <Steps>
      <Step title="Ativar o modo de programador">
        No ChatGPT, abra **Definições → Aplicações e conectores → Definições avançadas** e ative o **Modo de programador**.
      </Step>

      <Step title="Criar o conector">
        Em **Definições → Conectores**, escolha **Criar**.
      </Step>

      <Step title="Indicar nome e endereço">
        Indique um nome e uma descrição, cole o endereço de conexão (`https://guito.pt/api/mcp`) e selecione autenticação **OAuth**.
      </Step>

      <Step title="Confirmar e autorizar">
        Confirme o aviso, inicie sessão no guito e autorize o acesso.
      </Step>

      <Step title="Ativar numa conversa">
        Numa conversa, abra o menu **+** e escolha o guito.
      </Step>
    </Steps>

    <Note>
      Tal como nos outros clientes, o conector do guito no ChatGPT requer o plano Plus (ou o período experimental). Registar movimentos pede sempre a sua confirmação.
    </Note>
  </Tab>

  <Tab title="Programadores">
    Funciona com qualquer cliente compatível com MCP.

    No **Claude Code**, adicione o servidor com uma linha:

    ```bash theme={null}
    claude mcp add --transport http guito https://guito.pt/api/mcp
    ```

    No **Cursor**, no **VS Code** e noutros editores, adicione o servidor ao ficheiro de configuração MCP do seu cliente (`mcp.json`):

    ```json theme={null}
    {
      "mcpServers": {
        "guito": {
          "url": "https://guito.pt/api/mcp"
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Note>
  A aplicação Gemini ainda não permite adicionar conectores MCP personalizados.
</Note>

## Confirmar que ficou ligado

Numa conversa, faça ao assistente uma pergunta sobre os seus dados, por exemplo "Qual é o meu património líquido?". Se responder com os seus valores, a ligação está a funcionar.

## A seguir

<CardGroup cols={2}>
  <Card title="O que são os Assistentes IA" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/bot.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=85408477b801cc545a799f34a6ffc3da" href="/pt/ai/overview" width="24" height="24" data-path="icons/bot.svg">
    O que pode perguntar e fazer depois de ligar um assistente.
  </Card>

  <Card title="Segurança e privacidade" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/shield.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=aa86e6b8d2ce3e22e3eb68020c3ca0b0" href="/pt/ai/security" width="24" height="24" data-path="icons/shield.svg">
    Como o acesso por OAuth protege os seus dados e credenciais.
  </Card>

  <Card title="Resolução de problemas" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/wrench.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=676ab2cd78a65dc8df39bbad69ef34f4" href="/pt/ai/troubleshooting" width="24" height="24" data-path="icons/wrench.svg">
    O conector não aparece, o início de sessão falha, ou como desligar.
  </Card>

  <Card title="Planos e preços" icon="https://mintcdn.com/guito/Z2-mKthyIORVPFl5/icons/credit-card.svg?fit=max&auto=format&n=Z2-mKthyIORVPFl5&q=85&s=bbd73fbf3ac94fbcfc402633266f1142" href="/pt/account/plans-and-pricing" width="24" height="24" data-path="icons/credit-card.svg">
    Veja o que está incluído no plano Plus.
  </Card>
</CardGroup>