Refiner

Analisar dados de respostas de pesquisa

Ver em refiner.ioExperimente este MCPPatrocinado

Documentação

Introdução

O Refiner MCP Server é uma implementação do Model Context Protocol que permite que agentes de IA interajam com segurança com sua conta Refiner.

Ele atua como uma ponte entre agentes baseados em LLM e dados de feedback de clientes, permitindo automação de análises, gerenciamento de usuários e fluxos de trabalho de pesquisas por meio de linguagem natural.

Em um nível alto, este servidor expõe dados de respostas de pesquisas do Refiner como ferramentas estruturadas que agentes de IA podem descobrir e invocar dinamicamente.

Como usar nosso servidor MCP

Com o Refiner MCP Server, você pode conectar seu workspace Refiner diretamente a ferramentas de IA como ChatGPT e Claude para analisar respostas de pesquisas sob demanda usando linguagem natural. Isso permite exploração ad-hoc de dados de feedback, desde resumir respostas de texto aberto até identificar tendências e anomalias em tempo real.

Além da análise, você pode potencializar automações de fluxos de trabalho — como acionar ações com base em novas respostas ou sincronizar insights entre sistemas — usando ferramentas como Claude Code. O resultado é um ciclo de feedback mais dinâmico e orientado por IA, onde insights podem ser gerados e acionados instantaneamente sem intervenção manual.

Endpoint do servidor MCP

O servidor MCP do Refiner está acessível na seguinte URL:

https://app.refiner.io/v001/mcp

Autenticação

O Refiner MCP usa OAuth 2.0 Authorization Code + PKCE.

Endpoints de descoberta

  • https://app.refiner.io/.well-known/oauth-authorization-server
  • https://app.refiner.io/.well-known/oauth-protected-resource
  • https://app.refiner.io/.well-known/oauth-protected-resource/v001/mcp

Escopos

  • mcp:projects-read – listar ambientes/projetos acessíveis
  • mcp:forms-read – ler pesquisas/formulários
  • mcp:responses-read – ler respostas individuais
  • mcp:reporting-read – ler dados agregados de relatórios

Ferramentas

Todas as ferramentas são somente leitura e registradas em RefinerServer.

get-aggregated-response-data

Obtenha dados agregados de relatórios e gráficos. Requer project_uuid de get-projects. Filtre por UUIDs de formulários (pesquisas), UUIDs de segmentos, UUIDs de tags, identificadores de perguntas e intervalo de datas. Tipos de gráfico: nps, csat, ratings, count, distribution. O intervalo de datas padrão são os últimos 30 dias e pode se estender até 12 meses.

  • Escopo: mcp:reporting-read
  • Entrada: project_uuid, obrigatório type, opcional form_uuids, segment_uuids, tag_uuids, question_identifiers, date_range_start, date_range_end
  • type: nps, csat, ratings, count, distribution
  • Somente leitura
  • Não destrutiva

get-forms

Liste pesquisas em um projeto. Requer project_uuid de get-projects. Listas disponíveis: all, all_with_archived, archived, published, drafts.

  • Escopo: mcp:forms-read
  • Entrada: project_uuid, opcional page, list
  • list: all, all_with_archived, archived, published, drafts
  • Somente leitura
  • Não destrutiva

get-projects

Liste pesquisas em um projeto. Requer project_uuid de get-projects. Listas disponíveis: all, all_with_archived, archived, published, drafts.

Lista os projetos disponíveis.

  • Escopo: mcp:projects-read
  • Entrada: nenhuma
  • Saída: items[] com uuid, name
  • Somente leitura
  • Não destrutiva

get-responses

Obtenha acesso a uma lista de respostas de pesquisas. Requer project_uuid de get-projects. Filtre por UUIDs de formulários (pesquisas), UUIDs de segmentos, UUIDs de tags e intervalo de datas. Retorna até 500 respostas por página. Dados de contato são excluídos por motivos de privacidade. O intervalo de datas padrão são os últimos 30 dias e pode se estender até 12 meses.

  • Escopo: mcp:responses-read
  • Entrada: project_uuid, opcional form_uuids, segment_uuids, tag_uuids, date_range_start, date_range_end, page, page_cursor
  • Notas:
  • filtros podem ser strings UUID separadas por vírgula
  • padrão são os últimos 30 dias
  • máximo de retorno de 12 meses
  • até 500 respostas/página
  • dados de contato excluídos por privacidade
  • Somente leitura
  • Não destrutiva

get-segments

Liste segmentos de usuários em um projeto. Requer project_uuid de get-projects.

  • Escopo: mcp:projects-read
  • Entrada: project_uuid
  • Somente leitura
  • Não destrutiva

get-traits

Liste tags de respostas em um projeto. Requer project_uuid de get-projects.

  • Escopo: mcp:projects-read
  • Entrada: project_uuid, opcional include
  • include: all, form, contact
  • Somente leitura
  • Não destrutiva

get-tags

Liste atributos em um projeto. Requer project_uuid de get-projects. Opções de include: all, form, contact.

  • Escopo: mcp:projects-read
  • Entrada: project_uuid
  • Somente leitura
  • Não destrutiva

Recursos

Os recursos fornecem leituras baseadas em URI para clientes MCP que suportam recursos.

Recursos disponíveis:

  • refiner://projects
  • refiner://project/{project_uuid}/forms
  • refiner://project/{project_uuid}/form/{form_uuid}
  • refiner://project/{project_uuid}/segments
  • refiner://project/{project_uuid}/tags

Comportamento:

  • Tipo MIME: application/json
  • Mesmas verificações de escopo e acesso a projetos que as ferramentas correspondentes
  • Respostas estruturadas consistentes e erros de acesso explícitos

Exemplos de prompts

O Refiner expõe prompts MCP integrados para orientar fluxos de trabalho robustos de análise em várias etapas.

Prompts integrados

  • nps_get_score_and_counts
  • csat_get_score_and_counts
  • multiple_choice_response_distribution
  • retrieve_survey_responses
  • nps_analyze_verbatim
  • csat_analyze_verbatim
  • analyze_open_ended_text_responses

Exemplos de prompts de usuário

  • "Liste meus ambientes e pesquisas Refiner disponíveis."
  • "Mostre a pontuação NPS e as contagens de detratores/passivos/promotores dos últimos 30 dias."
  • "Analise os verbatims recentes de texto aberto do NPS e me diga quais são os maiores impulsionadores da pontuação atual. Diga-me o que fazemos certo e o que podemos melhorar com base nos verbatims de texto aberto."
  • "Qual é a nossa pontuação CSAT atual no projeto X no Refiner?"
  • "Mostre a pontuação CSAT e a distribuição da pesquisa X no 1º trimestre."
  • "Recupere respostas marcadas como risco-de-churn dos últimos 14 dias."
  • "Analise o feedback de resposta aberta e sugira as principais ações de melhoria."
  • "Mostre a distribuição de respostas de múltipla escolha para a pergunta onboarding_experience."