Para consultar o NPS pelo Claude, a plataforma de pesquisa precisa oferecer um conector MCP. Você gera uma chave de acesso na plataforma, adiciona o conector no Claude com o endereço e a chave, e passa a perguntar qual foi o NPS do período e o que os clientes escreveram.
Para quem cuida da experiência do cliente, o número do NPS é só o começo: o que explica a nota está nos comentários. O gerente de uma rede de clínicas que quer saber do que os insatisfeitos reclamaram no mês precisa ler as respostas uma por uma. Com o conector, essa leitura vira uma mensagem na conversa.
A seguir: o passo a passo da conexão, o que fazer quando o campo da chave não aparece no Claude, as perguntas que rendem respostas úteis, os cuidados com a chave e com os dados dos clientes e, no fim, o que a IA consegue e o que não faz dentro da conta.
- O que o Claude precisa para enxergar os resultados da sua pesquisa
- Como gerar a chave e adicionar o conector, passo a passo
- Três perguntas que transformam respostas soltas em prioridade da semana
- O que proteger: a chave, as aprovações e os dados pessoais
Como o Claude Consulta o NPS pelo Conector MCP
O Claude consulta o NPS por meio de um conector MCP, a peça que a plataforma de pesquisa oferece para a IA buscar dados e executar ações na conta. Sem conector, o Claude não enxerga as respostas da sua pesquisa. Com ele, cada pergunta sobre satisfação vira uma consulta aos dados reais.
MCP é a sigla de Model Context Protocol, o padrão aberto que liga aplicativos de IA a sistemas externos. A origem do padrão, quem o mantém e a diferença para uma API estão explicadas no guia sobre o que é MCP e por que ele importa para quem cuida do cliente.
Na prática, o Claude lê a sua pergunta, escolhe entre as ferramentas que o conector oferece, busca o dado e devolve a resposta em texto corrido. A pergunta pode mudar a cada dia, e ninguém precisa montar filtro nem planilha antes.
O que Você Precisa para Conectar o Claude à Pesquisa de NPS
A conexão pede três coisas: uma conta numa plataforma de pesquisa com conector MCP, uma chave de acesso gerada nessa conta e um Claude que aceite essa chave no cadastro do conector.
- Uma conta com conector MCP. O conector pertence à plataforma, não ao Claude, e é ela que define o que a IA pode consultar e fazer.
- Uma chave de acesso. É a credencial que prova que aquela IA tem permissão para entrar naquela conta.
- O campo Cabeçalhos de requisição no Claude. Ele fica na tela de adicionar conector, dentro do menu de Conectores, e é onde a chave entra. O recurso ainda está em teste pela Anthropic e aparece só nas contas em que foi liberado, e quem configura o conector é o administrador da conta.
Se o campo não aparecer, o caminho é um arquivo de configuração do Claude Desktop, o aplicativo instalado no computador. Por esse caminho, a conexão não passa pela área de Conectores e exige o Node.js, um programa que precisa estar instalado na máquina. Para quem não tem familiaridade com esse tipo de ajuste, vale fazer com alguém de tecnologia ao lado.
Passo a Passo para Conectar o Fala Cliente ao Claude
O Fala Cliente é uma plataforma de pesquisa de satisfação, inclusive de NPS, e tem conector MCP próprio para ligar a conta ao Claude. A conexão leva seis passos: dois no Fala Cliente e quatro no Claude. Os nomes de botão abaixo são os da tela em setembro de 2026.
No Fala Cliente: Gerar a Chave e Copiar o Endereço
- Gere a chave. Em Configurações, abra Conectar IA (API), tela que só aparece para quem administra a conta, e clique em Gerar nova chave. O botão abre um quadro que pede um nome opcional, que serve só para você lembrar onde aquela chave vai ser usada, como “Claude do marketing”. A chave aparece uma única vez, com o aviso para guardar agora: copie pelo botão ao lado dela e guarde num gerenciador de senhas.
- Copie o endereço do conector. Na mesma página, em Como conectar sua IA, a aba Claude (web) mostra o campo URL do conector MCP, com botão de copiar. Logo abaixo fica o modelo do cabeçalho de autenticação, que vai ser usado no passo 4.
No Claude: Adicionar o Conector
- Adicione um conector personalizado. No Claude, na web ou no aplicativo para computador, o Claude Desktop, abra a área de Conectores (no menu em inglês, Customize > Connectors), clique em + e escolha adicionar um conector personalizado. Dê um nome, como Fala Cliente, e cole o endereço copiado no passo 2.
- Deixe a autenticação em Sem login e inclua o cabeçalho. A opção Sem login já vem marcada, com o selo Detectado, porque o Claude identifica que o conector não usa login de conta. Em Cabeçalhos de requisição, clique em Adicionar cabeçalho, escolha authorization na lista e, no valor, escreva Bearer, um espaço e a chave.
A tela avisa que, sem login, qualquer pessoa com o endereço pode usar o conector. No Fala Cliente, o que autoriza o acesso é a chave: sem ela, o conector recusa a chamada.
Se a seção Cabeçalhos de requisição não aparecer nesse ponto, a conta ainda não tem o recurso liberado ou quem está configurando não é o administrador dela. Para esse caso, a própria tela do Fala Cliente traz o bloco pronto para o arquivo de configuração, na aba Claude Desktop / Cursor.
Vincular o Conector e Testar a Conexão
- Salve e clique em Vincular. Depois de salvo, o conector ainda aparece desligado, com o aviso de que você não está conectado e o botão Vincular. É um passo fácil de pular, e sem ele a conexão não acontece.
- Confira a lista de ferramentas. Vinculado, o conector aparece como Conectado, e o Claude lista oito ferramentas do Fala Cliente, cada uma marcada para pedir a sua aprovação antes de ser usada.
Para testar, pergunte na conversa qual foi o NPS da sua conta nos últimos 30 dias. Se vier um número, a conexão está ativa. Se o Claude disser que não tem acesso, confira nesta ordem: o endereço colado inteiro, a palavra Bearer seguida de um espaço antes da chave, a chave completa e o conector vinculado.
Perguntas para Consultar o NPS pelo Claude
Pergunta boa diz o período e pede o padrão, não a lista. Com o período na pergunta, como “últimos 30 dias” ou “agosto”, o número vem do intervalo que você quer comparar. Três perguntas, nesta ordem, cobrem o número, o motivo e a decisão.
1. O número.
Qual foi meu NPS nos últimos 30 dias?
A resposta traz o índice do período e a composição dele: quantos promotores, neutros e detratores entraram na conta, e a média das notas.
2. O motivo.
Nas respostas dos últimos 30 dias, use o máximo disponível e identifique os três temas mais recorrentes entre os detratores. Informe quantas respostas você analisou, quantas existem no período e avise claramente se a análise usou apenas uma amostra.
A pergunta é longa por um motivo técnico: no Fala Cliente, cada consulta de respostas traz 30 por padrão e até 200 de uma vez, sempre as mais recentes do período pedido. A resposta da plataforma informa quantas vieram e quantas existem, mas o Claude só conta isso a você se a pergunta pedir. Acima de 200 respostas no período, divida a consulta em intervalos menores.
3. A decisão.
Com base nessas respostas, qual ação devo priorizar nesta semana?
Essa pergunta pede escolha, não mais informação, e é aí que a conversa deixa de ser relatório. O Claude sugere um caminho, e a decisão continua sendo da equipe, que conhece o negócio.
Um atalho para o atendimento: se o formulário da pesquisa tem a pergunta “Deseja receber um retorno?”, dá para pedir “Quais clientes pediram retorno nos últimos 7 dias?”. A lista sai do que o próprio cliente marcou nessa pergunta, não da nota. Quem não viu a pergunta, ou a deixou em branco, fica de fora.
O dado vem vivo da conta, mas a leitura que a IA faz dele ainda pode errar. Antes de uma decisão que pesa, confira o número no painel da plataforma. Para montar um resumo que vai para a reunião, o roteiro está no guia de relatório de NPS feito em conversa com a IA.
Segurança ao Conectar o Claude: Chave, Aprovação e Dados dos Clientes
A chave é o que separa a sua conta do resto do mundo, e se trata como senha: não vai por mensagem, não fica em documento compartilhado e não aparece em tela que outras pessoas vão ver.
- Uma chave para cada uso. O Fala Cliente permite várias chaves ao mesmo tempo, cada uma com o seu nome. Assim dá para cortar um acesso sem derrubar os outros.
- Revogar na hora. Na lista Suas chaves, cada linha tem o botão Revogar. Se a chave escapou, revogue e gere outra.
- A chave vale para o conector inteiro. Ela não escolhe ferramenta por ferramenta. O controle fino fica no Claude, que pede aprovação antes de cada uso e permite trocar para Sempre permitir, uma ferramenta de cada vez. Liberar sem supervisão só vale para ferramentas de conectores em que você confia.
- Dados pessoais na tela. A consulta de respostas pode trazer nome, e-mail e telefone de quem respondeu. Antes de projetar a conversa numa reunião, confira o que está aparecendo.
Os critérios para avaliar qualquer conexão entre IA e sistema da empresa estão no guia de acesso seguro de IA aos dados da empresa.
O que o Fala Cliente Libera para o Claude
O conector do Fala Cliente libera oito ferramentas: consultar resultados, administrar o gatilho, disparar pesquisa e cuidar da lista de e-mails bloqueados. É essa lista que aparece no Claude depois de vincular, com os nomes em inglês, que a tabela traz entre parênteses.
| Ferramenta (nome no Claude) | O que faz |
|---|---|
| Consultar o NPS (Get nps) | NPS do período, com promotores, neutros, detratores e média das notas |
| Consultar respostas (Get responses) | Respostas recentes, com nota e comentário |
| Criar gatilho (Create trigger) | Cria o gatilho que transforma os pedidos do sistema da empresa em pesquisa |
| Configurar gatilho (Set trigger mapping) | Define que campo é o quê, que eventos disparam e quanto tempo esperar |
| Disparar pesquisa (Send survey) | Envia a pesquisa para um cliente |
| Ver e-mails bloqueados (List blocked emails) | Mostra a lista de e-mails bloqueados |
| Bloquear e desbloquear e-mail (Block email e Unblock email) | Põe ou tira um endereço dessa lista |
O que o conector não faz é montar ou editar a pesquisa. Perguntas, logotipo, cores e mensagem final se ajustam dentro da plataforma. E o gatilho só dispara quando o sistema da empresa envia os pedidos: sem essa integração, nada sai sozinho.
Um cuidado com o disparo: ele envia de verdade e consome um crédito do plano. A ferramenta pede nome e celular do cliente, e para a pesquisa chegar por e-mail, o canal de envio do plano gratuito, o endereço também precisa ir no pedido. O envio entra numa fila e segue a ordem de canais configurada na conta, então comece mandando para você mesmo.
A conexão com a IA está incluída também no Grátis 100, o plano gratuito da plataforma.
Pronto para ouvir seus clientes?
Crie sua conta gratuita com 100 créditos mensais para sempre.
NPS no Claude: Do Painel para a Conversa
Consultar NPS pelo Claude troca a ida ao painel do Fala Cliente por uma pergunta: a chave sai da plataforma, o conector entra no Claude, e o número e os comentários chegam na conversa. Com a rotina de três perguntas por semana, o padrão das respostas aparece sem planilha. O que continua com a equipe é decidir a prioridade e falar com o cliente insatisfeito.
Perguntas Frequentes
Preciso saber programar para consultar o NPS pelo Claude?
Não, se o seu Claude tem o espaço para a chave ao cadastrar o conector. Ali a conexão é um formulário, e com uma plataforma como o Fala Cliente o endereço e o texto do cabeçalho vêm prontos para copiar. Esse espaço é um recurso em fase de testes, liberado só para algumas contas; sem ele, a saída é o arquivo de configuração do aplicativo Claude Desktop, que pede o Node.js instalado no computador.
O Claude consegue criar ou mudar a minha pesquisa?
Não. No Fala Cliente, o conector de IA consulta resultados, administra o gatilho, dispara pesquisa e cuida dos e-mails bloqueados, mas não tem ferramenta para montar pesquisa. Mudar uma pergunta, trocar a cor ou editar a mensagem de agradecimento é trabalho feito na própria plataforma.
Quantas respostas o Claude consegue analisar de uma vez?
No Fala Cliente, até 200 por consulta; sem pedir mais, vêm 30, sempre as mais novas do período pedido. Quem tem mais respostas que isso no mês pode quebrar a análise em semanas e pedir, em cada pergunta, que o Claude diga quantas leu e quantas existem, para saber se o resumo cobre tudo ou só uma parte.
O Claude vê os dados pessoais dos meus clientes?
Pode ver: além da nota e do comentário, cada resposta consultada pode vir com o nome e os contatos do cliente. A chave dá acesso só à conta da própria empresa, e o Claude pede aprovação antes de usar cada ferramenta. Quem vai mostrar a conversa para outras pessoas deve olhar a tela antes.
Por que o Claude diz que não tem acesso ao NPS?
O caminho é revisar a configuração do conector no Claude. O endereço precisa estar inteiro, o valor do cabeçalho começa com Bearer seguido de espaço, a chave vai completa, sem faltar o começo nem o fim. Por último, o conector precisa estar vinculado: a tela de Conectores mostra Conectado quando está tudo certo.
