Como conectar o MCP da Nuvia

Conecte aplicativos de IA compatíveis com MCP (Claude, Cursor, agentes próprios) aos dados da sua empresa na Nuvia, via autorização OAuth.

Disponível em
contas com acesso ao MCP da Nuvia.
Quem pode fazer
apenas perfis Usuário e Company Admin . Módulo: configuração feita no seu cliente MCP + tela de autorização da Nuvia

Nesta página3 seções

O servidor MCP da Nuvia permite que aplicativos de IA compatíveis com MCP (como Claude, Cursor e agentes próprios) acessem os dados da sua empresa como busca, listas, registros, contatos, conversas e campanhas de forma segura, via autorização OAuth. Assim você usa a inteligência da Nuvia direto da ferramenta onde já trabalha.

Módulo: configuração feita no seu cliente MCP + tela de autorização da Nuvia


O que é o MCP da Nuvia

O MCP (Model Context Protocol) é um protocolo aberto que padroniza como aplicativos de IA acessam dados e ferramentas externas. Com o servidor MCP da Nuvia, o seu cliente de IA passa a enxergar os dados da sua empresa na Nuvia como ferramentas que ele pode consultar e atualizar durante uma conversa.

O acesso é isolado por empresa (tenant-scoped): cada conexão enxerga apenas os dados da empresa do usuário que autorizou.

Como conectar

A conexão é iniciada no seu cliente MCP e finalizada na tela de autorização da Nuvia.

  1. No seu cliente MCP (por exemplo, Claude ou Cursor), adicione o servidor MCP da Nuvia usando a URL do servidor: https://api.nuvia.ai/mcp

  2. O cliente abre a tela Autorizar acesso ao MCP da Nuvia

  3. Faça login com o e-mail e a senha da sua conta Nuvia

  4. Clique em Autorizar

  5. O cliente recebe o acesso e passa a listar as ferramentas disponíveis automaticamente

O que é possível fazer

Depois de autorizado, o cliente MCP acessa ferramentas equivalentes às ações que você faz na plataforma, entre elas:

  • Busca: prospecção global, base Brasil (CNPJ) e consulta de valores de filtro

  • Listas e registros: listar e criar listas, adicionar colunas, listar/adicionar/atualizar registros

  • Contatos: listar, buscar por telefone, criar e atualizar contatos (inclusive em lote) e notas

  • Conversas e campanhas: listar conversas e mensagens, listar e consultar campanhas

  • Enriquecimento: enriquecer uma lista de contatos

  • Identidade: confirmar qual usuário e empresa estão conectados

Perguntas frequentes

Quais aplicativos posso conectar?

Qualquer aplicativo compatível com o protocolo MCP que suporte autorização OAuth, como Claude, Cursor e agentes próprios. A conexão é feita pela URL do servidor MCP da Nuvia, dentro do próprio cliente.

O cliente conectado enxerga dados de outras empresas?

Não. O acesso é isolado por empresa. Cada conexão enxerga somente os dados da empresa do usuário que fez a autorização.

Como acompanho o que foi feito via MCP?

Use a página Auditoria MCP, no menu lateral, para ver autenticações, sessões e chamadas de ferramentas feitas pela sua empresa.

O que acontece com o MCP se meu período de teste terminar?

O acesso via MCP é bloqueado enquanto o teste estiver vencido — as chamadas de ferramentas passam a ser recusadas, do mesmo jeito que as ações de escrita na plataforma. Você não precisa reconectar o cliente MCP depois: a checagem acontece no momento do uso, olhando o status da assinatura. Assim que a Nuvia ativa sua conta, o acesso volta sozinho com a mesma conexão que você já tinha.

Este artigo ajudou?