1. [Ajuda](https://nuvia.ai/docs) 2. [MCP da Nuvia](https://nuvia.ai/docs/colecoes/19724087-mcp-da-nuvia) # Como utilizar o MCP da Nuvia O MCP conecta seu assistente de IA à Nuvia. Assim, ele consulta e atualiza os dados da sua empresa enquanto você conversa, sem precisar abrir a plataforma. Disponível em Contas com acesso ao MCP da Nuvia Quem pode fazer Qualquer usuário Atualizado em 3 de agosto de 2026 [MCP da Nuvia](https://nuvia.ai/docs/colecoes/19724087-mcp-da-nuvia) 1. [Como utilizar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15825545-como-utilizar-o-mcp-da-nuvia) 2. [Como conectar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-da-nuvia) 3. [Como criar e editar Funis Inteligentes pelo MCP (Agent Builder)](https://nuvia.ai/docs/artigos/16074655-como-criar-e-editar-funis-inteligentes-pelo-mcp-agent-builder) 4. [Referência das ferramentas MCP da Nuvia](https://nuvia.ai/docs/artigos/16074574-referencia-das-ferramentas-mcp-da-nuvia) 5. [Como usar a Auditoria MCP](https://nuvia.ai/docs/artigos/15422393-como-usar-a-auditoria-mcp) 6. [Como conectar o MCP da Nuvia ao Google Antigravity](https://nuvia.ai/docs/artigos/16530912-como-conectar-o-mcp-da-nuvia-ao-google-antigravity) 7. [Como conectar o MCP da Nuvia no Microsoft Copilot Studio](https://nuvia.ai/docs/artigos/17765183-como-conectar-o-mcp-da-nuvia-no-microsoft-copilot-studio) Nesta página 1. O que você precisa antes de começar 2. O que é o MCP da Nuvia 3. Utilizando o MCP da Nuvia 4. Como auditar o que foi feito via MCP da Nuvia **Nesta página4 seções** 1. O que você precisa antes de começar 2. O que é o MCP da Nuvia 3. Utilizando o MCP da Nuvia 4. Como auditar o que foi feito via MCP da Nuvia Assistentes de IA como o ChatGPT e o Claude são ótimos para conversar, mas não enxergam os dados da sua empresa. Eles não sabem quais contatos, listas ou campanhas você tem na Nuvia. O MCP (Model Context Protocol) é a ponte que resolve isso, um padrão aberto de conexão entre assistentes de IA e outros sistemas. Com essa ponte, sua conta na Nuvia passa a ser algo que o assistente consegue acessar. Você pede em linguagem comum, por exemplo “crie uma lista com os leads de tecnologia em São Paulo”, e ele busca, cria ou atualiza a informação para você. ## O que você precisa antes de começar - Acesso à Nuvia - Ter conectado o MCP ao seu aplicativo de IA compatível Para saber como conectar o MCP acesse: [Como conectar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-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 assistente de IA (Claude, ChatGPT, Cursor, ou outro compatível) passa a enxergar os dados da sua empresa na Nuvia como **tools** que ele mesmo decide chamar durante a conversa, sem exigir comandos técnicos do seu lado. Por trás da tela, o servidor MCP da Nuvia embrulha os mesmos serviços que já existem na plataforma, prospecção, CRM, listas, atendimento e campanhas, e expõe cada um como uma ferramenta com nome, descrição e parâmetros próprios. ## Utilizando o MCP da Nuvia O cliente MCP acessa ferramentas equivalentes às ações que você faz na plataforma, organizadas em seis grupos: - **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 Nos tópicos abaixo neste artigo você encontra detalhes sobre como utilizar cada uma das ferramentas. Nota as ferramentas respeitam as permissões e o consumo de créditos da sua conta, do mesmo jeito que as ações feitas pela interface. A regra de ouro é: **buscar e cruzar dados nunca custa crédito**, a única ferramenta que consome crédito é a de enriquecimento (enrich_list), coberta mais abaixo. ### Utilizando a **Busca** via MCP da Nuvia No chat do seu assistente de IA, mencione que deseja utilizar a ferramenta MCP da Nuvia para executar a ação que você irá direcionar, por exemplo: Utilize o conector da Nuvia para realizar a tarefa a seguir: busque contatos com o cargo "Diretor de Marketing" em empresas de tecnologia no Brasil. Por trás dessa frase, o agente pode chamar várias ferramentas diferentes, dependendo do que você pediu: FerramentaO que faz search_businesses Busca **empresas** na base global (fora do Brasil), por porte, país, indústria, receita, tecnologia usada, etc. search_prospects Busca **pessoas/decisores** na base global, por cargo, senioridade, localização e firmografia da empresa. search_brazil_companies Busca **empresas brasileiras** na base nacional de CNPJ, por UF, CNAE, situação cadastral, porte, sócio, capital social, etc. lookup_filter_values Resolve um termo livre (ex: “software”) no valor exato aceito pelos filtros de categoria, localização ou cargo antes de rodar a busca global. lookup_brazil_filter_values Mesma função da anterior, mas para os filtros da base brasileira (CNAE, natureza jurídica, cidade, UF, etc.). link_brazil_to_global Cruza uma empresa brasileira (pelo CNPJ) com a base global, para depois buscar decisores dela com search_prospects. link_global_to_brazil Caminho inverso: a partir do domínio de uma empresa global, traz os dados cadastrais brasileiros (CNPJ, sócios, situação cadastral). Dica quanto mais específico o seu pedido (cargo, setor, localização, tamanho da empresa), mais preciso o resultado. Para filtros de categoria, cargo ou localização, o agente normalmente resolve o valor certo com lookup_filter_values/lookup_brazil_filter_values antes de rodar a busca, isso evita buscas vazias por causa de um termo digitado de forma diferente do catálogo. ### Utilizando **Listas** via MCP da Nuvia Peça ao seu assistente de IA para listar, criar ou alterar listas da mesma forma que você faria no módulo **Listas** da plataforma. Exemplos: - Utilize o conector da Nuvia para criar uma lista chamada "Leads Enterprise SP" do tipo Contato. - Utilize o conector da Nuvia para listar todas as minhas listas e me dizer quantos registros cada uma tem. - Utilize o conector da Nuvia para adicionar uma coluna "Setor" (texto) na lista "Leads Enterprise SP". FerramentaO que faz list_lists Lista as listas de CRM da empresa, com nome, tipo de objeto (Contato/Empresa), colunas resumidas e quantidade de registros. get_list Traz os metadados e as colunas detalhadas de uma lista específica, é o passo usado antes de adicionar ou atualizar registros. create_list Cria uma nova lista, do tipo Contato ou Empresa (esse tipo não pode ser alterado depois de criada). add_list_column Adiciona novas colunas a uma lista já existente, preservando as colunas atuais. Importante a criação de listas **não verifica duplicidade por nome**, é isolado por empres se você pedir para criar “Leads Enterprise SP” duas vezes, o agente cria duas listas separadas. Vale confirmar antes se já existe uma lista com esse nome. ### Utilizando **Registros** via MCP da Nuvia Registros são os contatos e empresas propriamente ditos dentro de uma lista específica. Exemplos de uso: - Utilize o conector da Nuvia para listar os registros da lista "Leads Enterprise SP". - Utilize o conector da Nuvia para adicionar estes contatos (já cadastrados no CRM) à lista "Leads Enterprise SP". - Utilize o conector da Nuvia para atualizar o status do registro X para "qualificado". FerramentaO que faz list_records Lista os registros (linhas) de uma lista, já organizados por nome de coluna. add_records Adiciona contatos ou empresas já existentes no CRM a uma lista (cada registro referencia um contato **ou** uma empresa). update_record Atualiza os dados de uma linha específica da lista, mesclando com o que já existe (não apaga as demais colunas). update_records Mesma coisa que update_record, mas em lote, até 100 linhas por chamada. Importante os registros adicionados a uma lista via MCP precisam ser contatos/empresas **já existentes no CRM da Nuvia** (não é possível jogar direto um resultado de busca global, para isso, primeiro salve o resultado da busca como registro, conforme explicado a seguir). ### De resultados de busca para registros Como os resultados de search_businesses, search_prospects e search_brazil_companies vêm da base global (fora do CRM), existe uma etapa intermediária para transformá-los em registros da sua conta: FerramentaO que faz save_search_results Recebe os IDs de itens encontrados na busca e os salva como contatos/empresas no CRM, opcionalmente já adicionando a uma lista (nova ou existente). Roda em segundo plano (assíncrono). get_save_status Consulta o andamento desse salvamento até o status ficar “concluído”. - Utilize o conector da Nuvia para salvar esses resultados da busca como contatos e adicionar à lista "Prospecção Q2". ### Utilizando **Contatos** via MCP da Nuvia Esta ferramenta trabalha com a base de contatos da conta de forma mais ampla (não apenas dentro de uma lista). Exemplos: - Utilize o conector da Nuvia para listar meus contatos mais recentes. - Utilize o conector da Nuvia para buscar o contato com o telefone +55 11 91234-5678. - Utilize o conector da Nuvia para criar um contato: nome "Maria Silva", telefone "+5511999999999", e-mail "maria@empresa.com". - Utilize o conector da Nuvia para adicionar a nota "Follow-up agendado para sexta" no contato de [nome]. FerramentaO que faz list_contacts Lista/busca contatos do CRM da sua empresa, por nome, e-mail ou telefone. find_contacts_by_phone Resolve uma lista de telefones (com ou sem DDI/máscara) para os contatos correspondentes já cadastrados, útil para checar duplicidade antes de importar. create_contact Cria um único contato (nome, DDI, telefone são obrigatórios; e-mail, cargo, LinkedIn e campos personalizados são opcionais). create_contacts Mesma coisa, em lote, até 100 contatos por chamada. Se algum item falhar, os demais continuam sendo criados normalmente. update_contact Atualiza campos de um contato existente (só os campos enviados são alterados). update_contacts Versão em lote do anterior, até 100 atualizações por chamada, com falhas isoladas por contato. add_contact_note Adiciona uma anotação a um contato (até 5000 caracteres). list_contact_notes Lista as anotações já registradas em um contato, da mais recente para a mais antiga. Nota operações em lote (create_contacts, update_contacts) não travam se um item falhar, a falha fica isolada em uma lista separada de erros, e os demais itens são processados normalmente ### Utilizando **Conversas** via MCP da Nuvia Consulte o histórico de atendimento diretamente pelo seu assistente de IA. Exemplos: - Utilize o conector da Nuvia para listar as conversas em aberto no WhatsApp. - Utilize o conector da Nuvia para me mostrar as últimas mensagens da conversa com [nome do contato]. FerramentaO que faz list_conversations Lista as conversas de atendimento da empresa, com contato, inbox, agente responsável, status (aberta/resolvida) e resumo da última mensagem. list_messages Lista o conteúdo trocado em uma conversa específica (texto, tipo, remetente, data e anexos). Importante essas ferramentas são **somente leitura**, o envio de mensagens não é exposto via MCP por enquanto. Para responder ou disparar uma conversa, use a plataforma diretamente. ### Utilizando **Campanhas** via MCP da Nuvia Consulte informações e performance de campanhas sem precisar abrir a plataforma. Exemplos: - Utilize o conector da Nuvia para listar as campanhas ativas. - Utilize o conector da Nuvia para consultar os resultados da campanha "Follow-up Q2". FerramentaO que faz list_campaigns Lista as campanhas da empresa (campanhas arquivadas não aparecem), com status, canal, métricas e remetentes. get_campaign Traz os detalhes completos de uma campanha específica: status, canal, gatilho e métricas. Importante assim como em Conversas, esta ferramenta é **somente leitura**, criar, editar ou disparar uma campanha continua sendo feito na plataforma Nuvia. ### Utilizando **Enriquecimento** via MCP da Nuvia Peça para enriquecer contatos de uma lista diretamente pelo seu assistente de IA. Exemplo: - Utilize o conector da Nuvia para enriquecer o e-mail profissional e o telefone dos contatos da lista "Leads Enterprise SP". FerramentaO que faz enrich_list Dispara o enriquecimento de e-mail e/ou telefone dos contatos elegíveis de uma lista (o mesmo fluxo do botão “Enriquecer lista” da plataforma). Roda em segundo plano e pode ser direcionado a toda a lista ou a um recorte (view/filtros). get_enrich_status Consulta o andamento (progresso de 0 a 100%) do enriquecimento disparado. Atenção Esta é a única ferramenta do MCP que consome créditos da sua conta - E-mail: **1 crédito** por contato - Telefone: **10 créditos** por contato Como o custo é proporcional ao número de contatos elegíveis no recorte, o agente deve confirmar com você o tamanho da lista/filtro antes de disparar o enriquecimento, especialmente em listas grandes. Acompanhe o consumo em **Menu Lateral > Configurações > Créditos** ou revise execuções detalhadas no **Log de enriquecimento.** ### ## Como auditar o que foi feito via MCP da Nuvia Use a página **Auditoria MCP** para ver autenticações, sessões e chamadas de ferramentas feitas pela sua empresa. 1. No menu lateral, **clique no ícone de perfil e acesse Configurações** 2. No menu lateral, selecione **Auditoria MCP** Tecnicamente, cada chamada é auditada no momento em que passa pela borda de autenticação do servidor (eventos como sessão iniciada, ferramenta chamada e ferramenta com falha). ## Perguntas frequentes **Preciso repetir “utilize o conector da Nuvia” em toda mensagem?** Não necessariamente, depende do seu assistente de IA. Alguns mantêm o contexto de que devem usar o conector durante toda a conversa; outros podem precisar do lembrete a cada nova solicitação, especialmente se você também tiver outros conectores ativos que façam ações parecidas. **Buscar contatos e empresas pelo MCP custa crédito?** Não. A regra é: **buscar e cruzar dados nunca custa**. Todas as ferramentas de busca (search_businesses, search_prospects, search_brazil_companies), de resolução de filtros (lookup_filter_values, lookup_brazil_filter_values) e de cruzamento (link_brazil_to_global, link_global_to_brazil), além de todas as operações de CRM (contatos, listas, registros, conversas, campanhas), são gratuitas. **Qual é a única ação que consome créditos via MCP?** O enrich_list, que abre o e-mail (1 crédito/contato) ou telefone (10 créditos/contato) de contatos de uma lista, o mesmo custo e as mesmas regras de estorno já usadas na plataforma. **As ferramentas de Conversas e Campanhas permitem enviar mensagens ou disparar campanhas?** Não. Essas ferramentas via MCP são de **consulta** (listar, buscar, detalhar). Criar campanhas, enviar mensagens ou editar fluxos de conversa continuam sendo feitos diretamente na plataforma Nuvia. **Posso adicionar direto um resultado de busca global a uma lista?** Não diretamente. Resultados de search_businesses, search_prospects e search_brazil_companies vêm de uma base global e precisam antes ser materializados como registros do CRM com save_search_results, só depois disso é que podem ser referenciados em uma lista via add_records. **Quem pode utilizar o MCP na minha empresa?** Apenas usuários com perfil **Usuário** ou **Admin**, e que tenham conectado o MCP conforme descrito em [Como conectar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-da-nuvia). **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. Tecnicamente, cada chamada é auditada no momento em que passa pela borda de autenticação do servidor (eventos como sessão iniciada, ferramenta chamada e ferramenta com falha). **O que faço se o conector aparecer inativo no meu assistente de IA?** Peça para o seu assistente de IA chamar a ferramenta whoami. Se a resposta não vier ou não trouxer o nome da sua empresa, revise a conexão em [Como conectar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-da-nuvia) e refaça a autorização (login + Autorizar) na tela do cliente MCP. [PróximoComo conectar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-da-nuvia) Este artigo ajudou? ## Artigos relacionados - [Como gerenciar API Keys na Nuvia](https://nuvia.ai/docs/artigos/15230128-como-gerenciar-api-keys-na-nuvia) - [Referência das ferramentas MCP da Nuvia](https://nuvia.ai/docs/artigos/16074574-referencia-das-ferramentas-mcp-da-nuvia) - [Como criar e editar Funis Inteligentes pelo MCP (Agent Builder)](https://nuvia.ai/docs/artigos/16074655-como-criar-e-editar-funis-inteligentes-pelo-mcp-agent-builder) - [Como conectar o MCP da Nuvia ao Google Antigravity](https://nuvia.ai/docs/artigos/16530912-como-conectar-o-mcp-da-nuvia-ao-google-antigravity) [MCP da Nuvia](https://nuvia.ai/docs/colecoes/19724087-mcp-da-nuvia) 1. [Como utilizar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15825545-como-utilizar-o-mcp-da-nuvia) 2. [Como conectar o MCP da Nuvia](https://nuvia.ai/docs/artigos/15422389-como-conectar-o-mcp-da-nuvia) 3. [Como criar e editar Funis Inteligentes pelo MCP (Agent Builder)](https://nuvia.ai/docs/artigos/16074655-como-criar-e-editar-funis-inteligentes-pelo-mcp-agent-builder) 4. [Referência das ferramentas MCP da Nuvia](https://nuvia.ai/docs/artigos/16074574-referencia-das-ferramentas-mcp-da-nuvia) 5. [Como usar a Auditoria MCP](https://nuvia.ai/docs/artigos/15422393-como-usar-a-auditoria-mcp) 6. [Como conectar o MCP da Nuvia ao Google Antigravity](https://nuvia.ai/docs/artigos/16530912-como-conectar-o-mcp-da-nuvia-ao-google-antigravity) 7. [Como conectar o MCP da Nuvia no Microsoft Copilot Studio](https://nuvia.ai/docs/artigos/17765183-como-conectar-o-mcp-da-nuvia-no-microsoft-copilot-studio) ## Ainda precisa de ajuda? Clientes falam com o suporte pelo chat dentro da plataforma. Ainda não é cliente? Fale com o nosso time. [Falar com o suporte na plataforma](https://app.nuvia.ai) [Ainda não sou cliente](https://nuvia.ai/contact) --- Source: https://nuvia.ai/docs/artigos/15825545-como-utilizar-o-mcp-da-nuvia