Como configurar o MCP Server da Nvoip

OAuth compartilhado e descoberta

O servidor MCP usa https://mcp.nvoip.com.br/mcp e anuncia https://api.nvoip.com.br/auth como servidor OAuth. Use a descoberta do cliente, PKCE e consentimento; no Claude, informe somente a URL, deixe Client ID/Secret vazios e clique em Connect. A audiência e os escopos do MCP são próprios: o token MCP não é um token genérico da API v3. Para integrar a API por backend, consulte o guia v3. Respeite a expiração informada em expires_in.

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
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	Aplicativo ou ambiente compatível com MCP e com campo seguro para configurar servidor e autenticação.
Autenticação	OAuth: o cliente MCP abre o login da Nvoip no navegador e renova o acesso sozinho. Não é preciso gerar token no painel.

3. Acesse o MCP Server no painel

Entre no Painel Nvoip com um usuário autorizado.
No menu lateral, clique em Integrações.
Abra o card MCP Server Nvoip.
Confira a URL do MCP exibida. Gere token só para testes ou clientes sem OAuth: ele vale 24 horas e depois para de funcionar.

4. Configure o cliente MCP

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

Campo	Valor
URL do servidor	`https://mcp.nvoip.com.br/mcp`
Autenticação	OAuth (login da Nvoip no navegador). Token colado à mão só para testes: vale 24 horas e depois para de funcionar.
Passo a passo por cliente	Claude.ai: Settings > Connectors > Add connector com a URL e concluir o login. Claude Code: `claude mcp add --transport http nvoip https://mcp.nvoip.com.br/mcp` e `/mcp` > Authenticate. Codex: `codex mcp add nvoip --url https://mcp.nvoip.com.br/mcp` e `codex mcp login nvoip`. Cursor: `mcp.json` só com `url`, sem `headers`, e Login quando aparecer Needs login.

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, reconecte pelo OAuth e revise URL, plano contratado e permissões do usuário. Se você colou um token, ele venceu (24 horas): remova o header e use o login.

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.
Por OAuth o acesso é renovado sozinho. Token colado à mão vale 24 horas e deve ser trocado pelo login OAuth.

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 aparece	Plano contratado, tier do revendedor e liberação do card MCP Server no painel.
Erro de autenticação	Reconecte pelo OAuth. Se você colou um token, ele venceu (24 horas): remova o header e use o login.
Acesso negado	Permissão MCP Server do usuário secundário e escopo da conta autenticada.
Dados incompletos	Limites do plano, período disponível de histórico e permissões relacionadas ao recurso consultado.