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.
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".
Qual é o plano do Claude?
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.
Cada clínica tem o seu, no domínio da clínica, terminado em /mcp. Por exemplo: https://mcp.suaclinica.com.br/mcp.
A equipe da Fluxo Ideal passa o código da sua clínica. No Claude, ele vai no campo "OAuth client ID".
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ó.
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.
Conta individual (Free, Pro, Max)
Cada pessoa faz este passo na própria conta do Claude, uma vez só.
- 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. - Adicione um conector personalizado. Clique em + Add, no alto à direita, e escolha Add custom connector.
- 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
/mcpno fim. Clique em Continue. - 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.
- 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.
- 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".
- 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).
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.
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):
- Abra os conectores da organização. Vá em Organization settings › Connectors (endereço
claude.ai/admin-settings/connectors). - Adicione o conector. Clique em Add, depois em Custom e em Web.
- 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:
- Ache o conector. Em Customize › Connectors, o conector da clínica aparece com o rótulo Custom.
- 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.
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.
Entrar com o seu usuário
Ao conectar, o Claude abre a tela de login da sua clínica: a mesma da Central.
- Confira a tela. Ela é a da sua clínica, com a marca da Fluxo Ideal, no endereço da clínica.
- 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.
- Volte ao Claude. Depois do login, a tela fecha e o conector aparece como conectado.
- 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.
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.
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.
- 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.
- Peça em português, do seu jeito. Exemplos de pedidos estão no MAN-IA-01, seção 4.
- 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.
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.
- 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.
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).
Segurança
O conector abre uma porta para os dados da clínica. Estes cuidados mantêm a porta com quem deve.
- 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.
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).
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.