# Ligar o Claude, o ChatGPT e outros agentes
> Ligue o Claude, o Claude Code, o ChatGPT, o OpenClaw ou outro cliente MCP à sua contabilidade — inicie sessão, aprove o acesso e peça relatórios.
Canonical: https://docs.getonebooks.com/pt/ai/mcp/
Language: pt
Documentation index: https://docs.getonebooks.com/pt/llms.txt
O OneBooks tem um **servidor MCP** (Model Context Protocol), para que os agentes de IA que já utiliza possam trabalhar sobre a sua contabilidade: obter relatórios, consultar registos, pesquisar nesta documentação e preparar documentos que o utilizador confirma. Recebem exatamente as ferramentas que o assistente da aplicação tem, com a mesma regra — **nada é escrito enquanto uma pessoa não aprovar**.
> **O endereço do servidor**
> `https://api.getonebooks.com/mcp` — Streamable HTTP com início de sessão OAuth. Não há chaves de API para copiar.
## Escolha o seu cliente
O Cursor, o VS Code, o MCP Inspector e os agentes personalizados ligam-se da mesma forma — consulte a secção sobre outros clientes MCP mais abaixo.
## O que é preciso
- Uma conta OneBooks. O agente herda a sua função: um **visualizador** recebe ferramentas só de leitura, um **membro** pode propor documentos e só um **proprietário** ou **administrador** pode propor pagamentos.
- O Claude e o ChatGPT chegam ao OneBooks a partir dos seus próprios servidores; o Claude Code e o OpenClaw ligam-se a partir do seu computador. Em qualquer dos casos, o cliente inicia sessão através do ecrã de consentimento descrito a seguir — nunca com uma chave colada.
## Aprovar o acesso
Da primeira vez que um cliente se liga, o OneBooks abre o seu ecrã de início de sessão e consentimento.
1. Inicie sessão com o e-mail e a palavra-passe do OneBooks, se ainda não o tiver feito.
2. Verifique a empresa indicada no ecrã — o acesso é concedido apenas à sua **empresa ativa**.
3. Reveja o que a aplicação vai poder fazer e selecione **Aprovar** (ou **Recusar**).
Mudar de empresa ativa no OneBooks termina a ligação; volte a ligar e dê o consentimento para a nova empresa.
## Claude
Os conectores personalizados estão disponíveis em todos os planos do Claude (o plano gratuito permite um). O Claude liga-se ao OneBooks a partir dos servidores da Anthropic, por isso um conector adicionado uma vez funciona igualmente no navegador e no Claude Desktop.
1. Abra **Personalizar → Conectores**. Nos planos Team e Enterprise é um proprietário que o adiciona em **Definições da organização → Conectores → Adicionar → Personalizado**; depois os membros selecionam **Conectar**.
2. Selecione **Adicionar conector personalizado**, dê-lhe o nome OneBooks e introduza `https://api.getonebooks.com/mcp`. Deixe vazios os campos avançados de OAuth — o Claude regista-se sozinho.
3. Selecione **Conectar** e aprove o acesso no ecrã do OneBooks.
4. Numa conversa, abra o menu **+**, escolha **Conectores** e ative o OneBooks. Depois pergunte: "Qual é a minha posição de tesouraria?"
## Claude Code
Registe o servidor uma vez para todos os seus projetos e inicie sessão a partir do painel `/mcp`:
```bash
claude mcp add --transport http onebooks --scope user https://api.getonebooks.com/mcp
```
Dentro do Claude Code, execute `/mcp`, escolha **onebooks** e conclua o início de sessão no navegador. O `claude mcp list` mostra a ligação e o `claude mcp remove onebooks` remove-a. O Claude Code identifica-se com um documento de metadados de cliente, por isso não há nada a registar.
## ChatGPT
Os servidores MCP personalizados no ChatGPT precisam do **modo de programador**, disponível nos planos Plus, Pro, Business, Enterprise e Edu (pode ser preciso que um administrador do espaço de trabalho o autorize antes). Configure-o uma vez na Web; o conector pertence à sua conta ChatGPT.
1. Abra **Definições → Aplicações** (em alguns planos chama-se **Conectores**), depois **Definições avançadas**, e ative o **modo de programador**.
2. Selecione **Criar**, dê-lhe o nome OneBooks, introduza `https://api.getonebooks.com/mcp`, escolha **OAuth** como autenticação e confirme que confia no fornecedor.
3. Aprove o acesso no ecrã do OneBooks.
4. Numa conversa nova, selecione **+ → Mais → Modo de programador**, ative o OneBooks para essa conversa e faça as suas perguntas.
Sem o modo de programador, o ChatGPT usa apenas duas ferramentas só de leitura — **search** e **fetch** — que encontram e citam as suas faturas, compras, clientes, fornecedores e artigos, por exemplo numa investigação aprofundada. Os relatórios e a preparação de documentos exigem o modo de programador.
## OpenClaw
O OpenClaw é um agente pessoal de código aberto que corre na sua própria máquina e fala consigo através das suas aplicações de mensagens.
1. Abra **Definições → MCP**, selecione **Adicionar servidor**, dê-lhe o nome `onebooks`, escolha o transporte **Streamable HTTP** e introduza `https://api.getonebooks.com/mcp`.
2. Defina a autenticação do servidor como OAuth (a entrada de configuração está mais abaixo).
3. Execute `openclaw mcp login onebooks`. O navegador abre o ecrã de consentimento do OneBooks e o OpenClaw guarda os tokens; se o navegador não conseguir alcançar o retorno de chamada do OpenClaw, utilize o comando `--code` que ele imprime.
4. O `openclaw mcp status --verbose` confirma a ligação.
No ficheiro de configuração do OpenClaw, a entrada do servidor fica assim:
```json5
{
mcp: {
servers: {
onebooks: {
url: "https://api.getonebooks.com/mcp",
transport: "streamable-http",
enabled: true,
auth: "oauth",
},
},
},
}
```
## Outros clientes MCP
Qualquer cliente compatível com **Streamable HTTP** e **OAuth 2.0 com PKCE** consegue ligar-se — o Cursor, o VS Code, o Windsurf, o MCP Inspector, agentes personalizados. Nos clientes que usam um ficheiro de configuração, a entrada é:
```json
{
"mcpServers": {
"onebooks": { "type": "http", "url": "https://api.getonebooks.com/mcp" }
}
}
```
O cliente descobre o servidor de início de sessão, regista-se (ou apresenta o seu documento de metadados de cliente) e abre o ecrã de consentimento.
## O que o agente consegue fazer
Exatamente o mesmo que o assistente da aplicação: [relatórios e consultas](https://docs.getonebooks.com/pt/ai/reports/), respostas a partir desta documentação e [propostas](https://docs.getonebooks.com/pt/ai/drafting/) de faturas, compras, gastos, recebimentos, clientes e fornecedores.
Também aqui a escrita funciona em dois passos. O agente pede ao OneBooks que prepare o documento; o OneBooks guarda uma **proposta** e devolve uma pré-visualização, que o agente lhe mostra. Só depois de aprovar essa pré-visualização exata é que o agente confirma a proposta — nunca no mesmo turno, uma só vez e no prazo de 24 horas. Todas as propostas aparecem igualmente no assistente da aplicação, onde as pode confirmar ou cancelar. Não existem ferramentas de eliminar, anular, editar ou reembolsar para agente nenhum.
## Gerir e revogar o acesso
**Aplicações → Aplicações**, com o filtro **Aplicações**, lista os clientes de IA ligados à sua empresa, cada um com o seu nome e a sua marca, a data em que foi autorizado e a da última utilização.
Selecione um cartão para ver o que a aplicação pode fazer e para **Revogar acesso**. Os tokens deixam de funcionar imediatamente; nada do que a aplicação já criou é removido.
## Limites
120 pedidos por minuto e por endereço, um limite semanal de chamadas por empresa e a dotação semanal de créditos partilhada. Consulte [Créditos e limites](https://docs.getonebooks.com/pt/ai/credits/).
## Resolução de problemas
- **O ecrã de consentimento indica a empresa errada** — mude primeiro de empresa ativa no OneBooks e volte a ligar.
- **O cliente deixou de funcionar depois de mudar de empresa** — é o esperado; volte a ligar e dê o consentimento para a nova empresa.
- **Faltam ferramentas** — um visualizador só tem ferramentas de leitura, os pagamentos exigem um proprietário ou um administrador, e o ChatGPT precisa do modo de programador para tudo o que vá além do search e do fetch.
- **O agente diz que os créditos acabaram** — a dotação renova-se semanalmente; consulte [Créditos e limites](https://docs.getonebooks.com/pt/ai/credits/).
- **O OpenClaw não mostra nada depois de Aprovar** — o navegador não conseguiu alcançar o retorno de chamada local; execute o comando `--code` impresso no terminal.
## Para programadores
Está a criar o seu próprio cliente MCP ou uma integração? A documentação para programadores em **developer.getonebooks.com** cobre o OAuth, os âmbitos, o registo dinâmico, os documentos de metadados de cliente e a referência da API.
## Relacionado
- [Segurança, privacidade e limites](https://docs.getonebooks.com/pt/ai/safety/)
- [Aplicações ligadas e OAuth](https://docs.getonebooks.com/pt/integrations/connected-apps/)