Conector MCP · Documentação

Conector Intervizio para Claude

Consulte e gira o Intervizio a partir do Claude (claude.ai, Claude Desktop, Claude Code): cada utilizador age com as suas próprias permissões e a organização escolhe as ações autorizadas.

Em resumo

  • Servidor MCP remoto (Streamable HTTP): https://api.intervizio.fr/mcp
  • Disponível no diretório de conectores do Claude: «Intervizio, servidor MCP da Deltinfo GROUP».
  • Ligação com a sua conta Intervizio (OAuth), sem instalação.
  • Leitura aberta na ativação; escrita fechada até um administrador a abrir, ferramenta a ferramenta.
  • Nenhuma conversa é recebida nem armazenada.

O que faz o conector

O Intervizio é uma plataforma de gestão de intervenções no terreno: pedidos de clientes, intervenções, técnicos, planeamento, relatórios, subcontratados e pré-faturação. O conector dá ao Claude acesso a estes dados, a seu pedido e com as suas permissões.

Exemplos: «Que intervenções estão previstas para amanhã?», «Resume o pedido 1234 e o seu histórico», «Planeia esta intervenção para quinta-feira às 9 h e atribui ao Julien», «Que horas extra aguardam a minha decisão?».

Pré-requisitos

  • Uma conta Intervizio ativa, com uma função que dê acesso aos dados em causa (o conector nunca alarga as suas permissões).
  • Um administrador da sua organização que tenha ativado o conector em Definições › API › Conector MCP.
  • Para as ações de escrita: esse mesmo administrador tem de as marcar na lista «Ferramentas abertas» do mesmo ecrã; estão fechadas por predefinição e podem ser reservadas a certas funções.
  • Uma conta Claude. Adicionar manualmente um conector personalizado exige um plano pago.

Ligar a partir do Claude

  1. 1. Abrir a ficha do Intervizio

    Clique no botão abaixo (ficha «Intervizio, servidor MCP da Deltinfo GROUP» do diretório de conectores do Claude) ou, no Claude: Definições › Conectores › Explorar e pesquise «Intervizio».

  2. 2. Autorizar

    Clique em Ligar: abre-se uma página do Intervizio. Identifique-se (com a autenticação de dois fatores, se estiver ativa), confirme a conta apresentada e clique em Autorizar.

  3. 3. Utilizar

    Na conversa, ative o Intervizio no menu de ferramentas e faça a sua pergunta.

Abrir a ficha no diretório do Claude

Adição manual (segunda opção)

Se preferir, ou se a ficha não estiver disponível no seu espaço: Definições › Conectores › Adicionar conector personalizado. Nome: Intervizio. URL do servidor MCP remoto: https://api.intervizio.fr/mcp. As designações exatas podem variar consoante a versão.

Documentação da Anthropic: adicionar um conector personalizado

Claude Code (linha de comandos)

Com uma chave API da organização (criada em Definições › API), que dá leitura e criação de pedidos; as outras ações exigem uma conta ligada:

claude mcp add --transport http intervizio https://api.intervizio.fr/mcp --header "Authorization: Bearer <clé API>"

Ferramentas disponíveis (58)

Lista gerada a partir do catálogo do servidor. As ferramentas de leitura ficam abertas na ativação; as de escrita permanecem fechadas até um administrador as abrir. Cada utilizador só vê as ferramentas das suas funções.

Pedidos

  • Leiturasearch_demandesPesquisar pedidos
  • Leituraget_demandeDetalhe de um pedido
  • Leituraget_demande_historyHistórico de um pedido
  • Escritacreate_demandeCriar um pedido
  • Escritaupdate_demandeAlterar um pedido
  • Escritacancel_demandeCancelar um pedido
  • Escritaadd_demande_noteAdicionar uma nota a um pedido

Intervenções

  • Leiturasearch_interventionsPesquisar intervenções
  • Leituraget_interventionDetalhe de uma intervenção
  • Escritacreate_interventionCriar uma intervenção
  • Escritaschedule_interventionPlanear uma intervenção
  • Escritaassign_technicianAtribuir um técnico
  • Escritacancel_interventionCancelar uma intervenção
  • Escritarespond_to_missionAceitar ou recusar uma missão
  • Escritastart_interventionIniciar uma intervenção
  • Escritacomplete_interventionEncerrar uma intervenção

