Conectar o ChatGPT e o Claude

Conecte o Clinicar ao ChatGPT e ao Claude para consultar prontuários, arquivos autorizados e agendas.

O Clinicar MCP permite consultar pacientes e o contexto médico disponível no prontuário diretamente em assistentes de IA compatíveis com o Model Context Protocol (MCP).

A integração é somente leitura. Ela não cria, edita ou exclui informações no Clinicar.

O conector pode enviar ao assistente de IA dados completos de identificação e informações clínicas do paciente. Use somente contas e workspaces aprovados pela sua organização e confira as políticas de privacidade, retenção e uso de dados do provedor escolhido.

Antes de começar

Você precisa de:

uma conta ativa no Clinicar;
acesso à clínica que deseja conectar;
permissão para consultar os pacientes e prontuários envolvidos;
um plano do ChatGPT ou do Claude que aceite conectores MCP personalizados;
autorização da administração do workspace, quando exigida pelo provedor.

Use este endereço ao configurar o conector:

https://clinicar.app/api/mcp

Não é necessário criar uma chave de API. O assistente abrirá uma página segura do Clinicar para login e autorização por OAuth.

O que o conector pode consultar

As ferramentas disponíveis dependem dos acessos autorizados:

Prontuários: buscar pacientes, consultar uma visão inicial, percorrer o histórico por páginas e ler eventos completos.
Arquivos: solicitar um link temporário para baixar arquivos autorizados do paciente.
Agenda: consultar o resumo do dia, listar agendamentos e mostrar uma tabela. A tabela pode ser interativa nos clientes compatíveis, ou aparecer em Markdown.

A busca pode retornar dados completos de identificação. A leitura integral pode incluir notas privadas do próprio usuário e dados de gravações, conforme as permissões. O resumo inicial não representa todo o conteúdo disponível. Os links de arquivos expiram em cerca de dez minutos.

A consulta da agenda não retorna contatos, observações ou dados financeiros. Ela mantém as restrições de acesso às agendas do usuário.

Toda consulta respeita a clínica selecionada, o vínculo do usuário e as permissões já existentes no Clinicar. A conexão com uma clínica não concede acesso a outras clínicas da mesma conta.

Instalar no ChatGPT

A disponibilidade varia conforme o plano. O suporte completo a apps MCP está disponível para workspaces Business, Enterprise e Edu. Contas Pro podem usar conectores personalizados de leitura quando o modo de desenvolvedor estiver disponível.

1. Ativar o modo de desenvolvedor

No Business, um administrador ou proprietário deve habilitar o modo de desenvolvedor e criar o app em Configurações do workspace > Apps > Criar.

No Enterprise ou Edu, o administrador libera o acesso em Permissões e funções > Dados conectados. Usuários autorizados ativam o modo em Configurações > Apps > Configurações avançadas.

No Pro, confira a disponibilidade do modo de desenvolvedor para conexões de leitura. Os caminhos podem variar conforme o plano e a interface do provedor.

2. Criar o app do Clinicar

Acesse Apps > Criar nas configurações da conta ou do workspace, conforme seu acesso.
Informe um nome, como Clinicar.
Adicione o endpoint:
```
https://clinicar.app/api/mcp
```
Escolha OAuth como autenticação, se essa opção for solicitada.
Clique em Verificar ferramentas ou Scan tools.
Quando o Clinicar abrir, faça login, escolha a clínica e clique em Autorizar.
Confira as ferramentas autorizadas e conclua a criação. Em um workspace, o administrador publica o app para liberar o uso pela equipe.

3. Usar em uma conversa

Inicie uma nova conversa no ChatGPT.
Abra o menu de Apps ou ferramentas.
Selecione Clinicar.
Faça sua pergunta.

O ChatGPT pode pedir confirmação antes de usar a ferramenta. Revise a clínica conectada e o paciente selecionado antes de continuar.

No ChatGPT, conectores MCP personalizados são usados pela versão web. A interface, os nomes dos menus e a disponibilidade podem variar durante o período beta.

Instalar no Claude

Conectores personalizados estão disponíveis no Claude, Cowork e Claude Desktop nos planos Free, Pro, Max, Team e Enterprise. O plano Free permite um conector personalizado.

1. Adicionar o conector

Em contas pessoais, abra Customize > Connectors, clique em Add e escolha o conector personalizado Web. Informe o endereço https://clinicar.app/api/mcp e clique em Add.

Em Team ou Enterprise, o Owner ou Primary Owner adiciona o conector em Organization settings > Connectors. Depois, cada membro abre Customize > Connectors e clica em Connect.

2. Autorizar e usar

Clique em Connect para iniciar o login.
No Clinicar, escolha a clínica, confira as permissões e autorize.
Em uma conversa, abra o menu de ferramentas com + e habilite o conector.

