Como configurar o MCP Server da Nvoip

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 e para revendedores Tier IV, V e VI. Usuários secundários precisam ter a permissão MCP Server habilitada no painel.

1. O que é o MCP Server da Nvoip

O MCP Server da Nvoip permite que um cliente MCP autorizado consulte informações da conta, respeitando plano contratado, permissões do usuário, escopo da empresa e limites de uso.

Com ele, equipes podem apoiar análises sobre atendimento, ligações, SMS, WhatsApp, métricas e relatórios usando ferramentas de IA conectadas de forma controlada.

2. Antes de começar

Requisito Detalhe
PlanoConta no Plano Pro ou revendedor Tier IV, V ou VI.
PermissãoUsuário principal Pro pode acessar. Usuários secundários precisam da permissão MCP Server.
Cliente MCPAplicativo ou ambiente compatível com MCP e com campo seguro para configurar servidor e autenticação.
TokenAccess token temporário gerado no painel da Nvoip.

3. Acesse o MCP Server no painel

  1. Entre no Painel Nvoip com um usuário autorizado.
  2. No menu lateral, clique em Integrações.
  3. Abra o card MCP Server Nvoip.
  4. Confira as informações exibidas e gere um novo access token temporário.

4. Configure o cliente MCP

No cliente MCP, use os dados exibidos no painel da Nvoip:

Campo Valor
URL do servidorhttps://mcp.nvoip.com.br/mcp
Header de autorizaçãoAuthorization: Bearer <access_token>
Variável de ambiente, quando aplicávelNVOIP_MCP_BEARER_TOKEN
Atenção: não compartilhe o access token em conversas públicas, tickets sem necessidade, prompts de IA ou documentos abertos. Use o token somente no campo de autenticação do cliente MCP autorizado.

5. Valide a conexão

Depois de salvar a configuração no cliente MCP, faça uma consulta simples, como pedir um resumo de métricas disponíveis para a conta ou uma listagem de recursos acessíveis. O retorno deve respeitar o escopo do usuário autenticado.

Se a conexão falhar, gere um novo token no painel e revise URL, header, validade do token, plano contratado e permissões do usuário.

6. Permissões e limites

  • O MCP Server não concede acesso fora da conta autenticada.
  • O acesso depende do plano, das permissões do usuário e dos limites de uso aplicáveis.
  • Usuários secundários sem a permissão MCP Server não conseguem utilizar o recurso.
  • Revendedores precisam estar no Tier IV, V ou VI para usar o MCP Server.
  • Tokens temporários devem ser renovados pelo painel quando expirarem ou quando houver suspeita de exposição.

7. Boas práticas de segurança

  • Gere tokens apenas quando for configurar ou renovar uma conexão.
  • Não salve tokens em planilhas, documentos compartilhados ou histórico de chat.
  • Revogue ou substitua o token se ele for exposto.
  • Use contas e usuários com o menor nível de acesso necessário para a análise desejada.
  • Revise periodicamente quais usuários têm permissão para usar o MCP Server.

Problemas comuns

Sintoma O que verificar
A integração não aparecePlano contratado, tier do revendedor e liberação do card MCP Server no painel.
Erro de autenticaçãoToken expirado, header incompleto, espaço extra no valor Bearer ou token copiado incorretamente.
Acesso negadoPermissão MCP Server do usuário secundário e escopo da conta autenticada.
Dados incompletosLimites do plano, período disponível de histórico e permissões relacionadas ao recurso consultado.

    • Related Articles

    • Como testar o MCP Server da Nvoip no Postman

      Este artigo mostra como usar o Postman para validar o MCP Server da Nvoip antes de configurar uma IA ou outro cliente 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 ...

    • 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 ...

    • 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 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. ...

    • 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 ...