O Codex permite conectar servidores MCP remotos no app, IDE ou CLI. Isso ajuda times técnicos e operações internas a validar dados da Nvoip sem sair do ambiente de trabalho.

Ideal para equipes que usam Codex para análise operacional, validação de métricas, suporte interno, auditoria de ferramentas e exploração controlada de dados da conta.

Antes de conectar

  • A conta precisa estar habilitada para o MCP Server da Nvoip.
  • Clientes finais precisam do Plano Pro. Revendedores precisam estar nos Tiers IV, V ou VI.
  • Usuários secundários precisam da permissão MCP Server habilitada pelo administrador.
  • A conexão é por OAuth: o cliente abre o login da Nvoip no navegador e renova o acesso sozinho. Não é preciso gerar token no painel.
  • As respostas respeitam escopo da conta, permissões e limites de uso.

Dados de conexão da Nvoip

Servidor MCPhttps://mcp.nvoip.com.br/mcp
AutenticaçãoOAuth (login da Nvoip no navegador). Token colado à mão só para testes: vale 24 horas e depois para de funcionar.
Metadados OAuthhttps://api.nvoip.com.br/v2/.well-known/oauth-authorization-server
Recurso protegidohttps://mcp.nvoip.com.br/.well-known/oauth-protected-resource/mcp

Passo a passo para Codex

  1. Confira no painel da Nvoip se sua conta é elegível ao MCP Server. Não é preciso gerar token.
  2. No terminal, rode codex mcp add nvoip --url https://mcp.nvoip.com.br/mcp.
  3. Rode codex mcp login nvoip e conclua o login da Nvoip que abre no navegador. O Codex renova o acesso sozinho.
  4. No app ou na extensão do IDE, use Settings > MCP servers > Add server com a URL https://mcp.nvoip.com.br/mcp e clique em Authenticate quando o servidor pedir login.
  5. Abra uma nova conversa para garantir que as ferramentas sejam carregadas.
  6. Teste pedindo para listar as ferramentas MCP disponíveis ou consultar seu perfil MCP.

Perguntas que você pode fazer

  • Liste as ferramentas MCP disponíveis da Nvoip.
  • Qual é meu perfil de acesso no MCP?
  • Traga um resumo de atendimento da minha conta no mês.
  • Mostre o consumo MCP e possíveis excedentes.

Erros comuns

  • Erro de autenticação: reconecte pelo OAuth. Se você colou um token, ele venceu (24 horas): remova o header Authorization e use o login.
  • Ferramentas não aparecem: salve a configuração e reinicie a conversa ou o cliente MCP.
  • Acesso negado: confirme plano, permissão do usuário e escopo da conta.
  • Dados diferentes do esperado: confira período consultado, canal analisado e limites aplicáveis.

Atenção: Não preencha “Bearer token env var” nem NVOIP_MCP_BEARER_TOKEN. Um token colado à mão vale 24 horas e depois o Codex passa a receber erro de autenticação. Se você já tinha configurado assim, remova a variável e rode codex mcp login nvoip.

Não cole access token, refresh token, napikey ou usertoken em prompts, conversas públicas ou documentos compartilhados. Use esses dados apenas nos campos seguros de autenticação do cliente MCP.

Links úteis