121surveys
Iniciar sessão
Menu

Integração com o Claude

Criar e analisar inquéritos com o Claude – através do servidor MCP da 121surveys

A 121surveys disponibiliza um servidor MCP (Model Context Protocol) em https://www.121surveys.com/mcp. Através dele, o Claude e outros assistentes de IA chegam à maior parte do editor e da análise: criar questionários com lógica de filtros e métodos de estudo, testar cada percurso, ler resultados e simular mercados conjoint – exatamente com os direitos e a função da pessoa que concedeu o acesso.

Criar e testar é grátis. Para publicar, escolhes um plano pago.

O que o Claude pode fazer na 121surveys através do MCP

  • Construir o questionário

    O Claude cria um rascunho, acrescenta páginas e insere perguntas uma a uma ou em lote – tudo ou nada, com uma mensagem de erro por cada entrada inválida. As perguntas podem ser alteradas, movidas e duplicadas; há ainda variáveis de ligação, ações após o envio e o banco de perguntas com sorteio aleatório.

  • Lógica de filtros e métodos de estudo

    O Claude define condições de página, ramificações com saltos ou fim do inquérito e condições em perguntas isoladas tal como no editor; a lógica inválida é recusada com o motivo. Para estudos de mercado há perguntas de método próprias, entre elas conjoint, conjoint de menu, MaxDiff, brand-price trade-off, Van Westendorp, Gabor-Granger, Kano, teste de alegações, teste A/B de imagens e mapa de calor.

  • Teste de todos os percursos

    Antes de publicar, o Claude corre a mesma verificação que a caixa de publicação e cria submissões de teste: uma por cada percurso possível no inquérito, ou um número à escolha com respostas aleatórias. A resposta indica, por percurso, as páginas, as respostas que o determinam e o fim. Os dados de teste não contam em nenhuma estatística.

  • Resultados e estatística

    O Claude lê indicadores, respostas por pergunta, tabelas cruzadas com teste do qui-quadrado, análise NPS, evoluções, correlações, o relatório de qualidade e as quotas – com os mesmos números da análise da aplicação. Cada pergunta de método tem a sua ferramenta de resultados, e os dados brutos chegam por uma ligação de exportação assinada e de curta duração.

  • Simulação conjoint e portefólio

    O simulador de mercado calcula quotas de preferência pela regra logit para produtos que tu defines, também contra a opção «nenhum destes». A partir de cenários de portefólio com regras, custos unitários e margem mínima, o Claude procura a melhor oferta de produtos – por margem de contribuição ou alcance, com um intervalo de incerteza sobre as extrações bayesianas hierárquicas.

  • Distribuir e consultar créditos

    O Claude cria ligações de distribuição e ligações de utilização única, e envia convites pessoais e lembretes a quem ainda não terminou. get_credits mostra os créditos disponíveis, os saldos com data de validade e as respostas em espera; não é possível comprar créditos através do MCP.

Ligar em três passos

  1. Introduzir o endereço

    No claude.ai, acrescentas nas definições um conector personalizado com o endereço https://www.121surveys.com/mcp; o ChatGPT aceita o mesmo endereço como conector. O Claude Desktop, o Claude Code e programas próprios ligam-se com uma chave API que as pessoas com a função Administrador criam em Gerir workspace → API, MCP & webhooks.

  2. Conceder acesso

    Ao ligar por OAuth, inicias sessão no navegador, escolhes o workspace e confirmas os direitos – não é precisa nenhuma chave. O token de acesso é de curta duração e renova-se automaticamente. Com chave, introduzes-a como token Bearer na configuração; no Claude Desktop, através do pacote mcp-remote.

  3. Verificar a ligação

    Pede ao Claude que chame whoami: a resposta indica a pessoa, o workspace e os direitos concedidos. Quando surgem ferramentas novas, desligas o conector e voltas a ligá-lo; com chave, basta reiniciar a aplicação. O n8n e o Make usam a mesma chave na API REST.

Direitos, funções e bloqueio de eliminação

Que direitos recebe o assistente?

As chaves e o OAuth têm os mesmos quatro scopes: read, write, admin e delete. admin e delete só podem ser concedidos por pessoas com a função Proprietário ou Administrador da conta; a qualquer outro membro, a página de consentimento concede o resto e explica porquê. As tuas ligações desligas em A minha conta → Aplicações ligadas, e o acesso termina de imediato.

O Claude pode fazer mais do que eu na aplicação?

Não. O assistente age como a pessoa que concedeu o acesso. Cada ferramenta exige a mesma função mínima que a parte da aplicação que faz o mesmo – de Visualizador a Administrador. tools/list só mostra o que a função permite, e antes de cada chamada a função é relida, para que uma mudança tenha efeito imediato.

O Claude pode eliminar inquéritos?

