Logo da Fluxo Ideal
FluxoIdeal
Manual da Central
Assistente de IA

Conectar o Claude à Fluxo Ideal

O passo a passo para ligar o Claude ao servidor de IA da sua clínica, entrar com o seu usuário e usar com segurança.

Mascote da Fluxo Ideal
Para quem administra a clínica e quem vai usar o assistente
Código MAN-IA-03
Versão 1.3 · novembro de 2026
Leitura 10 minutos
Em resumo

Um conector no Claude, o login da clínica e pronto.

Um conector é a ligação que você cadastra no Claude para ele conversar com outro sistema. Aqui, com o servidor de IA da sua clínica na Fluxo Ideal.

Para cadastrar, você precisa de três coisas que a equipe da Fluxo Ideal passa: o endereço do servidor da clínica, o código do cliente e a senha do cliente. A senha do cliente é a senha que identifica o Claude para a clínica. Ela não é a senha de ninguém da equipe.

Depois, cada pessoa entra com o próprio usuário e senha da Central. O Claude só vê e faz o que o perfil dela permite. O que a IA faz e não faz está no MAN-IA-01, "Usar a IA com a Fluxo Ideal".

A pergunta que decide

Qual é o plano do Claude?

Free, Pro ou MaxConta individual: cada pessoa cadastra o conector na própria conta. Seção 2.
Team ou EnterpriseOrganização: quem administra cadastra uma vez e cada pessoa só clica em conectar. Seção 3.
1

Antes de começar

Peça à equipe da Fluxo Ideal os dados da sua clínica e confira o plano do Claude de quem vai usar.

Endereço do servidor

Cada clínica tem o seu, no domínio da clínica, terminado em /mcp. Por exemplo: https://mcp.suaclinica.com.br/mcp.

Código do cliente

A equipe da Fluxo Ideal passa o código da sua clínica. No Claude, ele vai no campo "OAuth client ID".

Senha do cliente

Gerada para a sua clínica. No Claude, vai no campo "OAuth client secret (optional)": apesar do "optional", na Fluxo Ideal ela é obrigatória. Guarde como segredo (seção 6).

Como pedir. Pelo Feedback da Central (veja o MAN-BAS-04) ou ao seu contato na Fluxo Ideal. Diga também quais perfis da equipe vão usar o assistente: o que cada um enxerga segue o perfil na Central, e a equipe da Fluxo Ideal confere se esses perfis estão liberados para a IA.

O plano do Claude. Os conectores funcionam nos planos Free, Pro, Max, Team e Enterprise. No Free, cabe um conector personalizado só.

Bom saber

Os prints e os nomes dos botões do Claude estão em inglês, como na tela em que foram tirados. Na sua tela, as telas do Claude podem aparecer em português e mudar com o tempo: se algo não bater, a ajuda do Claude sobre "custom connectors" tem a versão mais nova. Nos prints, o endereço e o código do cliente são de exemplo.

2

Conta individual (Free, Pro, Max)

Cada pessoa faz este passo na própria conta do Claude, uma vez só.

  1. Abra os conectores. No Claude, abra Settings (Configurações) e vá em Customize › Connectors (endereço claude.ai/customize/connectors). Ali aparecem os conectores que você já tem.
  2. Adicione um conector personalizado. Clique em + Add, no alto à direita, e escolha Add custom connector.
Configurações do Claude em Customize, aba Connectors, com o conector Fluxo Ideal na lista e o botão + Add no alto à direita
Figura 1. Settings › Customize › Connectors. O + Add fica no alto à direita. Depois de cadastrado, o conector aparece na lista com o rótulo Custom (os outros conectores da conta estão borrados).
  1. Dê um nome e cole o endereço. No primeiro campo, um nome fácil de reconhecer, como "Fluxo Ideal" (é o nome que aparece na lista de conectores). No segundo, cole o endereço que a Fluxo Ideal passou, com o /mcp no fim. Clique em Continue.
  2. Espere o Claude conferir o servidor. Aparece Checking the server... com três verificações. Quando as três ficam prontas e aparece Server found, clique em Continue.
