Ligar um assistente

O URL do conector

O Finance expõe um servidor MCP (Model Context Protocol, o padrão aberto que os assistentes de IA usam para falar com sistemas externos) no URL da tua organização:

https://<a-tua-organizacao>.slxd.app/mcp/finance

Se trabalhas num espaço pessoal em vez de numa organização partilhada:

https://finance.slxd.app/mcp/finance

Fala o transporte padrão Streamable HTTP, por isso qualquer cliente compatível se pode ligar: Claude, ChatGPT, Claude Code, Cursor e mais.

Duas formas de te autenticares

Iniciar sessão com a tua conta (OAuth) — recomendada

É a via para o Claude e o ChatGPT. Adiciona o URL do conector como conector remoto no cliente; da primeira vez que te ligares, abre-se uma janela para iniciares sessão com a tua própria conta e aprovares o acesso. A partir daí, o assistente atua como tu: vê o que o teu papel te deixa ver, e só isso.

Não há nenhuma chave para copiar, guardar ou enviar por email. Revogar a sessão ou desligar o assistente a partir da tua conta corta o acesso de imediato.

Uma chave de API

Para clientes que aceitam um token (Cursor, Claude Code, scripts): gera uma chave em Chaves de API, na tua conta, e envia-a num cabeçalho Authorization: Bearer. O valor mostra-se uma única vez — guarda-o como farias com qualquer palavra-passe.

Uma chave pode ficar ligada a uma organização concreta ou ficar sem ligar; sem organização, nenhuma ferramenta que precise de dados de uma organização vai funcionar até a ligares a partir da tua conta.

O que o assistente pode fazer

Com qualquer uma das duas vias, o assistente pode:

  • Consultar — faturas, orçamentos, compras, contactos, KPIs do painel, o resumo financeiro de um projeto, subscrições e orçamento contra o real.
  • Atuar, com a tua confirmação — lançar uma sincronização com o Holded, atribuir um documento a um projeto, criar uma subscrição. Estas três pedem confirmação explícita antes de serem executadas de verdade: o assistente mostra-te primeiro o que vai fazer.

Cada chamada fica limitada à tua organização e verifica a mesma permissão que terias na aplicação — se o teu papel não pode ver o orçamento anual, o assistente também não pode vê-lo em teu nome.

Sem cliente à mão? Usa o painel

O assistente integrado responde com as mesmas ferramentas sem configurares nada — útil para confirmares que uma ligação funciona antes de configurares um cliente externo.

Ligar um assistente