Relatórios

  • Leituraget_report_formLer o formulário do relatório
  • Escritasubmit_report_answersPreencher o relatório
  • Escritaregenerate_report_documentsRegenerar os documentos
  • Leituraget_report_documentsLinks do relatório e do auto

Planeamento e técnicos

  • Leituraget_planningPlaneamento
  • Leituralist_techniciansTécnicos e disponibilidade
  • Leituraget_technician_availabilityHorários ocupados de um técnico
  • Leituralist_absencesAusências
  • Escritacreate_absenceCriar uma ausência
  • Escritacancel_absenceCancelar uma ausência

Clientes, locais e contratos

  • Leiturasearch_clientsPesquisar clientes
  • Leituraget_clientFicha de cliente
  • Escritacreate_clientCriar um cliente
  • Escritaupdate_clientAlterar um cliente
  • Leituralist_sitesLocais
  • Escritacreate_siteCriar um local
  • Escritaupdate_siteAlterar um local
  • Leituralist_contractsContratos

Mercado de ofertas

  • Leituralist_market_offersOfertas do mercado
  • Escritarespond_to_market_offerResponder a uma oferta

Despesas de intervenção

  • Leituralist_extra_costsDespesas de uma intervenção
  • Escritadeclare_extra_costDeclarar uma despesa
  • Escritadecide_extra_costAprovar ou recusar uma despesa

Horas extra

  • Leituralist_pending_overtimeHoras extra por decidir
  • Escritavalidate_overtimeValidar ou recusar horas extra

Pré-faturação e faturas

  • Leituralist_my_prebillingsAs minhas pré-faturas (subcontratado)
  • Escritaaccept_prebilling_rateAceitar uma tarifa (subcontratado)
  • Escritaanswer_prebilling_disputeResponder a uma contestação (subcontratado)
  • Leituralist_subcontractor_prebillingsPré-faturas de subcontratados
  • Escritavalidate_subcontractor_prebillingValidar uma pré-fatura de subcontratado
  • Escritadispute_subcontractor_prebillingContestar uma pré-fatura de subcontratado
  • Leituralist_subcontractor_invoicesFaturas de subcontratados
  • Leituraget_subcontractor_invoiceFatura de subcontratado e o seu PDF
  • Escritasend_subcontractor_invoices_to_qontoEnviar faturas de subcontratados para a Qonto
  • Leituralist_client_prebillingsPré-faturação de clientes
  • Leituralist_invoicesFaturas

Encomendas

  • Leituralist_shipmentsEncomendas
  • Escritaadd_shipment_trackingAdicionar um seguimento

Notificações

  • Leituralist_notificationsAs minhas notificações
  • Escritamark_notifications_readMarcar como lidas

Indicadores

  • Leituraget_kpiIndicadores

Conta

  • Leituraget_my_contextQuem sou eu

Segurança

  • Funções: cada ferramenta só é proposta às funções em causa, e a base de dados continua a decidir cada chamada, exatamente como na aplicação.
  • Isolamento por organização: uma chamada não pode ler nem escrever dados de outra organização.
  • Permissões da conta ligada: o servidor age com o token do utilizador, nunca com um acesso de administração geral.
  • Escrita: fechada por predefinição; um administrador da organização marca as ferramentas pretendidas em «Ferramentas abertas» (Definições › API › Conector MCP); limitada a 20 escritas por minuto e por utilizador.
  • Confirmação antes de escrever: o servidor pede ao Claude que lhe faça confirmar a ação exata antes de qualquer ferramenta que altere dados; o Claude pode ainda pedir-lhe que aprove cada chamada.
  • Registo: cada chamada a uma ferramenta fica registada (ferramenta, resultado, duração), nunca os argumentos nem os dados devolvidos.
  • Nunca expostos: utilizadores e funções, definições, chaves API, subscrição, eliminação definitiva, exportação RGPD, mensagens cifradas.

Desligar e revogar

  • No Claude: remova o conector Intervizio nas definições dos conectores.
  • Administrador do Intervizio: Definições › API › Conector MCP, desativar o conector; todas as chamadas são recusadas de imediato, para toda a organização.
  • Para fazer revogar a autorização de uma conta, escreva ao suporte (abaixo).

Suporte

Uma dúvida, um bloqueio ou um pedido de revogação: [email protected] (DELTINFO, 51 Avenue de la Côte de Nacre, 14000 CAEN, França).

Política de privacidade do conector