Janela Add custom connector com o nome Fluxo Ideal e o endereço do servidor preenchidos, e o botão Continue
Figura 2. Nome e endereço do servidor. O endereço do print é de exemplo: use o da sua clínica.
Janela Checking the server com três verificações concluídas e o aviso Server found
Figura 3. O Claude confere o servidor. Com Server found, siga em Continue.
  1. Deixe o login ligado. Em Authentication, o Claude já vem com Sign in now marcado (com o selo Detected): deixe assim, e o login da clínica abre assim que você concluir. Sign in when needed também funciona (o login abre na primeira vez que usar). Não escolha No sign-in: sem login, o servidor da clínica não responde.
  2. Use o cliente da clínica. Em OAuth client, marque Use your own OAuth client. O Claude pode sugerir Register automatically com o selo Detected: para a Fluxo Ideal, use o próprio cliente. Preencha:
    • OAuth client ID: o código do cliente que a equipe da Fluxo Ideal passou;
    • OAuth client secret (optional): a senha do cliente que a equipe da Fluxo Ideal passou. Na Fluxo Ideal ela é obrigatória, apesar do "optional".
  3. Conclua. Role até o fim da janela. Deixe Request headers vazio (não clique em Add header) e não mexa em Advanced. Clique em Add. Com o Sign in now, o Claude abre a tela de login da clínica (seção 4).
Janela com Authentication em Sign in now, OAuth client em Use your own OAuth client e os campos OAuth client ID e OAuth client secret preenchidos
Figura 4. Sign in now e Use your own OAuth client, com o código e a senha do cliente. O código do print é de exemplo; a senha aparece em pontinhos.
Fim da janela com Request headers, Advanced e os botões Back e Add
Figura 5. O fim da janela: Request headers fica vazio. Clique em Add.
Atenção

Neste caminho, cada pessoa digita a senha do cliente na própria conta. Se a clínica tem várias pessoas usando, prefira o plano Team ou Enterprise (seção 3): a senha fica só com quem administra.

3

Organização (Team, Enterprise)

Quem administra a organização no Claude cadastra o conector uma vez. Depois, cada pessoa só conecta com o próprio usuário.

Quem administra (no Claude, o papel de Owner ou Primary Owner):

  1. Abra os conectores da organização. Vá em Organization settings › Connectors (endereço claude.ai/admin-settings/connectors).
  2. Adicione o conector. Clique em Add, depois em Custom e em Web.
  3. Siga os mesmos passos da conta individual. Nome, endereço com /mcp, Use your own OAuth client com o código e a senha do cliente que a equipe da Fluxo Ideal passou, e Add (seção 2, passos 3 a 7). As telas da organização podem ser um pouco diferentes: a ajuda oficial do Claude sobre conectores da organização tem o caminho mais novo.

Cada pessoa da equipe:

  1. Ache o conector. Em Customize › Connectors, o conector da clínica aparece com o rótulo Custom.
  2. Conecte. Clique em Connect e entre com o seu usuário e senha da Central (seção 4). A pessoa não vê nem digita a senha do cliente.
Bom saber

Este é o caminho recomendado para clínicas com mais de uma pessoa usando o assistente: a senha do cliente fica num lugar só, e trocar o endereço ou a senha é um passo só, de quem administra.

4

Entrar com o seu usuário

Ao conectar, o Claude abre a tela de login da sua clínica: a mesma da Central.

Tela de login da Fluxo Ideal com os campos Usuário e Senha, o botão Entrar e o link Esqueceu a senha
Figura 6. A tela de login da clínica. É nela que você entra, não no Claude.
  1. Confira a tela. Ela é a da sua clínica, com a marca da Fluxo Ideal, no endereço da clínica.
  2. Entre com o seu usuário e senha da Central. Se a clínica usa o segundo fator (o código do aplicativo no celular), ele também é pedido.
  3. Volte ao Claude. Depois do login, a tela fecha e o conector aparece como conectado.
  4. Confira a conexão. Numa conversa com o conector ligado, pergunte: "Quem sou eu na Fluxo Ideal?". O Claude responde com o seu usuário, o seu e-mail e os seus perfis na clínica (por exemplo, "recepção", "médico" ou "administrador"), e pode citar também dados da sua agenda.
Conversa no Claude: a pergunta Quem sou eu na Fluxo Ideal e a resposta com o usuário maria.recepcao, o e-mail maria@suaclinica.com.br e o papel de recepção
Figura 7. A resposta a "Quem sou eu na Fluxo Ideal?", com usuário, e-mail e papel (dados de exemplo).
Atenção

