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.
  • O acesso usa OAuth ou bearer token gerado pelo painel/API da Nvoip.
  • 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çãoAuthorization: Bearer <access_token>
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. No painel da Nvoip, gere um token MCP ou configure o OAuth disponível para a conta.
  2. No Codex, abra Settings e entre em MCP servers.
  3. Adicione um servidor com nome Nvoip MCP e URL https://mcp.nvoip.com.br/mcp.
  4. Configure a autenticação como Authorization: Bearer <access_token> ou use a variável NVOIP_MCP_BEARER_TOKEN quando o cliente pedir nome de variável.
  5. Salve, ative o servidor e 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: gere um novo token e confira se o header começa com Bearer.
  • 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: No campo “Bearer token env var”, alguns clientes esperam o nome da variável, não o token em si. Se usar variável, salve o token no ambiente seguro e informe apenas NVOIP_MCP_BEARER_TOKEN.

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