Conectar assistentes com MCP
Autorize assistentes externos a consultar prontuários e agendas da clínica via OAuth, respeitando suas permissões.
O Clinicar MCP permite consultar prontuários e agendas em assistentes externos. A conexão é somente leitura e respeita a clínica escolhida e as permissões do seu usuário.
Para configurar o ChatGPT ou o Claude, siga Conectar o ChatGPT e o Claude. O endereço do servidor é:
https://clinicar.app/api/mcpEscolher o acesso
O aplicativo pode solicitar leitura de prontuários, de agendamentos ou de ambos. Confira as permissões exibidas antes de autorizar.
| Acesso | O que o assistente pode consultar |
|---|---|
| Prontuários | Buscar pacientes, ler uma visão inicial do histórico, percorrer os eventos e consultar o conteúdo integral dos registros autorizados. |
| Agendamentos | Consultar o resumo do dia, listar horários e pacientes e apresentar uma tabela da agenda. |
Na agenda, o assistente não recebe contatos, observações, prontuário ou dados financeiros. Profissionais com acesso restrito às próprias agendas continuam sujeitos a essa restrição.
No prontuário, o resumo inicial é limitado. O assistente pode percorrer outras páginas e abrir eventos completos. Isso pode incluir notas privadas do próprio usuário e dados de gravações. Para arquivos do paciente, pode solicitar um link temporário de download, válido por cerca de dez minutos. Não guarde esse link como endereço permanente.
A conexão pode enviar identificação e conteúdo clínico ao provedor do assistente. Autorize apenas aplicativos e contas aprovados pela sua clínica. A leitura integral e o download de arquivos ampliam o conteúdo disponível além do resumo inicial.
Autorizar a conexão
- Inicie a conexão no aplicativo externo.
- Faça login no Clinicar, se solicitado.
- Escolha a clínica que deseja conectar e clique em Continuar.
- Em Autorizar conexão?, confira o nome do aplicativo, a clínica e as permissões solicitadas.
- Se a conexão solicitar acesso contínuo, a tela informa que ela poderá permanecer ativa até ser revogada.
- Clique em Autorizar, ou em Cancelar para recusar.
Uma conexão com uma clínica não concede acesso às demais clínicas da conta. Se o vínculo com a clínica deixar de estar ativo, a conexão perde acesso aos dados.
Usar e desconectar
Peça ao assistente para localizar o paciente e confirme a identificação antes de consultar o histórico. Para a agenda, você pode perguntar "Como está minha agenda hoje?" ou "Mostre os agendamentos de amanhã em tabela".
Se a conexão antiga não mostrar as ferramentas de agenda ou de leitura integral, atualize a lista de ferramentas no provedor. Pode ser necessário reconectar e autorizar os novos escopos. No ChatGPT organizacional, o administrador também pode precisar revisar e publicar a atualização do app.
O Histórico de ações registra buscas, leituras de prontuário, downloads e consultas à agenda. Os eventos de auditoria não armazenam tokens nem o conteúdo clínico retornado.
Desconecte o Clinicar nas configurações do assistente quando deixar de usar a integração.
MCP e API REST
Use MCP para consultas durante uma conversa. Para integrações que criam ou alteram dados por chamadas programáticas, consulte API REST.
Solução de problemas
| Situação | O que fazer |
|---|---|
| Sessão expirada | Entre novamente no Clinicar e reinicie a conexão no aplicativo externo. |
| Nenhuma clínica disponível | Peça ao administrador que confira seu vínculo e a situação da clínica. |
| Clínica incorreta | Desconecte no assistente e autorize novamente com a clínica correta. |
| Ferramenta ausente | Confira os escopos concedidos e atualize as ferramentas do conector. |
| Solicitação inválida ou expirada | Reinicie o fluxo no aplicativo externo. |
| Histórico incompleto | Peça ao assistente que percorra as próximas páginas e abra os eventos necessários. Confira o prontuário original. |