Conectar o Fiuit à sua IA

Com Conectar, seu assistente de IA (Claude ou ChatGPT) usa o Fiuit com a sua conta, sem copiar chaves. Ele vê e opera o que você permitir, nos projetos que você escolher, com as mesmas regras do painel. Uma só conexão pode cobrir vários negócios.

Pelo painel, com um clique

Em Configurações → Desenvolvedores, o cartão Conecte sua IA mostra ChatGPT, Claude, Gemini, Cursor, VS Code, Kimi e «Outra». No Cursor e no VS Code, um botão instala o conector direto. Nos demais, mostra os passos e o endereço https://mcp.fiuit.com/ com um botão Copiar. Alguns planos do ChatGPT ou do Claude não permitem conectores.

Antes de começar

• Você precisa ser dono ou gerente do projeto.
• O endereço do conector é https://mcp.fiuit.com/. Se o seu app já colocou https://mcp.fiuit.com/mcp, também funciona: é o mesmo servidor e a mesma conexão.

Claude (Desktop e claude.ai)

1. No Claude, abra Configurações → Conectores e toque em Adicionar conector personalizado.
2. Dê um nome (por exemplo, Fiuit) e use o endereço https://mcp.fiuit.com/.
3. Toque em Conectar: o Fiuit abre. Se não estiver logado, entre como sempre.
4. Na página de permissões, marque um ou mais projetos e as permissões de cada um e toque em Autorizar. Você volta ao Claude já conectado.

ChatGPT

1. No ChatGPT, abra Configurações → Conectores → Avançado e ative o modo desenvolvedor.
2. Crie um conector com o endereço https://mcp.fiuit.com/ e autenticação OAuth.
3. Toque em Conectar e siga os mesmos passos na página de permissões do Fiuit.

A página de permissões

• Qual app pede acesso. Claude e ChatGPT aparecem como Verificado. Qualquer outro app aparece Não verificado, com o endereço para onde volta: autorize só se você o reconhecer.
• Projetos. Você marca um ou mais (até 20) entre os que você é dono ou gerente; vem marcado o que está aberto. Cada projeto tem as suas permissões. Se você já tinha o app conectado, vêm marcados os projetos e permissões de antes, e o que você autorizar agora substitui a conexão anterior inteira: assim você soma ou tira projetos.
• Permissões. Vêm marcadas as que o app pede e você pode desmarcar qualquer uma:

As três últimas envolvem dinheiro: só o dono as vê e pode liberar, projeto por projeto (se você é dono de um negócio e gerente de outro, o dinheiro aparece só no primeiro). Uma IA nunca pode mais que a pessoa que a conectou.

Alterar fluxos, avaliações e políticas de cobrança também continua reservado ao dono; um gerente pode delegar mudanças em serviços e produtos.

Se você é parceiro da Fiuit: sua carteira pela IA

Se você é parceiro, a página de permissões também oferece Ver sua carteira de parceiro: clientes e atividade. Ela vem marcada só se o app pedir; se não, marque você. Escolha qualquer projeto em que você seja dono ou gerente (por exemplo, o seu): sua carteira não depende do projeto escolhido.

Com essa permissão você pode perguntar à sua IA, por exemplo: «o que eu tenho que fazer hoje com meus clientes?», «quais clientes estão em risco?» ou «o que aconteceu esta semana na minha carteira?». A IA vê o mesmo que o seu painel de parceiro:

• Hoje: a próxima ação, o progresso da sua carteira e os alertas.
• Meus clientes: plano ou teste, último uso, quantidade de tarefas e conversas, e o semáforo de cada cliente.
• Atividade: cadastros, canais conectados, primeiras reservas e clientes que estão parando.

É só leitura e com a mesma privacidade do painel: contagens e estados, nunca o conteúdo de um negócio nem as cobranças. O conteúdo de um cliente você vê ao entrar no projeto dele pelo painel. Você nunca vê clientes de outro parceiro. Se você deixar de ser parceiro, a conexão para de mostrar sua carteira na consulta seguinte.

Se a IA disser que falta uma permissão

A IA só vê as ferramentas que você liberou. Se você pede um saldo e ela não consegue, falta Ver dinheiro; se não consegue lançar uma cobrança em dinheiro, falta Registrar cobranças e enviar links de pagamento. Revogue a conexão em Apps conectados e conecte de novo marcando essa permissão (as de dinheiro só o dono concede). Editar os produtos de um pedido não precisa de permissões de dinheiro: basta Criar e mover horários. Ajustar à mão o valor a cobrar não é concedido por aqui: é feito no painel. Cancelar um agendamento sempre pede a sua confirmação antes de executar.

Ver e revogar os apps conectados

Em Configurações → Desenvolvedores, em Apps conectados, o dono vê cada conexão do projeto: o app, quem autorizou, as permissões, quando conectou e o último uso. Ele só vê o que é do projeto dele, não os outros negócios dessa conexão. Revogar corta o acesso a esse projeto na hora; os outros projetos da mesma conexão continuam funcionando. Se todos forem revogados, a IA pede para conectar de novo.

Perguntas frequentes

• A IA guarda minha senha? Não. Você entra no Fiuit e o app recebe uma permissão que vence e se renova sozinha. Você pode revogá-la quando quiser.
• E se mudarem meu papel? A conexão segue seu papel atual em cada projeto: se você virar gerente em um, ela perde o que envolve dinheiro ali; se sair de um projeto, esse deixa de funcionar e os outros continuam.
• Como a IA sabe em qual negócio trabalhar? Com um só projeto, usa esse. Com vários, a IA pergunta ou escolhe com a ferramenta list_projects, e nunca mistura dados de dois negócios numa resposta.
• Eu já tinha uma conexão por projeto, preciso reconectar? Não: as conexões anteriores continuam funcionando igual, cada uma no seu projeto. Se quiser uma só, conecte de novo e marque todos os projetos.
• Por que outra pessoa vê mais ou menos ferramentas? A IA vê só as ferramentas das permissões escolhidas ao conectar: com menos permissões, a lista fica mais curta.
• E as chaves de API? Continuam funcionando igual, para integrações próprias: MCP e agentes de IA.