Conector de IA (MCP)

Conecte seu cliente de IA (claude.ai, Claude Code, ChatGPT) ao Made4Graph e converse sobre a saúde da sua rede — com as suas permissões.

Conector de IA (MCP)

Menu: avatar do usuário → Meu Perfil → cartão Conector de IA (MCP)
Permissões usadas: as suas — o conector responde apenas o que o seu usuário pode ver (health.view, customers.view, …)

O Made4Graph expõe os dados de Saúde da Rede por MCP (Model Context Protocol), o padrão aberto que clientes de IA usam para consultar sistemas externos. Na prática: você cola uma URL pessoal no claude.ai, no Claude Code ou no ChatGPT e passa a perguntar em linguagem natural — "como está a saúde da rede?", "o que devo atacar primeiro?", "o cliente João tem caso aberto?".

Cartão Conector de IA no perfil

O conector é somente leitura: nenhuma ferramenta altera dados. E cada chamada chega à API com o seu token — o controle de acesso (RBAC) do sistema vale igual ao da tela.

Veja casos de uso do Conector de IA com oito conversas reais, a pergunta para copiar e a resposta de cada uma.

Gerar a sua URL

  1. Abra Meu Perfil e localize o cartão Conector de IA (MCP).
  2. Clique em Gerar URL do conector.
  3. Clique no ícone de copiar (Copiar URL) e guarde na hora — por segurança, ela não será exibida de novo (Guarde agora — a URL não será exibida de novo). Se perder, use Regenerar (invalida a atual).

A URL tem o formato https://seu-made4graph/mcp/<token> e embute um token pessoal. Trate-a como uma senha.

BotãoO que faz
Gerar URL do conectorCria a URL pessoal (primeira vez).
Regenerar (invalida a atual)Cria uma nova URL e invalida a anterior — refaça a configuração no cliente de IA.
RevogarDesativa o conector: a URL para de funcionar imediatamente.

Diferente do login da interface, o token do conector não expira por inatividade (o cliente de IA pode passar horas sem chamar). Por isso a revogação é manual: revogue ao suspeitar de vazamento ou ao trocar de máquina.

URL gerada no cartão Conector de IA

Na sua instalação, a URL começa com o endereço do seu servidor Made4Graph. A imagem acima é de um ambiente de demonstração.

Conectar no cliente de IA

claude.ai (web)

Settings → Connectors → Add custom connector → cole a URL pessoal.

Claude Code

claude mcp add --transport http made4graph-health https://seu-made4graph/mcp/<token>

ChatGPT

Adicione a URL como conector MCP em Settings → Connectors (recurso disponível conforme o plano).

Depois de conectar, teste com: "como está a saúde da rede?".

O que dá para perguntar

FerramentaResponde
get_network_healthComo está a rede — nota composta, as 4 camadas e a cobertura.
get_health_trendQuando degradou — a série histórica da nota.
get_priority_listO que atacar primeiro — cards e quedas coletivas ordenados.
get_pon_incidentsProblemas coletivos de planta (incidentes de PON).
get_pon_incident_detailQuem está dentro de uma queda coletiva, casa a casa — nome do cliente, login e o valor medido de cada motivo.
get_results_funnelSe as regras geram ação real ou ruído — o funil de Resultados.
get_subscriber_healthComo está um assinante — informe o cliente, o login, a ONU, o serial ou a CPE. Devolve o estado, o caso aberto, a cadeia, a Saúde da CPE, os casos resolvidos e o histórico de motivos. Sem nomes de responsáveis, notas, anexos, telefone nem endereço.
resolve_subscriberAcha um assinante (nome, login, documento) e diz quais módulos têm dado sobre ele.

Você pode pedir o recorte na própria pergunta: a série da nota cobre de 1 a 720 horas (padrão 24 h); a lista de prioridades traz até 50 itens (padrão 10); os incidentes de PON vêm ativos por padrão, ou resolvidos se você pedir; e o balanço de resultados cobre 7, 30 ou 90 dias (padrão 30). O cartão do perfil mostra Ativo desde… ou Nenhum conector ativo.

As respostas seguem a orientação de suporte N1: direto ao ponto, com a próxima ação sugerida — pensadas para quem atende o cliente ao telefone.

Endereço da URL (administrador)

A URL exibida no perfil usa o endereço público do sistema, configurado em Sistema → Configurações → Servidor (o mesmo usado pelo SSO). Se a URL aparecer com o endereço errado, corrija-o ali e gere a URL novamente.

Gerar e revogar o conector são eventos de autenticação auditados — aparecem nos Logs de Auditoria com o usuário, o IP e a data.

Privacidade na saúde do assinante

A ferramenta get_subscriber_health sempre retira da resposta nomes de responsáveis, nomes em eventos, notas internas, anexos, telefone e endereço — mesmo que o usuário do conector tenha health.view na tela. A IA externa recebe o que está errado e há quanto tempo, nunca quem atendeu nem o que foi conversado. Veja Saúde do assinante nas telas.

Nesta página