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 MCP | https://mcp.nvoip.com.br/mcp |
| Autenticação | Authorization: Bearer <access_token> |
| Metadados OAuth | https://api.nvoip.com.br/v2/.well-known/oauth-authorization-server |
| Recurso protegido | https://mcp.nvoip.com.br/.well-known/oauth-protected-resource/mcp |
Passo a passo para Codex
- No painel da Nvoip, gere um token MCP ou configure o OAuth disponível para a conta.
- No Codex, abra Settings e entre em MCP servers.
- Adicione um servidor com nome Nvoip MCP e URL https://mcp.nvoip.com.br/mcp.
- 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.
- Salve, ative o servidor e abra uma nova conversa para garantir que as ferramentas sejam carregadas.
- 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.
