Como conectar o MCP Server da Nvoip ao Codex
Este artigo explica como conectar o MCP Server da Nvoip ao Codex para consultar métricas e relatórios dentro do ambiente de desenvolvimento.
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 Codex
É indicado para equipes técnicas, suporte e operações que usam Codex para validar dados, investigar integrações e cruzar contexto de produto com informações autorizadas.
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 | Codex ou ambiente compatível com servidor MCP remoto. |
| Token | Access token OAuth gerado/renovado no painel da Nvoip. |
3. Dados de conexão
| Campo |
Valor |
| URL do servidor MCP | https://mcp.nvoip.com.br/mcp |
| Header de autorização | Authorization: Bearer <access_token> |
| Variável de ambiente, quando aplicável | NVOIP_MCP_BEARER_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 |
4. Passo a passo
- No painel da Nvoip, gere um token MCP ou configure o OAuth disponível para a conta.
- No Codex, abra Settings e acesse MCP servers.
- Adicione um servidor chamado Nvoip MCP com a URL do MCP Server.
- Se o cliente pedir header direto, use Authorization: Bearer <access_token>.
- Se o cliente pedir nome de variável, informe NVOIP_MCP_BEARER_TOKEN e salve o token no ambiente seguro.
- Salve, ative o servidor e abra uma nova conversa para carregar as ferramentas.
5. Perguntas de exemplo
- 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 meu consumo MCP e possíveis excedentes.
6. Problemas comuns
| Sintoma |
O que verificar |
| Erro de autenticação | Token expirado, header sem Bearer, espaço extra ou token copiado incorretamente. |
| 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: No campo Bearer token env var, alguns clientes esperam o nome da variável de ambiente, não o token em si. Evite colar tokens em prompts ou arquivos versionados.
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.
- Use o token somente 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.
Links úteis
Related Articles
Como conectar o MCP Server da Nvoip ao ChatGPT
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 ...
Como conectar o MCP Server da Nvoip ao Claude
Este artigo mostra como adicionar o MCP Server da Nvoip como conector remoto no Claude quando o recurso estiver habilitado para sua conta. Importante: o MCP Server está disponível para clientes no Plano Pro e para revendedores Tier IV, V e VI. ...
Como conectar o MCP Server da Nvoip ao Cursor
Este artigo explica como usar o MCP Server da Nvoip no Cursor para apoiar análises técnicas e validações de produto com dados autorizados. Importante: o MCP Server está disponível para clientes no Plano Pro e para revendedores Tier IV, V e VI. ...
Como configurar o MCP Server da Nvoip
Este artigo explica como configurar o MCP Server da Nvoip para conectar dados da sua conta a clientes compatíveis com MCP, como assistentes de IA e ferramentas internas autorizadas. Importante: o MCP Server está disponível para clientes no Plano Pro ...
Como usar o MCP Server da Nvoip pelo Smithery
Este artigo explica como usar o Smithery para descobrir e conectar o MCP Server da Nvoip em clientes compatíveis. 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 ...