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 usar a área de integrações no painel da Nvoip

      Este artigo explica como usar a área de Integrações no painel da Nvoip para encontrar conectores, addons e recursos que ligam a Nvoip a outras ferramentas. Antes de começar: algumas integrações dependem de plano, permissão, credenciais externas ou ...

    • Como integrar a Nvoip com n8n pelo painel

      Este artigo explica como localizar a integração n8n no painel da Nvoip e gerar o acesso OAuth para usar em fluxos automatizados. Antes de começar: tenha acesso ao painel da Nvoip e ao ambiente n8n onde o fluxo será configurado. 1. Encontre o card N8N ...

    • Como integrar a Nvoip com Make pelo painel

      Este artigo explica como acessar a integração Make a partir do painel da Nvoip. Importante: o card Make no painel direciona para o artigo específico de integração. Diferente de outras integrações, ele não abre um popup de configuração dentro do ...

    • Como integrar a Nvoip com Zapier pelo painel

      Este artigo explica como localizar a integração Zapier no painel da Nvoip e quais dados usar para conectar com seus Zaps. Antes de começar: você precisa ter uma conta no Zapier e permissão para acessar Integrações no painel da Nvoip. 1. Acesse ...

    • Como integrar a Nvoip com RD Station pelo painel

      Este artigo explica como localizar e usar a integração RD Station no painel da Nvoip. Antes de começar: você precisa ter acesso à conta RD Station que será conectada e permissão para configurar integrações na Nvoip. 1. Acesse a área de Integrações No ...