Ligar o Claude, o ChatGPT e outros agentes

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.

Um agente de IA integrado no seu navegador, como o da aplicação de ambiente de trabalho do ChatGPT, também pode utilizar o OneBooks sem nada para ligar — consulte Agentes de IA no seu navegador (WebMCP).

Escolha o seu cliente

ClaudeO claude.ai e a aplicação Claude para computadorClaude CodeO agente no seu terminalChatGPTWeb e aplicação para computador, como conector personalizadoOpenClawO seu próprio agente sempre ativo

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, por predefinição, só um proprietário ou administrador pode propor recebimentos, pagamentos a fornecedores e as respetivas imputações, transferências internas, lançamentos contabilísticos, alterações de contas e planos orçamentais. Propor alterações aos dados de um cliente ou fornecedor exige permissão para gerir clientes ou fornecedores, que todos os membros têm por predefinição.
• 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

O Claude na Web e o Claude Desktop

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 identifica-se automaticamente perante o OneBooks.
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

Claude Code

Registe o servidor uma vez para todos os seus projetos e inicie sessão a partir do painel /mcp:

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

O ChatGPT na Web e na aplicação para computador

O ChatGPT adiciona o OneBooks como servidor MCP personalizado — o fluxo que antes se chamava modo de programador. A disponibilidade depende do seu plano ChatGPT e, num espaço de trabalho, pode ser preciso que um administrador autorize antes os conectores personalizados. Configure-o uma vez na Web; o conector pertence à sua conta ChatGPT.

1. Abra Definições → Conectores e selecione Adicionar servidor MCP personalizado.
2. 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, abra o menu +, ative o OneBooks para essa conversa e faça as suas perguntas.

Na pesquisa e na investigação aprofundada, o ChatGPT usa duas ferramentas só de leitura — search e fetch — que encontram e citam as suas faturas, compras, clientes, fornecedores e artigos, limitadas aos registos que a sua função pode ver. Os relatórios e a preparação de documentos usam as restantes ferramentas numa conversa com o OneBooks ativado.

OpenClaw

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:

{
  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 é:

{
  "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, respostas a partir desta documentação e propostas de orçamentos, faturas, notas de crédito e de débito, compras, gastos, recebimentos, pagamentos a fornecedores e as respetivas imputações, transferências internas, lançamentos contabilísticos, reconciliação bancária, planos orçamentais, contas, artigos, clientes e fornecedores — incluindo converter um orçamento em fatura, enviar uma fatura em rascunho ou finalizar uma compra em rascunho — além de edições a uma fatura ou compra em rascunho, um artigo, uma conta, os valores de um plano orçamental ou os dados de um cliente ou fornecedor.

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. Uma proposta que não aprove nunca é executada; caduca por si só ao fim de 24 horas. Não existem ferramentas de eliminar, anular ou reembolsar para agente nenhum, e as únicas ferramentas de edição alteram uma fatura ou compra em rascunho, um artigo, uma conta, os valores de um plano orçamental ou os dados de um cliente ou fornecedor — nunca um documento lançado nem os dados bancários.

Gerir e revogar o acesso

Aplicações → Integrações, com o filtro Aplicações ligadas, 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

300 pedidos por minuto por cada cliente de IA ligado à sua empresa, um limite semanal de chamadas por empresa e a dotação semanal de créditos de IA do seu plano — 100 créditos no Grátis, 400 no Standard, 1200 no Professional e 3000 no Premium —, partilhada com o assistente integrado. Consulte Créditos e limites.

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 recebimentos, pagamentos, imputações, transferências, lançamentos contabilísticos, alterações de contas e propostas de planos orçamentais (create_budget, update_budget_lines) exigem por predefinição um proprietário ou um administrador, editar um cliente ou fornecedor exige permissão para os gerir, e no ChatGPT o OneBooks tem de estar ativado para a conversa. Um cliente ligado antes de serem acrescentados os orçamentos, as devoluções, os lançamentos contabilísticos e a reconciliação bancária (outubro de 2026) só os vê depois de o voltar a ligar e aprovar uma vez as novas permissões. As ferramentas de planos orçamentais foram acrescentadas a 15 de outubro de 2026: um cliente ligado antes só as vê depois de o voltar a ligar e aprovar uma vez as respetivas permissões, porque uma ligação existente mantém as permissões já aprovadas.
• O agente diz que os créditos acabaram — a dotação renova-se a cada 7 dias a partir do momento em que a empresa criou a conta; consulte Créditos e limites.
• 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

Aplicações ligadas e OAuth

Gerir aplicações instaladas