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
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.
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:
| Ferramenta | O 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). |
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".
| Ferramenta | O 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. |
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".
| Ferramenta | O 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. |
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:
| Ferramenta | O 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].
| Ferramenta | O 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. |
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].
| Ferramenta | O 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). |
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".
| Ferramenta | O 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. |
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".
| Ferramenta | O 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. |
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.
-
No menu lateral, clique no ícone de perfil e acesse Configurações
-
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).