O usuário mostrado não é o seu? Então o conector está com o login de outra pessoa, e tudo o que o Claude fizer fica registrado no nome dela. Em Customize › Connectors, remova o conector (Remove ou os três pontos ao lado dele) e adicione de novo, entrando com o seu usuário.

Cada pessoa entra com o próprio usuário. Não use o login de outra pessoa nem um usuário compartilhado: o Claude age em nome de quem entrou, e tudo o que ele faz fica registrado com esse usuário.

Depois de conectado na conta, o conector também vale no Claude Desktop e no aplicativo do celular, com a mesma conta.

5

Usar na conversa e aprovar ferramentas

O conector entra na conversa como um conjunto de ferramentas: consultar a agenda, buscar paciente, montar um orçamento e assim por diante.

  1. Ligue o conector na conversa. No campo da mensagem, clique no + do canto inferior esquerdo, depois em Connectors, e ligue o interruptor do "Fluxo Ideal". No mesmo lugar dá para desligar, e há também Manage connectors (abre a lista de conectores) e Add connector.
  2. Peça em português, do seu jeito. Exemplos de pedidos estão no MAN-IA-01, seção 4.
  3. Aprove cada ferramenta com atenção. Quando o Claude quer usar uma ferramenta, ele mostra um cartão "Claude wants to use … from Fluxo Ideal" com o nome da ferramenta, os dados que vai enviar (por exemplo, as datas da busca) e a descrição dela. Leia antes de escolher:
    • Deny: recusa, e o Claude não usa a ferramenta;
    • Allow once: aprova só esta chamada;
    • Allow for this task: sempre permitir esta ferramenta. O Claude não pergunta mais por ela;
    • Allow for all tasks, na seta ao lado de Allow for this task: sempre permitir tudo. O Claude não pergunta mais por nenhuma ferramenta. Não use.
Menu + da conversa aberto em Connectors, com o interruptor do Fluxo Ideal ligado e as opções Add connector e Manage connectors
Figura 8. + › Connectors, com o "Fluxo Ideal" ligado (os outros conectores da conta estão borrados).
Cartão de aprovação: Claude wants to use Agendamento find from Fluxo Ideal, com os dados enviados, a descrição da ferramenta e os botões Deny, Allow for this task e Allow once
Figura 9. O pedido de aprovação, com os dados que vão para a Fluxo Ideal e os botões Deny, Allow for this task e Allow once.

Quando a ferramenta muda, o Claude pergunta de novo. Se a Fluxo Ideal atualizou uma ferramenta que você deixou sempre permitida, o Claude avisa "This tool has changed since you chose to always allow it" e pede a sua aprovação outra vez. É o momento de reler o que ela faz.

O que aparece para você. O Claude só recebe as ferramentas que o seu perfil na Central permite. A lista é montada a cada conexão: a recepção não vê as ferramentas da gestão, por exemplo. Se o seu perfil mudar, a lista muda junto na próxima conexão.

Atenção
  • Sempre permitir só para leitura. Use Allow for this task apenas em ferramentas que só consultam, e em que você confia (como ver a agenda ou buscar um paciente). Nunca use Allow for all tasks: ele libera também as ferramentas que gravam e enviam.
  • O que grava ou envia pede aprovação toda vez. Remarcar, cancelar, criar, enviar: use Allow once e leia os dados de cada chamada. Antes de gravar, o assistente mostra uma prévia do que vai mudar (veja o MAN-IA-01). A lista das ações mais sensíveis está na seção 6.
Evite

O modo Research com o conector ligado. Nesse modo, o Claude chama as ferramentas sem pedir aprovação. Antes de usar o Research, desligue o conector da clínica na conversa (+ › Connectors).

6

Segurança

O conector abre uma porta para os dados da clínica. Estes cuidados mantêm a porta com quem deve.

Cuidados
  • A senha do cliente é segredo da clínica. Não mande por e-mail aberto nem por mensagem a quem não administra. Guarde com quem administra a clínica. Se ela vazar, peça uma nova à Fluxo Ideal.
  • Cada um com o seu login. Tudo o que o assistente faz fica registrado com o usuário de quem entrou. Tentativa de usar uma ferramenta fora do perfil é recusada e também fica registrada.
  • Aprovação nas ações que gravam ou enviam, com Allow once, e nunca Allow for this task nem Allow for all tasks nelas (seção 5).
  • Research com o conector desligado (seção 5).

