Ir para conteúdo principal

Visão geral do Provet MCP

O Provet MCP é um servidor público que dá à sua ferramenta de IA — Claude, ChatGPT, Gemini, Microsoft Copilot ou qualquer cliente compatível com MCP — acesso apenas de leitura aos seus dados de relatórios do Provet. O Provet fornece os dados; a sua ferramenta de IA faz a análise. Ligue-a uma vez e, depois, faça perguntas em linguagem natural à sua ferramenta de IA sobre os dados da sua clínica.

Nota: Se não encontrar o Provet MCP nas configurações de Acesso aberto à API, contacte o administrador da sua clínica.

O que faz o Provet MCP

O Provet MCP dá à sua ferramenta de IA acesso apenas de leitura aos seus dados do Provet. O Provet fornece os dados; a sua ferramenta de IA interpreta-os, resume-os e responde a perguntas complementares.

O Provet MCP abrange as seguintes áreas de dados:

  • Faturação

  • Devedores

  • Pagamentos

  • Marcações

  • Clientes e pacientes

  • Planos de saúde

  • Atividade clínica

  • Catálogo

O Provet MCP funciona em conjunto com os relatórios que já utiliza no Provet. Não os substitui.

Se preferir fazer perguntas sobre os dados da sua clínica sem ligar uma ferramenta de IA externa, utilize antes o Pergunte ao Provet. O Pergunte ao Provet está integrado na secção Relatórios do Provet e não requer configuração. Utilize o Provet MCP quando quiser trabalhar na sua própria ferramenta de IA.

Antes de começar

O Provet MCP tem de estar ativado para a sua clínica antes de se poder ligar a ele.

Para utilizar o Provet MCP, precisa de uma das seguintes opções:

  • O papel de Administrador no Provet

  • Pertencer ao grupo de pessoal «Provet MCP» da sua organização, criado quando o Provet MCP é ativado

  • Partilhar uma clínica com esse grupo

Nota: A extensão do navegador não é compatível com o Provet MCP.

Ativar o Provet MCP para a sua clínica

  1. Selecione o nome da localização da clínica, no canto superior esquerdo, e depois selecione Configurações.

  2. Selecione Geral > Integrações > Acesso aberto à API. Esta ação abre a página Definições de API, onde Acesso aberto à API é uma das secções.

  3. Selecione Adicionar aplicação.

  4. Localize o Provet MCP no catálogo e selecione o botão ao lado. O catálogo está organizado por ordem alfabética e distribui-se por várias páginas, pelo que o Provet MCP não se encontra na primeira página. Utilize os números das páginas na parte inferior da janela de diálogo.

  5. Selecione Guardar.

O Provet MCP aparece agora na sua lista de Aplicações, ativado para a sua organização.

O Provet MCP acede aos seus dados através de um utilizador virtual chamado Integration Provet MCP. Não precisa de criar nem gerir este utilizador. Para o ver, selecione o botão de lista na linha do Provet MCP; também pode ver o URL do ponto de acesso.

Ligar a sua ferramenta de IA

O ponto de acesso do Provet MCP é: https://mcp.provetcloud.app/mcp/

Se tiver um plano individual Claude Pro ou Max

  1. Selecione Configurações e, em seguida, selecione Conectores em Personalizar.

  2. Selecione o botão de mais (+) e, em seguida, selecione Adicionar conector personalizado.

  3. Dê ao conector o nome Provet e cole o URL https://mcp.provetcloud.app/mcp/.

  4. Selecione Adicionar.

Se a sua organização utilizar o Claude Team ou Enterprise

Apenas o proprietário de uma conta Claude pode adicionar um novo conector personalizado a uma organização Team ou Enterprise. Se não for o proprietário, peça-lhe que conclua primeiro o passo de configuração abaixo.

Configuração (apenas para o proprietário da conta Claude):

  1. Selecione Configurações da organização > Conectores.

  2. Selecione Adicionar.

  3. Aponte para Personalizado e, em seguida, selecione Web.

  4. Selecione Adicionar.

Ligar (para todos os restantes membros da organização):

  1. Selecione Configurações e, em seguida, selecione Conectores em Personalizar.

  2. Localize Provet na lista. Está identificado como Personalizado.

  3. Selecione Ligar.

