Nextvisit

Assistentes com suporte a MCP conectam-se uma única vez, depois leem dados estruturados do prontuário e gravam de volta por meio de ferramentas tipadas. O mesmo escopo de workspace das chaves de API e OAuth se aplica. PHI nunca sai do limite do workspace.

Endpoint do servidor

https://nextvisit.app/mcp/clinic

O transporte é HTTPS. A autenticação é OAuth 2.0: seu cliente MCP abre um navegador, você faz login no Nextvisit e aprova a conexão na mesma tela de consentimento usada para aplicativos OAuth, e o cliente armazena o token resultante. Não há chave de API para colar, copiar ou rotacionar manualmente. O servidor suporta as três classes de operação MCP:

• Interativo: ferramentas que retornam um bloco de UI do Nextvisit incorporado (um cartão de paciente, uma lista de pacientes recentes) inline na resposta do assistente.
• Leitura: ferramentas tipadas que buscam pacientes, atendimentos, notas, documentos, medicamentos e linhas do tempo como JSON estruturado.
• Gravação: ferramentas tipadas que criam pacientes, editam conteúdo de atendimento não assinado e linha do tempo, vinculam ou desvinculam associações de pacientes, gerenciam instruções de notas e assinam ou desassinam um atendimento.

O que você precisa primeiro

1. Uma conta Nextvisit com acesso ao workspace que você deseja que o assistente leia ou grave.
2. Um cliente com suporte a MCP. Claude desktop, Claude na web, ChatGPT, Cursor, Continue e a maioria dos runtimes LLM locais (Ollama, LM Studio, Open WebUI) suportam servidores MCP remotos com OAuth.

Se o administrador do seu workspace desativou o acesso a aplicativos externos para o workspace, a tela de consentimento OAuth recusará a conexão. Entre em contato com ele ou com nossa equipe de suporte para ativá-lo.

Fluxo de trabalho de conexão MCP: insira o endpoint, aprove os escopos do workspace e use ferramentas com escopo

Conectando o Claude

Os clientes desktop e web do Claude suportam servidores MCP remotos como Conectores Personalizados.

1. Abra Configurações > Conectores no Claude.
2. Clique em Adicionar conector personalizado.
3. Nomeie-o como Nextvisit.
4. Defina a URL do servidor MCP como https://nextvisit.app/mcp/clinic.
5. Clique em Conectar. Uma janela do navegador abre na tela de consentimento OAuth do Nextvisit.
6. Faça login no Nextvisit (se ainda não estiver conectado), escolha o workspace que o conector deve ver e revise os escopos que o assistente está solicitando. Clique em Permitir.
7. O navegador devolve você ao Claude. As ferramentas aparecem sob o conector Nextvisit e ficam disponíveis para qualquer conversa do Claude em que você ativar o conector.

Os mesmos passos funcionam em qualquer lugar onde o Claude expõe um campo de Conector Personalizado. Revogue em Configurações > Aplicativos Externos no Nextvisit. O título da página é Autenticação.

Conectando outros clientes

Qualquer cliente que suporte servidores MCP remotos autenticados por OAuth funciona. Insira a URL; o cliente conduz o fluxo no navegador.

• ChatGPT: Adicione como um conector MCP personalizado em Configurações > Conectores no ChatGPT. Cole a URL e conclua o fluxo OAuth na janela pop-up.
• Cursor, Continue, Zed e outros clientes IDE: Adicione a URL ao bloco mcpServers do arquivo de configuração do cliente. Na primeira chamada, o cliente abre o fluxo OAuth no seu navegador padrão e armazena em cache o token resultante.
• Runtimes LLM locais: Ollama, LM Studio e Open WebUI aceitam endpoints MCP remotos no painel de configurações MCP. Cada cliente suporta servidores MCP remotos autenticados por OAuth; consulte a documentação MCP do runtime para o formato atual.

Se o seu cliente suporta apenas servidores MCP que autenticam com um token estático do tipo bearer, ele não pode se conectar ao servidor MCP do Nextvisit. O endpoint é exclusivo para OAuth e não aceita chaves de API de longa duração.

Ferramentas disponíveis

O servidor MCP oferece a mesma superfície de ferramentas que alimenta os recursos de IA do próprio Nextvisit. Agrupadas por classe de operação:

Interativo

• recent_patients: Retorna os pacientes mais recentemente atualizados do workspace atual como um bloco de UI incorporado.
• fetch_patient: Busca um paciente por MRN ou UUID. Retorna detalhes do prontuário e uma exibição de paciente incorporada.

Leitura

• fetch_encounter: Informações detalhadas do atendimento. Modos de visualização: full, content, transcript, context.
• search_encounters: Busca por nome do paciente, conteúdo do atendimento ou palavra-chave. Suporta filtros de intervalo de datas e paginação.
• utility_global_search: Busca em todo o sistema por pacientes, atendimentos e documentos. Suporta busca por frase ([exact phrase]) e busca negativa (-term).
• fetch_patient_medications: Lista de medicamentos atuais e históricos, incluindo dosagem, frequência, classificação, prescritor e status.
• fetch_patient_timeline: Histórico de visitas do paciente como uma linha do tempo cronológica de atendimentos.
• fetch_document: Recupera um documento enviado por ID. Suporta leitura completa com paginação ou busca por frase dentro do documento.
• manage_note_instructions (ação get): Lê suas instruções personalizadas de geração de notas de IA.
• manage_patient_chart_notes (ação get): Lê as notas persistentes do prontuário de um paciente.