Ações que pedem cuidado redobrado. Os agentes automáticos da clínica nunca fazem estas ações sozinhos. Pelo Claude, quem faz é você, com o seu login. Por isso, nunca aprove estas ferramentas com Allow for this task nem com Allow for all tasks, porque os dois valem para sempre: aprove uma a uma, com Allow once.

  • mandar e-mail direto ao paciente ou enviar um documento do paciente por e-mail;
  • emitir, reenviar ou enviar uma nota fiscal;
  • excluir um modelo de mensagem do WhatsApp já aprovado;
  • exportar os dados da clínica;
  • cadastrar ou mudar um profissional e os documentos dele, como o CRM.

Desconectar ou remover. Em Customize › Connectors, use Remove (ou os três pontos ao lado do conector). Na organização, quem administra remove em Organization settings › Connectors. Para trocar o endereço ou a senha do cliente, remova e adicione de novo.

Quem sai da clínica. Desative o usuário da pessoa na Central, em Usuário ativo (veja o MAN-CFG-05). O login da clínica deixa de aceitar essa pessoa, e o acesso dela pelo Claude para em poucos minutos, mesmo que o conector continue na conta dela. Na organização do Claude, tire a pessoa também.

7

Se não funcionar

O Claude não acha o servidor.

Na etapa Checking the server..., alguma verificação não fica pronta e não aparece Server found. Confira o endereço: ele é o da sua clínica, começa com https:// e termina em /mcp. Copie e cole o que a Fluxo Ideal passou, sem espaço no fim.

O login dá erro antes de pedir a minha senha.

Quase sempre é o cliente: confira se marcou Use your own OAuth client (e não Register automatically), se o OAuth client ID é o código que a Fluxo Ideal passou e se a senha do cliente está preenchida e certa. Para corrigir, remova o conector e adicione de novo.

A tela de login não aceita a minha senha.

É a mesma da Central. Teste entrando na Central. Se não entrar lá também, use "Esqueceu a senha?" ou fale com quem administra a clínica.

Conectou, mas o Claude diz que não tem a ferramenta.

O seu perfil não dá acesso a ela. Peça a quem administra a clínica para conferir o perfil (MAN-CFG-05). Se o perfil está certo e mesmo assim não aparece, peça à Fluxo Ideal para conferir a liberação desse perfil para a IA.

Quero saber com qual usuário estou conectado.

Pergunte ao Claude: "Quem sou eu na Fluxo Ideal?". Ele responde com o seu usuário, o seu e-mail e os seus perfis (seção 4, passo 4, Figura 7). Se não for você, desconecte e entre de novo com o seu usuário. A lista de permissões não vem na resposta: o que você pode fazer aparece nas ferramentas que o Claude recebe.

Uma ferramenta deu erro e não sei se o servidor está no ar.

Peça ao Claude: "Teste se o servidor da Fluxo Ideal está no ar". Ele usa a ferramenta de teste do servidor: se ela responde, a conexão e o login estão bons e o problema é daquela ação. Se nem ela responde, desconecte e entre de novo; persistindo, avise pelo Feedback (MAN-BAS-04).

Funcionava e parou.

Desconecte e conecte de novo para entrar outra vez. Se a senha do cliente foi trocada, quem cadastrou o conector precisa remover e adicionar de novo com a senha nova. Persistindo, avise pelo Feedback (MAN-BAS-04).

8

Dúvidas frequentes

Preciso de um plano pago do Claude?

Não. O Free aceita um conector personalizado. Para várias pessoas, com a senha do cliente num lugar só, o Team ou o Enterprise é o melhor caminho.

A senha do cliente é a minha senha?

Não. Ela identifica o Claude para a clínica e é a mesma para todos. A sua senha é a da Central, digitada só na tela de login da clínica.

O Claude vê tudo da clínica?

Não. Ele vê e faz só o que o seu perfil permite na Central. O que a IA faz e não faz está no MAN-IA-01.

Funciona no celular?

Sim. Depois de conectado na sua conta, o conector vale também no aplicativo do Claude e no Claude Desktop.

Posso usar outro assistente que não o Claude?

Este manual cobre o Claude. Para outro assistente, fale com a equipe da Fluxo Ideal.