Ligar Ferramentas de IA (Claude, ChatGPT)

Equipa Editorial Flowtly11 min

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, carregar um documento numa fatura específica, e fechar um prospeto ou uma oportunidade de negócio. 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, o ChatGPT ou o Gemini Enterprise 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:

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

No ChatGPT:

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

No Claude Code (linha de comandos):

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

Em qualquer outra ferramenta MCP (incluindo o Gemini Enterprise):

  1. Encontre onde a sua ferramenta adiciona um servidor MCP personalizado ou um conector personalizado. No Gemini Enterprise, é na consola de administração do Google Workspace.
  2. Indique o endereço https://mcp.flowtly.eu. Para a maioria das ferramentas é o único dado necessário — o Flowtly regista a sua ferramenta automaticamente, pelo que não há nada a pedir-nos nem qualquer chave a obter.
  3. Se a sua ferramenta pedir mais do que um endereço, trata-se de uma configuração OAuth padrão e estes são os valores:
    • Registo: https://mcp.flowtly.eu/oauth/register
    • Autorização: https://mcp.flowtly.eu/oauth/authorize
    • Token: https://mcp.flowtly.eu/oauth/token
    • Método PKCE: S256 (obrigatório)
    • Segredo do cliente: nenhum — os conectores do Flowtly são clientes públicos
  4. Prossiga para o passo de início de sessão abaixo.

Se a sua ferramenta lhe mostrar um ID de cliente, copie-o de uma só vez. É uma única linha longa sem espaços, e alguns formulários de administração quebram-na ao colar, o que impede a ligação de funcionar. Se uma ligação falhar logo a seguir a colar um, apague o valor e cole-o de novo em vez de assumir que a configuração está errada.

Depois, o mesmo para todas as ferramentas:

  1. 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.
  2. 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).
  3. É 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.
  • Resourcing — o plano comparado com as horas efetivamente registadas, por pessoa por semana; quem está disponível ao longo de um período; o que está reservado para o futuro; e os pedidos de pessoal em aberto, juntamente com o que já foi decidido sobre os anteriores. Se o seu acesso abranger esses dados, os valores de receita, custo e margem subjacentes ao plano também podem ser consultados. As perguntas sobre resourcing requerem o módulo Resourcing na sua subscrição.
  • Horários de trabalho — os padrões de horário de trabalho definidos pela sua organização, quais estão em vigor numa determinada data e quem está atribuído a cada um.
  • Recursos humanos — pedidos de contratação em aberto e os candidatos apresentados para os mesmos.

As perguntas sobre um período precisam de uma data de início e de fim — diga qual o período que pretende, por exemplo "entre 1 de abril e 30 de junho" ou "para julho". O assistente lê esta informação; as reservas, horários e pedidos de contratação continuam a ser criados e alterados no Flowtly.

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?"
  • "Em setembro, quem está disponível?"
  • "Entre 1 de julho e 30 de setembro, o plano foi cumprido — horas planeadas versus horas registadas por pessoa?"
  • "Quais os pedidos de pessoal ainda em aberto e algum deles já tinha sido solicitado e recusado anteriormente?"

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.

Integrar um colega

Dar acesso a alguém tem três partes, e um assistente ligado pode realizar todas elas sem que abra o Flowtly:

  1. Adicionar a pessoa. O assistente cria o registo de funcionário.
  2. Convidá-la a iniciar sessão. O assistente envia um convite para o endereço de e-mail que indicar, e o Flowtly envia à pessoa um convite escrito no idioma de interface configurado para a sua organização. O convite fica pendente até que a pessoa o abra e configure o seu próprio início de sessão; o assistente não pode escolher uma palavra-passe nem iniciar sessão em seu nome.
  3. Definir o que pode aceder. O assistente atribui os grupos de permissões.

O convite e os grupos de permissões são independentes um do outro, pelo que o acesso pode ser concedido antes ou depois de o convite ser enviado. Note que os dois não são substitutos: alguém com grupos de permissões mas que nunca foi convidado continua sem forma de iniciar sessão, e uma pessoa convidada sem grupos de permissões pode iniciar sessão mas ver muito pouco.

Peça-o em linguagem natural, por exemplo «Adiciona Anna Kowalska como funcionária, convida-a em anna.kowalska@example.com e dá-lhe os mesmos grupos de permissões que o resto da equipa de entrega». Convidar alguém requer a mesma permissão que gerir pessoas no Flowtly. Pedir para convidar uma pessoa que já tem início de sessão não altera nada — o assistente informa que já tem um em vez de enviar um segundo e-mail.

