Como conectar o MCP Server da Nvoip ao Claude e ao Claude Code

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 manual mostra como conectar o MCP Server da Nvoip ao Claude, Claude Desktop e Claude Code usando o OAuth central da Nvoip.

Importante: informe somente a URL https://mcp.nvoip.com.br/mcp. Não preencha OAuth Client ID ou OAuth Client Secret e não cole access token, usertoken ou napikey. O Claude descobre e renova o acesso automaticamente pelo OAuth da Nvoip.

1. Antes de começar

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.
Use uma conta Nvoip com acesso apenas aos dados que poderão ser consultados pelo Claude.

2. Dados de conexão

Campo	Valor
Nome	Nvoip
URL do servidor MCP	`https://mcp.nvoip.com.br/mcp`
OAuth Client ID	Deixe vazio
OAuth Client Secret	Deixe vazio
Token ou header manual	Não é necessário

3. Conectar pelo Claude ou Claude Desktop

No Claude, abra Settings e acesse Connectors.
Clique em Add custom connector.
Informe o nome Nvoip e a URL https://mcp.nvoip.com.br/mcp.
Em Advanced settings, deixe OAuth Client ID e OAuth Client Secret vazios.
Clique em Add.
O Claude exibirá “You are not connected to Nvoip yet” e o botão Connect. Essa tela é esperada: adicionar e autenticar são etapas separadas no Claude.
Clique em Connect. O navegador abrirá o login OAuth central da Nvoip.
Entre com seu e-mail ou ramal e a senha do painel, revise as permissões e autorize.
Ao voltar ao Claude, confirme que o conector aparece como conectado.

A tela com o botão Connect não é uma falha. O Claude não abre o OAuth automaticamente ao clicar em Add. O login começa somente após clicar em Connect.

4. Conectar pelo Claude Code

No terminal, adicione o servidor HTTP remoto para o seu usuário:

claude mcp add --transport http --scope user nvoip https://mcp.nvoip.com.br/mcp

Abra o Claude Code.
Execute /mcp.
Selecione o servidor nvoip e escolha a opção de autenticação.
Conclua o login e o consentimento no navegador.
Volte ao Claude Code e use /mcp novamente para confirmar o status conectado.

Para verificar a configuração pelo terminal, use:

claude mcp get nvoip
claude mcp list

Não use --header Authorization, Client ID ou Client Secret. O servidor da Nvoip oferece descoberta OAuth automática.

5. Testar a conexão

Depois de conectar, inicie com uma consulta somente leitura, por exemplo:

Quais ferramentas da Nvoip estão disponíveis?
Analise as métricas de atendimento da última semana.
Quais canais tiveram maior volume hoje?

Revise as ferramentas solicitadas pelo Claude antes de aprovar qualquer ação.

6. Problemas comuns

Sintoma	O que fazer
“You are not connected to Nvoip yet” após Add	Clique em Connect. Esse é o fluxo normal do Claude.
Connection issue após uma tentativa antiga	Desconecte/remova a configuração anterior, adicione novamente somente a URL e clique em Connect.
O navegador não abriu no Claude Code	Abra `/mcp`, selecione o servidor e copie a URL de autenticação exibida.
O redirecionamento local falhou no Claude Code	Copie a URL completa da barra do navegador e cole no campo solicitado pelo Claude Code.
Acesso negado	Confira o plano, a permissão MCP Server do usuário e os dados liberados para a conta autenticada.

7. Segurança

Não compartilhe senha, access token, refresh token, authorization code, usertoken ou napikey.
Não publique capturas de tela que mostrem credenciais ou códigos OAuth.
Se houver erro, informe ao suporte o horário aproximado, a etapa e o reference ID exibido pelo Claude.
Revise periodicamente quais usuários possuem a permissão MCP Server.