O cadastro por dentro.
O laudo veio com o nome CUNHA, LEONARDO. Quem é?
Não há ninguém com esse nome exato. O mais parecido é Leonardo Cunha, de Criciúma, com 97% de semelhança no nome. Antes de usar esse cadastro, confirme a data de nascimento dele no laudo.
Abaixo de 0,6, nada
A busca aproximada não devolve "o mais parecido" de qualquer jeito: abaixo do limiar, a lista vem vazia.
Ferramentas MCP
Ler
Buscar (com a aproximada quando não há nome exato), abrir a ficha e analisar duplicados.
- clientes_find
- clientes_get_context
- clientes_analisar_duplicados
Escrever com prévia
Cadastro, revisado, convênio, pedido de convênio, etiquetas e família.
- clientes_upsert
- clientes_marcar_revisado
- clientes_manage_convenio
- clientes_convenio_solicitacao
- clientes_manage_tags
- clientes_manage_relacionamento
Mesclar
Prévia por padrão; executa só com confirmação e semelhança mínima de 0,7.
- clientes_mesclar_duplicados
- POST /clientes/{id}/mergear/{id2}
API REST
Para integração sem IA: token da integração e chamadas HTTP. A referência completa vem com o acesso que a clínica concede.
Cadastro
Listar, buscar, ler, criar, editar e marcar como revisado.
- GET /clientes/
- GET /clientes/search/
- GET /clientes/{id}
- POST /clientes/
- PUT /clientes/{id}
- POST /clientes/{id}/review
Pelo telefone
O paciente de um número, sem devolver o número; ambíguo, devolve os candidatos e não escolhe.
- POST /clientes/resolver-telefone
Convênio, família e etiquetas
Carteirinhas, pedidos de convênio, vínculos e etiquetas.
- GET /clientes/convenio
- POST /clientes/convenio
- GET /clientes/convenio/solicitacao/pendentes
- POST /clientes/convenio/solicitacao/{id}/aprovar
- POST /clientes/convenio/solicitacao/{id}/rejeitar
- GET /clientes/{id}/relacionamentos
- POST /clientes/{id}/relacionamentos
- GET /clientes/{id}/tags
- POST /clientes/{id}/tags
- GET /clientes/tags/{tag}/clientes
token = post(AUTH, {"grant_type": "client_credentials",
"client_id": CLIENT_ID, "client_secret": CLIENT_SECRET})["access_token"]
r = post(f"{API}/clientes/resolver-telefone", token, {"telefone": "5548999990000"})
if r["ambiguo"]:
print("mais de um paciente com esse número:", [c["nome"] for c in r["candidatos"]])
elif r["candidatos"]:
paciente_id = r["candidatos"][0]["cliente_id"]
else:
# repetir a chamada com a mesma chave não cria outro cadastro
novo = post(f"{API}/clientes/", token, {"nome": "Marina Souza", "telefone": "5548999990000"},
headers={"Idempotency-Key": "lead-2026-11-11-0042"})
paciente_id = novo["id"]Regras
Busca enxuta
Listas e buscas devolvem id, nome, cidade e revisado; o resto só na ficha, com permissão própria.
CPF só na criação
Pela IA, o CPF entra ao criar e não se repete; corrigir CPF é pela Central.
- clientes_upsert
Fora da IA
Apagar paciente, apagar todas as etiquetas de uma vez e excluir carteirinha.
Peça à sua IA
Pela conexão MCP, a IA que a clínica preferir age com as permissões de quem pediu: só faz o que essa pessoa pode fazer na Central.
Segurança para médicos builders- "O laudo veio com o nome CUNHA, LEONARDO. Quem é?"clientes_find
- "Compara esses dois cadastros e mostra o que mudaria ao mesclar."clientes_analisar_duplicados
- "Liga a Ana como responsável pelo Lucas. Me mostra antes."clientes_manage_relacionamento