Gravação

• create_patient: Cria um novo registro de paciente. Sempre busque primeiro para evitar duplicatas. Nome e sobrenome são obrigatórios; dados demográficos, alergias, medicamentos e notas persistentes são opcionais.
• edit_encounter: Edita content (documentação clínica) ou transcript em um atendimento não assinado. Três operações: str_replace, insert (antes ou depois de uma âncora) e regex.
• edit_encounter_timeline: Edita ou adiciona eventos na linha do tempo de um atendimento.
• link_patient_to_encounter: Vincula ou desvincula a associação de paciente em um atendimento.
• sign_encounter: Assina (bloqueia) ou desassina (desbloqueia) um atendimento. Apenas o criador do atendimento pode executar esta ação.
• manage_note_instructions (ação update): Substitui, adiciona, antepõe ou limpa suas instruções de notas de IA.
• manage_patient_chart_notes (ação update): Substitui, adiciona, antepõe ou limpa as notas persistentes do prontuário de um paciente.

O servidor retorna JSON estruturado.

Como é uma chamada do assistente

Um fluxo de leitura típico do Claude:

User: "What did Dr. Patel see Jane Doe for in April?"

Claude calls search_encounters(query="Jane Doe", date_from="2026-04-01", date_to="2026-04-30")
→ returns a list of encounter IDs with dates and titles.

Claude calls fetch_encounter(id="enc_a1b2", view="content")
→ returns the merged clinical note for that encounter.

Claude summarizes the visit back to you.

Um fluxo de gravação típico:

User: "Add 'patient declined PHQ-9 today' to the timeline on encounter 41822."

Claude calls edit_encounter_timeline(encounter_id=41822, action="add",
  find="Patient declined PHQ-9 today")
→ event appears on the encounter timeline.

Cada chamada carrega o escopo do workspace. O assistente não pode ver ou modificar prontuários em outro workspace.

Permissões e auditoria

• As chamadas de ferramentas obedecem ao mesmo limite de workspace do restante da plataforma. Sem leituras entre workspaces, nunca.
• Os escopos são concedidos no momento do consentimento OAuth e você pode revisá-los antes de aprovar. Escopos de leitura desbloqueiam as ferramentas de leitura e interativas; escopos de gravação desbloqueiam adicionalmente create_patient, edit_encounter, edit_encounter_timeline, link_patient_to_encounter, sign_encounter e as operações de atualização de manage_*. Uma chamada de ferramenta que exceda o escopo concedido retorna 403 e nunca modifica dados.
• sign_encounter é adicionalmente restrito ao criador do atendimento.
• edit_encounter só funciona em atendimentos não assinados. Desassine primeiro, edite e depois reassine.
• Cada chamada MCP é registrada no log de auditoria do workspace com o timestamp, o aplicativo conectado, o nome da ferramenta e o ID do recurso afetado.
• Você pode revogar a conexão a qualquer momento em Configurações > Aplicativos Externos. A revogação invalida o token imediatamente; chamadas subsequentes desse cliente retornam 401 até você reautorizar.

Privacidade

O servidor MCP faz parte do seu workspace Nextvisit e opera sob o mesmo Contrato de Associado de Negócios. PHI retornada ao assistente é regida pelo próprio tratamento de dados do fornecedor do assistente, portanto, ao conectar Claude, ChatGPT ou qualquer modelo de terceiros, os dados do prontuário do seu workspace estão sujeitos aos termos desse fornecedor durante a conversa.

Para workspaces da 42 CFR Part 2, o acesso MCP segue as mesmas portas de consentimento do OAuth e aplicativos externos. Consulte o guia da 42 CFR Part 2 para a política completa.

Solução de problemas

Falha na autenticação ou erros 401

O token armazenado expirou ou a conexão foi revogada. Desconecte e reconecte o conector Nextvisit no seu cliente para executar o fluxo OAuth novamente. Você pode confirmar se a conexão ainda está ativa em Configurações > Aplicativos Externos no Nextvisit.

Pop-up OAuth bloqueado

Alguns navegadores bloqueiam o pop-up OAuth na primeira vez. Permita pop-ups para o domínio do cliente (para Claude na web, isso é claude.ai) e tente a conexão novamente.

A lista de ferramentas não aparece

O cliente armazenou em cache uma lista vazia de ferramentas. Desconecte e reconecte o conector Nextvisit ou reinicie o cliente. Conectores Personalizados no Claude são atualizados na reconexão.

"Não é possível editar um atendimento assinado. Desassine-o primeiro."

Chame sign_encounter com status: "unsigned" primeiro (você deve ser o criador), faça as edições e depois reassine.

"Paciente não encontrado"

Confirme se o MRN ou UUID é do mesmo workspace que você aprovou ao conectar o assistente. MRNs têm escopo de workspace, então o mesmo número pode existir em dois workspaces diferentes e apontar para pacientes diferentes.

Entre em contato com o suporte para configuração, escopos ou um workspace de sandbox se você não quiser testar com prontuários reais.