Ligar Ferramentas de IA (Claude, ChatGPT)

Pode ligar um assistente de IA como o Claude ou o ChatGPT à sua organização Flowtly e fazer-lhe perguntas sobre os seus dados em linguagem comum. Em vez de abrir o Flowtly e navegar até ao ecrã certo, pode pedir ao seu assistente coisas como "Qual é o total das nossas faturas vencidas este mês?" ou "Mostra as transações deste trimestre da nossa conta bancária principal" e obter uma resposta retirada diretamente dos seus dados Flowtly em tempo real.

A ligação pode ler os seus dados e executar um conjunto limitado de ações, como criar ou atualizar fornecedores, clientes, contratos, contas bancárias e grupos de custos, registar tempo de trabalho, criar ou atualizar tarefas, e carregar um documento numa fatura específica. Nunca vai além do que as suas próprias permissões no Flowtly já permitem, e cada ação é uma ferramenta concreta e nomeada — nunca uma função livre de "fazer qualquer coisa". Baseia-se no Model Context Protocol (MCP), a norma aberta que as ferramentas de IA utilizam para se ligarem a fontes de dados externas.

O que precisa

Uma conta Flowtly com acesso a, pelo menos, uma organização.
Uma ferramenta de IA que suporte conectores MCP personalizados (por exemplo, o Claude ou o ChatGPT num plano que permita adicionar conectores).
O endereço do conector Flowtly: https://mcp.flowtly.eu

Como ligar

Esta configuração é feita uma só vez e demora cerca de um minuto.

No Claude:

Abra Definições → Conectores (num plano que permita conectores personalizados).
Clique em Adicionar conector personalizado.
Cole o endereço Flowtly https://mcp.flowtly.eu e confirme.
Clique em Ligar junto ao novo conector Flowtly. Abre-se uma janela de início de sessão do Flowtly.

No ChatGPT:

Abra as definições de conectores/integrações e escolha adicionar um conector (um servidor MCP).
Cole https://mcp.flowtly.eu como endereço do servidor e continue.
Quando for solicitado, escolha iniciar sessão / autorizar.

No Claude Code (linha de comandos):

Execute: claude mcp add --transport http flowtly https://mcp.flowtly.eu/mcp
No Claude Code, selecione Authenticate para o novo servidor Flowtly; abre-se uma janela do navegador.

Depois, o mesmo para todas as ferramentas:

Inicie sessão no Flowtly na janela que se abre — com o seu e-mail e palavra-passe habituais, tal como na aplicação web. Se já tiver a sessão iniciada, este passo é ignorado.
Aparece um ecrã de consentimento, indicando que o assistente pretende aceder aos seus dados do Flowtly, e mostrando exatamente o que está a ser pedido. Escolha a organização que pretende ligar e, em seguida, clique em Aprovar (ou Recusar para cancelar).
É reencaminhado para a sua ferramenta de IA. O conector Flowtly está agora ativo e pode começar a fazer perguntas sobre essa organização.

Cada ligação está associada a uma organização. Se trabalha em várias organizações, repita os passos e escolha uma organização diferente de cada vez; o assistente mantém-nas separadas.

Como funciona na prática

Depois de ligar, basta conversar normalmente. Por exemplo, escreve:

Quanto temos ainda por receber em faturas este mês?

O assistente reconhece que se trata de uma pergunta relativa ao Flowtly, lê os dados das faturas da organização ligada e responde com o valor — por exemplo "Tem 4 faturas por pagar este mês, num total de 18.200 zł" — retirado dos seus dados em tempo real. Não abriu o Flowtly, não executou um relatório nem exportou nada; fez uma pergunta e obteve uma resposta. Pode continuar a fazer perguntas de seguimento ("quais delas estão vencidas?") na mesma conversa.

O que pode perguntar

Depois de ligado, o seu assistente pode ler as partes da sua organização que já consegue ver no Flowtly, incluindo:

Transações — saldos, movimentos recentes, gastos com uma determinada contraparte ao longo de um período.
Faturas — montantes em aberto, o que foi pago ou recebido, totais por estado.
Contratos e os respetivos planos de pagamento.
Contrapartes, fornecedores, contas bancárias, grupos de custo e dados de referência relacionados.

Perguntas úteis para experimentar:

"Quanto gastámos com [contraparte] no trimestre passado?"
"Lista as nossas faturas vencidas."
"Qual é o saldo da nossa conta principal e as últimas cinco transações?"

O assistente apenas devolve valores que existem no Flowtly, e cada resposta baseia-se nos seus dados reais e atualizados da organização que ligou.

Segurança e privacidade

Lê os seus dados e pode executar um conjunto limitado de ações de escrita. Um assistente ligado pode criar ou atualizar dados como fornecedores, clientes, contratos, contas bancárias e grupos de custos, registar tempo de trabalho, criar ou atualizar tarefas, e carregar um documento numa fatura específica — sempre através de ações concretas e nomeadas, e sempre limitado ao que a sua própria conta pode fazer.
Limitado a uma organização. Uma ligação só vê a única organização que selecionou ao conceder o acesso. Não consegue alcançar as suas outras organizações.
Aplicam-se as suas próprias permissões. O assistente vê os dados através da sua conta, pelo que está limitado àquilo que tem permissão para ver nessa organização.
Mantém o controlo. O acesso é concedido por si, para uma organização, e pode desligar o conector da sua ferramenta de IA a qualquer momento para o revogar.

Perguntas frequentes

É seguro entregar isto a uma ferramenta de IA? Sim. A ligação está limitada a uma organização e às permissões da sua própria conta, e utiliza o mesmo início de sessão seguro da aplicação web do Flowtly. O assistente pode ler os seus dados e executar um conjunto limitado de ações (como criar ou atualizar fornecedores, clientes, contratos e contas bancárias, registar tempo de trabalho e carregar um documento numa fatura), mas apenas o que você próprio pode fazer nessa organização.

Consegue ver as minhas outras organizações? Não. Cada ligação está vinculada à única organização que escolhe durante o início de sessão. Para trabalhar com outra organização, adicione uma ligação separada para ela.

Como a desligo? Remova o conector Flowtly da sua ferramenta de IA. Depois de removido, deixa de poder ler os seus dados Flowtly. Se a sua sessão expirar, basta iniciar sessão novamente da próxima vez que ligar.

Que ferramentas de IA são suportadas? Qualquer ferramenta que suporte conectores MCP personalizados, como o Claude ou o ChatGPT num plano que permita adicioná-los. Aponte o conector para https://mcp.flowtly.eu e siga os passos de início de sessão acima.

Para programadores

A criar uma integração? Veja a referência técnica do MCP — as ferramentas (tools/list / tools/call) e os detalhes JSON-RPC do conetor.