Para realizar os mesmos passos no ecrã, consulte as páginas Invite your team, Creating a New Employee e Permission groups.

Fechar um prospeto ou uma oportunidade de negócio

Um assistente ligado pode fechar trabalho de vendas além de o registar. Pode fechar um prospeto que não ganhou, fechar uma oportunidade de negócio como ganha ou perdida, e reabrir qualquer um deles depois.

Fechar como perdida pede um motivo, escolhido na lista fixa que a sua organização mantém — não escrito como texto livre — o que é o que torna o trabalho perdido contabilizável no final do trimestre. Uma nota opcional pode acompanhá-lo. Peça em linguagem natural, por exemplo «Fecha o prospeto da Acme como perdido — escolheram um concorrente», e o assistente faz corresponder o que disse a uma entrada da lista. Um motivo que não está na lista é recusado em vez de registado como escrito.

Duas coisas valem a pena saber antes de pedir:

  • Fechar é um passo próprio, não uma edição. Um prospeto ou uma oportunidade é fechado(a) por uma ação de fecho dedicada, não editando um campo de estado no registo — por isso peça para fechá-lo, em vez de pedir para alterar o seu estado.
  • Perdido não é o mesmo que Não contactar. «Não contactar» é um pedido de supressão e bloqueia qualquer registo posterior contra a empresa. Fechar como perdido regista apenas que esta oportunidade particular não se concretizou, e deixa-o livre para abordar a empresa novamente mais tarde.

A reabertura comporta-se de forma diferente para os dois, o que vale a pena saber antes de pedir. Um prospeto reaberto retoma exatamente na fase do funil em que estava. Uma oportunidade reaberta regressa à primeira fase do pipeline, não à fase em que estava quando fechou, pelo que a avança novamente por conta própria.

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, carregar um documento numa fatura específica, e fechar um prospeto ou uma oportunidade de negócio — 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 — entre elas o Claude, o ChatGPT e o Gemini Enterprise, num plano que permita adicioná-los. Não há uma aplicação Flowtly separada para instalar em cada ferramenta nem qualquer aprovação a pedir: aponte o conector para https://mcp.flowtly.eu e siga os passos de início de sessão acima. Uma ferramenta que não esteja aqui indicada funciona da mesma forma, desde que suporte a norma aberta.

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.

Mapa de ligações

Refere-se aConsomeDerivado deParte de
Documentado aquiDocumentado noutro local
invoice faturado a counterparty. invoice tributado por tax-group. cost imputa a budget. cost devido a counterparty. bank-transaction reconciliado com invoice. bank-connection imports bank-transaction. contract planeia payment-schedule-line. contract acordado com counterparty. contract anexado a budget. budget abrange project. invoice faturado a partir de project. project ligado a budget. lead torna-se counterparty. deal vendido a counterparty.faturado atributado porimputa adevido areconciliado comimportsplaneiaacordado comanexado aabrangefaturado a partir deligado atorna-sevendido aFFatura — A sales document issued to a client: line items, dates, tax. It is created, reviewed, previewed and then sent.FaturaCContraparte — The other side of a financial document — a client billed, or a supplier owed.ContraparteGGrupo de impostos — The tax treatment applied to a line, so rates are set once rather than per document.Grupo de impostosCCusto — Money the organisation owes or has spent, tracked against a budget.CustoOOrçamento — The financial envelope an engagement is measured against — what was planned, versus what has actually been spent.OrçamentoMMovimento bancário — A movement on a connected bank account. Matching it to an invoice or a cost is what makes the books agree with the bank.Movimento bancárioBBank connection — The consented link to one bank that transactions arrive through. It can stop working on its own — a consent expires or is withdrawn — so it reports whether it is still working.Bank connectionCContrato — The financial terms of an engagement: a structured set of payment schedule lines, in one direction or the other.ContratoPPrestação do plano de pagamentos — One dated amount on a contract, in a direction — money owed to a supplier, or due from a client.Prestação do plano de…PProjeto — The core organizational unit for a business initiative, client engagement or internal work. Everything tracked — time, cost, invoicing, profitability — hangs off one.ProjetoPPotencial cliente — A company you are working but that is not a customer yet. It sits at New, Contacted or Qualified, and everything done to it is logged against it.Potencial clienteNNegócio — A sale in progress: a customer, an amount, and the stage it has reached. It cannot exist without a customer, and its stage is never blank.Negócio