Se utilizar o ChatGPT

É necessário ativar o modo de programador do ChatGPT antes de poder adicionar o Provet MCP.

  1. Abra o ChatGPT num navegador, selecione o seu perfil e, em seguida, selecione Configurações > Conectores.

  2. Abra Avançadas e ative Modo de programador.

  3. Volte a Conectores e selecione Criar.

  4. Cole o URL https://mcp.provetcloud.app/mcp/ e, em seguida, selecione Criar.

Se tiver um plano Google AI Ultra (Gemini Spark)

As aplicações personalizadas do Gemini requerem o Gemini Spark, incluído no plano Google AI Ultra. Só é possível adicionar uma aplicação personalizada na aplicação web do Gemini, não na aplicação móvel.

  1. Aceda a gemini.google.com num navegador.

  2. Selecione Configurações e ajuda na parte inferior do menu à esquerda e, em seguida, selecione Aplicações ligadas. Se não encontrar esta opção, procure primeiro em Inteligência pessoal.

  3. Em Aplicações personalizadas para o Spark, selecione Adicionar uma aplicação personalizada.

  4. Cole o URL https://mcp.provetcloud.app/mcp/ no campo URL do servidor MCP e, em seguida, selecione Seguinte.

Depois de se ligar na aplicação web, o Provet também funciona na aplicação móvel do Gemini.

Nota: As aplicações personalizadas ligadas estão disponíveis em contas Google pessoais nos Estados Unidos e em inglês. As contas profissionais e escolares não são compatíveis.

Se utilizar o Microsoft Copilot

O Microsoft Copilot não tem um campo para colar o URL de um servidor MCP. Em vez disso, o administrador de TI adiciona o Provet MCP a um agente no Microsoft Copilot Studio, e os utilizadores do Copilot acedem aos dados do Provet através desse agente.

Nota: É necessária uma licença do Copilot Studio para criar o agente. Todos os utilizadores do agente precisam de uma licença do Microsoft 365 Copilot.

O administrador de TI deve seguir estes passos:

  1. Inicie sessão no Microsoft Copilot Studio em copilotstudio.microsoft.com.

  2. Abra o agente ao qual pretende ligar o Provet ou selecione Criar > Agente novo.

  3. Aceda à página Ferramentas do agente e, em seguida, selecione Adicionar uma ferramenta.

  4. Selecione Nova ferramenta e, em seguida, selecione Model Context Protocol.

  5. Introduza Provet como nome do servidor, adicione uma descrição breve do servidor e cole o URL https://mcp.provetcloud.app/mcp/ no campo URL do servidor.

  6. Selecione OAuth 2.0 como tipo de autenticação. O Provet MCP é adicionado apenas com o URL do servidor, sem necessidade de introduzir um ID de cliente ou um segredo. Por isso, selecione a opção de descoberta dinâmica, se o Copilot Studio a disponibilizar.

  7. Selecione Criar e, em seguida, selecione Seguinte.

  8. Selecione Criar uma nova ligação, inicie sessão com os seus dados do Provet e, em seguida, selecione Adicionar ao agente.

Depois de publicar o agente no Microsoft 365 Copilot, os utilizadores podem fixá-lo e fazer perguntas sobre os dados do Provet através da conversa.

Utilizar um ficheiro de configuração (para ferramentas de programador)

Utilize esta opção para ferramentas orientadas para programadores, como Claude Code, Cursor ou Codex.

Adicione o servidor à configuração MCP, em mcpServers:

{

"mcpServers": {

"provet": {

"type": "http",

"url": "https://mcp.provetcloud.app/mcp"

}

}

}

Concluir a ligação

Siga estes passos depois de se ligar através do Claude, ChatGPT, Gemini ou de um ficheiro de configuração.

  1. Quando abrir uma janela do navegador, cole qualquer URL da sua sessão atual do Provet. Isto permite ao conector identificar a clínica e a organização a que pertence.

  2. Selecione Autorizar.

O acesso é concedido automaticamente se tiver autorização para utilizar o Provet MCP.

Sugestões de prompts

