Como conectar o MCP Server da Nvoip ao ChatGPT
OAuth compartilhado e descoberta
O servidor MCP usa https://mcp.nvoip.com.br/mcp e anuncia https://api.nvoip.com.br/auth como servidor OAuth. Use a descoberta do cliente, PKCE e consentimento; no Claude, informe somente a URL, deixe Client ID/Secret vazios e clique em Connect. A audiência e os escopos do MCP são próprios: o token MCP não é um token genérico da API v3. Para integrar a API por backend, consulte o guia v3. Respeite a expiração informada em expires_in.
Este artigo mostra como conectar o MCP Server da Nvoip ao ChatGPT quando a conta ou workspace tem suporte a apps/conectores MCP.
Importante: o MCP Server está disponível para clientes no Plano Pro e para revendedores Tier IV, V e VI. Usuários secundários precisam ter a permissão MCP Server habilitada no painel.
1. Quando usar com ChatGPT
Use esse fluxo para consultar relatórios, métricas e análises da conta Nvoip em linguagem natural, respeitando permissões e escopo da conta autenticada.
2. Antes de começar
| Requisito | Detalhe |
|---|---|
| Plano | Conta no Plano Pro ou revendedor Tier IV, V ou VI. |
| Permissão | Usuário principal Pro pode acessar. Usuários secundários precisam da permissão MCP Server. |
| Cliente MCP | ChatGPT ou ambiente compatível com servidor MCP remoto. |
| Autenticação | OAuth: o cliente MCP abre o login da Nvoip no navegador e renova o acesso sozinho. Não é preciso gerar token no painel. |
3. Dados de conexão
| Campo | Valor |
|---|---|
| URL do servidor MCP | https://mcp.nvoip.com.br/mcp |
| Autenticação | OAuth (login da Nvoip no navegador). Token colado à mão só para testes: vale 24 horas e depois para de funcionar. |
| Configuração | Apps & Connectors > adicionar conector remoto com a URL e concluir o login. |
| Metadados OAuth | https://api.nvoip.com.br/auth/.well-known/oauth-authorization-server |
| Recurso protegido | https://mcp.nvoip.com.br/.well-known/oauth-protected-resource/mcp |
4. Passo a passo
- No painel da Nvoip, abra Integrações e acesse MCP Server Nvoip.
- Confirme se a conta está no Plano Pro ou, no caso de revendedor, nos Tiers IV, V ou VI.
- Confira no painel da Nvoip se sua conta é elegível ao MCP Server. Não é preciso gerar token.
- No ChatGPT, abra as configurações de Apps ou Conectores. O nome da área pode variar conforme plano e rollout.
- Adicione um app/conector MCP remoto usando a URL do servidor da Nvoip.
- Conclua a autenticação e teste com uma consulta simples, como perguntar quais ferramentas da Nvoip estão disponíveis.
5. Perguntas de exemplo
- Qual foi o volume de atendimentos por canal nesta semana?
- Quais horários concentram mais ligações recebidas?
- Compare Telefonia, WhatsApp, Chat e Redes Sociais no mês atual.
- Quais usuários tiveram maior tempo de espera no atendimento?
6. Problemas comuns
| Sintoma | O que verificar |
|---|---|
| Erro de autenticação | Reconecte pelo OAuth. Se você colou um token, ele venceu (24 horas): remova o header e use o login. |
| Ferramentas não aparecem | Salve a configuração e reinicie a conversa ou o cliente MCP. |
| Acesso negado | Plano, permissão do usuário e escopo da conta autenticada. |
| Dados incompletos | Período consultado, canal analisado, histórico disponível e limites aplicáveis. |
Atenção: O ChatGPT pode exigir permissão do administrador do workspace ou modo de desenvolvedor para apps/conectores MCP. Se a opção não aparecer, valide primeiro as permissões do ChatGPT.
7. Boas práticas de segurança
- Não cole access token, refresh token, napikey ou usertoken em prompts, conversas públicas ou documentos compartilhados.
- Prefira o login OAuth; se usar token para testes, só no campo seguro de autenticação do cliente MCP.
- Revogue ou substitua o token se ele for exposto.
- Revise periodicamente quais usuários têm permissão para usar o MCP Server.