Os nomes podem aparecer traduzidos. Conectores remotos são configurados pela conta do Claude, inclusive no Desktop. O arquivo claude_desktop_config.json é destinado a servidores locais.

O que acontece durante a autorização

O fluxo de autorização é o mesmo para os dois assistentes:

o assistente identifica que o endpoint exige autenticação;
o navegador abre a página de login do Clinicar;
você escolhe uma das clínicas às quais possui acesso;
o Clinicar mostra a permissão solicitada;
você autoriza os acessos solicitados, a prontuários, agenda ou ambos;
o assistente recebe uma credencial temporária e pode renová-la sem conhecer sua senha.

Você pode negar a autorização a qualquer momento. Se seu acesso à clínica for suspenso ou removido, a conexão deixa de acessar os dados dessa clínica.

Consultar a agenda

Com o acesso à agenda autorizado, pergunte:

Como está minha agenda hoje? Quantos pacientes estão previstos e qual é o último horário?

Mostre os agendamentos de amanhã em tabela.

Se essas ferramentas não aparecerem numa conexão antiga, atualize as ferramentas do app e reconecte para autorizar o acesso à agenda. No ChatGPT organizacional, um administrador pode precisar revisar e publicar a atualização.

Exemplos de perguntas sobre pacientes

Comece localizando o paciente:

Encontre os pacientes chamados Maria e me ajude a identificar a pessoa correta.

Busque o paciente pelo CPF 000.000.000-00.

Quando houver mais de um resultado, confirme os dados antes de pedir o prontuário:

Use o resultado com data de nascimento em 15/04/1984 e resuma os diagnósticos,
alergias e atendimentos recentes.

Outros exemplos:

Liste as alergias registradas e os diagnósticos ativos desse paciente.

Faça uma linha do tempo dos atendimentos recentes, sem inventar informações
que não estejam no prontuário.

Resuma o contexto clínico para uma passagem de caso e destaque informações
que precisam ser confirmadas por um profissional.

Respostas geradas por IA podem conter erros ou interpretações incompletas. Sempre confira as informações no prontuário original antes de tomar decisões clínicas.

Privacidade, auditoria e revogação

Os dados não são mascarados antes do envio ao assistente conectado.
O Clinicar registra no Histórico de ações buscas, leituras, downloads e consultas de agenda pelo MCP.
Tokens, termos pesquisados, CPF e conteúdo clínico não são gravados no evento de auditoria.
A conexão é somente leitura, mas o provedor de IA recebe o conteúdo necessário para responder.
Desconecte o Clinicar nas configurações do ChatGPT ou do Claude quando não precisar mais da integração.

Consulte as configurações do seu provedor para entender retenção de conversas, treinamento de modelos, controles administrativos e residência de dados.

Solução de problemas

O conector não encontra o servidor

Confira se o endereço é exatamente https://clinicar.app/api/mcp.
O endpoint precisa ser acessado por HTTPS.
Os conectores remotos do ChatGPT e do Claude.ai não acessam diretamente um servidor em localhost.
Se estiver testando um ambiente de desenvolvimento, use o MCP Inspector ou um túnel seguro compatível com o provedor.

Entre com uma conta que tenha vínculo ativo com pelo menos uma clínica.
Confirme que cookies estão permitidos para clinicar.app.
Reinicie a conexão pelo menu de Apps ou Conectores.

A ferramenta não aparece na conversa

Confirme que o app ou conector está habilitado para a conversa atual.
No ChatGPT, execute novamente a verificação das ferramentas.
No Claude, abra Pesquisar e ferramentas e ative o Clinicar.
Em workspaces organizacionais, confirme que o administrador publicou ou liberou o conector para seu usuário.

O paciente não aparece

Tente buscar por nome completo, e-mail, CPF, telefone, passaporte, código, data de nascimento ou responsável.
Verifique se você conectou a clínica correta.
Confirme se seu usuário possui permissão para visualizar esse paciente.

O prontuário retorna menos informações que a tela do Clinicar

O resumo inicial é limitado. Peça ao assistente que percorra o histórico por páginas e abra os eventos necessários. Ele pode solicitar o download de arquivos autorizados. Se essas ferramentas não aparecerem, atualize o conector, reconecte e confira os escopos concedidos. Continue conferindo o prontuário original ao revisar informações clínicas.

Informações técnicas para administradores

Item	Valor
Transporte	Streamable HTTP
Autenticação	OAuth 2.1 com PKCE
Registro do cliente	Dinâmico (DCR)
Escopos de leitura	`clinicar:patient-record:read` e `clinicar:appointments:read`, conforme a autorização
Renovação	OAuth `offline_access`
Operações	Somente leitura