Não precisa de uma competência para começar a utilizar o Provet MCP. Depois de ligar a sua ferramenta de IA, pode fazer perguntas diretamente. Estes prompts são um bom ponto de partida.

Receitas e serviços

  • «Como correu o mês passado?»

  • «Mostra-me as receitas de cada um dos últimos 12 meses.»

  • «Quais dos nossos serviços geram mais receitas?»

  • «Compara este mês com o mesmo mês do ano passado.»

  • «Qual das nossas localizações está a ter melhores resultados?»

Valores em dívida

  • «Quanto dinheiro nos devem neste momento?»

  • «Quais são os nossos 10 principais clientes por montante em dívida?»

  • «Qual é o montante em dívida há mais de 90 Dias?»

  • «Que montante estamos a aguardar das companhias de seguros?»

  • «Prepara uma lista de cobrança: todos os que devem mais de 200 € há mais de 60 Dias.»

  • «Em média, quanto tempo demoram os clientes a pagar-nos?»

Marcações e agenda

  • «Quais são os dias mais movimentados da semana?»

  • «Quantas faltas às marcações tivemos no mês passado?»

  • «Quais são os motivos mais comuns para o cancelamento de marcações?»

  • «Quanto tempo esperam os clientes entre a chegada e o atendimento?»

  • «Quantas marcações tem cada veterinário este mês?»

  • «Compara o número de marcações deste trimestre com o do trimestre passado.»

Clientes e pacientes

  • «Quantos clientes novos tivemos em cada mês deste ano?»

  • «Que pacientes não são atendidos há mais de um ano?»

  • «Qual é a distribuição entre cães, gatos e outras espécies?»

Planos de saúde

  • «Quantas subscrições ativas de planos de saúde temos?»

  • «Os membros dos nossos planos de saúde estão realmente a utilizar o que está incluído?»

  • «Quantos planos de saúde têm pagamentos em atraso?»

  • «Quais são os planos de saúde mais cancelados e porquê?»

Se também utilizar outros conectores, como software de contabilidade, pode fazer perguntas que abranjam ambos numa única conversa — por exemplo, comparar as receitas da clínica com os custos.

As competências iniciais baseiam-se nestes prompts e devolvem sempre o mesmo relatório, com uma estrutura consistente.

Transferir e utilizar competências iniciais

As competências são instruções prontas a utilizar que fornece à sua ferramenta de IA, para que esta apresente sempre o mesmo tipo de relatório para a mesma pergunta. Cada competência é um único arquivo que inclui a análise que a ferramenta de IA deve executar e prompts iniciais que pode copiar.

Transfira as cinco competências iniciais ou consulte-as individualmente na Biblioteca de competências do Provet MCP.

Competência

O que abrange

Experimente perguntar

Avaliação da saúde da clínica

Receitas comparadas com o mês passado e com o mesmo mês do ano passado, contagem de faturas, os 5 principais serviços e contagem de consultas.

«Faz a avaliação da saúde da minha clínica para o mês passado.»

Receber pagamentos

Quem deve mais, há quanto tempo existe a dívida, divisão entre seguros e clientes e média de dias até ao pagamento.

«Quem nos deve dinheiro? Faz uma análise dos devedores.»

Marcações e agenda

Dias e horas mais movimentados, padrões de faltas e cancelamentos e tempos de espera.

«Analisa a minha agenda dos últimos três meses.»

Clientes, pacientes e planos de saúde

Novos clientes, pacientes inativos para campanhas de convocação, utilização dos planos de saúde e pagamentos em atraso.

«Como está a nossa base de clientes este ano?»

Analista de dados da clínica (agente)

Responde a perguntas sobre todas as áreas acima, para quem preferir não escolher apenas uma competência.

«Tenho 10 minutos. Dá-me um resumo da situação da clínica.»

Carregar uma competência na ferramenta de IA

Claude

  • Adicione-a a um projeto: selecione Projetos e crie um projeto novo. Cole o conteúdo do arquivo da competência nas instruções personalizadas do projeto ou carregue o arquivo para a base de conhecimentos do projeto. Todas as conversas nesse projeto passam a seguir a competência.

Utilize o arquivo do agente da mesma forma, num projeto próprio (por exemplo, «Analista da clínica»).