Só atrás de um bloqueio triplo: o acesso tem o scope delete, pertence a uma pessoa com a função Proprietário ou Administrador da conta, e o interruptor «Permitir eliminar através de assistentes de IA e da API» está ligado – por predefinição está desligado. O bloqueio volta a ser verificado antes de cada chamada que elimina. Só se elimina o que ainda não está em uso, como uma pergunta num rascunho ou um inquérito sem submissões.

Como distingue o assistente as ferramentas de leitura das de escrita?

Cada ferramenta está marcada como de leitura ou de escrita segundo a especificação MCP, para que o claude.ai possa permitir todas as leituras com um clique. As ferramentas de escrita estão ainda marcadas como aditivas ou de substituição, e os convites como envio para fora. As chamadas são limitadas por chave e por minuto, e cada chamada fica registada com o nome da ferramenta.

Três exemplos de prompts

«Cria um inquérito a clientes com NPS em três páginas, mostra aos detratores uma página extra com uma pergunta aberta e testa todos os percursos.»

O Claude cria um rascunho com create_survey_draft, acrescenta páginas com add_page e as perguntas com add_questions, coloca com set_page_logic a condição «NPS menor ou igual a 6» na página extra e chama run_auto_test. A resposta lista cada percurso com as suas páginas; só se publica quando o pedires.

«Resume as respostas abertas do inquérito “Formação 2026” em temas com citações e diz-me o NPS com promotores e detratores.»

O Claude segue o modelo summarize_open_answers: get_survey devolve as perguntas, list_submissions e get_submission_answers as respostas, e os temas são formados pelo próprio Claude. O NPS vem de get_nps_analysis. O resumo é escrito pelo Claude e não pela funcionalidade de IA da 121surveys – as respostas são, portanto, tratadas pelo fornecedor do teu assistente.

«Simula na pergunta conjoint a quota de preferência do nosso plano Pro a 19 euros contra os dois concorrentes e propõe um portefólio de dois produtos com a maior margem de contribuição.»

O Claude lê atributos e níveis com get_conjoint_results, calcula as quotas com simulate_conjoint_market e procura o melhor par com optimize_conjoint_portfolio num cenário de portefólio com custos unitários. Se o cenário não existir, o Claude cria-o com set_portfolio_scenario, a partir da função Analista. Se o cálculo ainda estiver a decorrer, volta o estado pending e o Claude pergunta de novo mais tarde.

Perguntas frequentes

O que é o MCP?

O Model Context Protocol é um protocolo aberto através do qual assistentes de IA chamam ferramentas de aplicações externas. A 121surveys é MCP-first: o servidor MCP disponibiliza as funções da aplicação como ferramentas, além de modelos (prompts) para análises típicas e recursos como os resultados de um inquérito em CSV.

Com que assistentes funciona?

Com início de sessão (OAuth) em assistentes onde podes acrescentar conectores próprios, como o claude.ai ou o ChatGPT. Com chave API no Claude Desktop, no Claude Code, na Responses API da OpenAI e em scripts próprios. Ferramentas de automatização como o n8n e o Make usam a API REST com a mesma chave.

O Claude usa as funcionalidades de IA da 121surveys?

Não. Através do MCP não há nenhuma funcionalidade de IA da 121surveys: categorização, resumo, análise de texto por IA e tradução só funcionam na interface. Quando o Claude analisa respostas, quem as trata é o fornecedor do teu assistente. A limpeza automática de dados pessoais que antecede as funcionalidades de IA da 121surveys não se aplica aos dados que um assistente lê através do MCP.

Quanto custa a utilização através do MCP?

Cada chamada a uma ferramenta conta para a quota mensal de API do teu plano; é um limite de proteção, não uma faturação em créditos. Só as respostas concluídas e importadas consomem créditos – submissões de teste e e-mails de convite são gratuitos. A utilização do próprio assistente corre pelo teu contrato com o respetivo fornecedor.

O que não é possível através do MCP?

Propositadamente não disponíveis através do MCP estão a análise de texto por IA e as restantes funcionalidades de IA, a compra de créditos, os planos e a faturação. check_survey_translations lê o estado das traduções – campos em falta e textos de IA por rever –, mas marcá-los como revistos fica reservado a uma pessoa na aplicação. Eliminar também não é possível sem o bloqueio triplo.

Quem pode configurar um acesso?

As chaves API só são criadas por pessoas com a função Administrador; editar, rodar e revogar chaves de outras pessoas cabe apenas a proprietários e administradores da conta. Com OAuth, cada pessoa liga-se por si e recebe, no máximo, os seus próprios direitos. Cada função vê e desliga as suas ligações em A minha conta → Aplicações ligadas; as dos outros, só proprietários e administradores da conta, em Gerir workspace → API, MCP & webhooks.

Ligar o Claude à 121surveys

Cria uma conta, acrescenta o endereço https://www.121surveys.com/mcp como conector e deixa o Claude criar e testar um primeiro rascunho. Criar e testar o questionário é grátis; a página para programadores lista todas as ferramentas.

Começa grátis