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?".

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
- Abra Meu Perfil e localize o cartão Conector de IA (MCP).
- Clique em Gerar URL do conector.
- 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ão | O que faz |
|---|---|
| Gerar URL do conector | Cria 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. |
| Revogar | Desativa 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.

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
| Ferramenta | Responde |
|---|---|
get_network_health | Como está a rede — nota composta, as 4 camadas e a cobertura. |
get_health_trend | Quando degradou — a série histórica da nota. |
get_priority_list | O que atacar primeiro — cards e quedas coletivas ordenados. |
get_pon_incidents | Problemas coletivos de planta (incidentes de PON). |
get_pon_incident_detail | Quem está dentro de uma queda coletiva, casa a casa — nome do cliente, login e o valor medido de cada motivo. |
get_results_funnel | Se as regras geram ação real ou ruído — o funil de Resultados. |
get_subscriber_health | Como 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_subscriber | Acha 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.