ChatGPT

  • Crie um projeto e cole o conteúdo do arquivo da competência nas instruções ou anexe o arquivo e peça ao ChatGPT que o siga.

  • Em alternativa, crie um GPT personalizado (Explorar GPTs > Criar > Configurar) e utilize o conteúdo da competência como instruções.

Gemini

  • Abra o gestor de Gems, selecione Nova Gem, cole o conteúdo da competência nas instruções da Gem, guarde e, em seguida, converse com essa Gem.

Recomendamos utilizar uma competência por projeto, GPT ou Gem, além de um assistente geral criado a partir do arquivo do agente.

Exemplos de utilização

Análise mensal da clínica

Para um proprietário de clínica, na primeira segunda-feira do mês.

Pergunte: «Faz a avaliação da saúde da minha clínica para o mês passado.»

Recebe: receitas comparadas com o mês anterior e com o mesmo mês do ano passado, contagem de faturas, os 5 principais serviços e contagem de consultas.

Reduzir os valores em dívida

Para um gestor de clínica, como rotina semanal.

Pergunte: «Prepara a lista de cobrança desta semana.»

Recebe: quem deve mais, há quanto tempo existe a dívida, a divisão entre seguros e clientes e a média de dias até ao pagamento.

Organizar a agenda da equipa

Para um gestor que planeia os horários de trabalho.

Pergunte: «Quando temos mais movimento e onde estamos a perder faixas horárias?»

Recebe: os dias e as horas mais movimentados, além dos padrões de faltas e cancelamentos.

Preencher semanas tranquilas com chamadas de seguimento

Para as equipas de receção ou enfermagem.

Pergunte: «Encontra os pacientes que não vemos há mais de um ano.»

Recebe: uma lista de pacientes inativos para campanhas de lembretes e de convocação para vacinação.

Revisão trimestral dos planos de saúde

Para um proprietário de clínica.

Pergunte: «Analisa os nossos planos de saúde — estão a funcionar?»

Recebe: subscrições ativas, utilização, pagamentos em atraso e os principais motivos de cancelamento.

Combinar fontes de dados

Para clínicas que também utilizam outros conectores, como software de contabilidade.

Pergunte algo que envolva vários sistemas numa única conversa — por exemplo, compare as receitas da clínica com os custos.

Perguntas frequentes

Que ferramentas de IA são compatíveis com o Provet MCP?

Qualquer cliente compatível com MCP, incluindo Claude, ChatGPT, Gemini e Microsoft Copilot.

O Provet MCP só permite leitura?

Sim. O Provet MCP não pode alterar os seus dados do Provet.

Quem pode estabelecer ligação?

Qualquer pessoa com o papel de Administrador, que pertença ao grupo de pessoal «Provet MCP» da sua organização ou que partilhe uma clínica com esse grupo.

Não encontro a opção para adicionar um conector personalizado no Claude

Se a sua organização utilizar um plano Claude Team ou Enterprise, apenas o proprietário da sua conta Claude pode adicionar um novo conector personalizado. Peça-lhe que conclua o passo de configuração descrito acima em Ligar a sua ferramenta de IA. Depois de o adicionar, poderá ligar-se ao conector.

Vejo a mensagem «Esta clínica não está configurada para o Provet MCP»

O Provet MCP ainda não foi ativado para a sua clínica. Um administrador da clínica tem de o adicionar em Configurações > Geral > Integrações > Acesso aberto à API. Contacte o administrador da sua clínica.

Tenho acesso, mas continuo sem conseguir ligar-me

Por predefinição, apenas o papel integrado de Administrador tem acesso. Um papel de administrador personalizado criado pela sua organização não tem acesso. Peça ao administrador da sua clínica para o adicionar ao grupo de pessoal «Provet MCP».

O Provet MCP inclui dados históricos migrados?

Não, pelo menos a curto ou médio prazo.

Porque é que os valores podem ser diferentes dos de um relatório que já utilizo?

O Provet MCP inclui apenas faturas finalizadas e inclui notas de crédito, tal como os relatórios do próprio Provet calculam os totais.

Consulte também

Isto respondeu à sua pergunta?