WebAsk MCP
Crie pesquisas, colete respostas e gere relatórios no WebAsk a partir de assistentes de IA usando 161 ferramentas MCP.
Servidor MCP hospedado
npx add-mcp 'https://mcp.webask.io/mcp/v1'Instala no Claude Code, Codex, Cursor e outros
Documentação
Início rápido · 25 habilidades · 161 ferramenta · O que pedir · English
Servidor MCP WebAsk e habilidades (skills) prontas para assistentes de IA. O assistente monta o questionário a partir da descrição, verifica antes de publicar, lê as respostas e gera o relatório para o cliente. Você apenas diz o que precisa.
Funciona com Claude Code, Claude Desktop, Cursor, VS Code, Codex e Gemini CLI.
Вы: Сделай анкету для клиентов автосервиса: оценить работу и собрать контакты
для повторной записи.
ИИ: ✓ подобрал типы вопросов ✓ собрал 7 вопросов и 2 ветвления ✓ применил тему
Черновик готов, пока его видите только вы. Публикуем?
Início rápido
- Crie uma chave. No painel do WebAsk, abra Configurações → API / MCP e clique em "Criar chave de API". A chave é exibida apenas uma vez; salve-a imediatamente.
- Conecte o servidor
https://mcp.webask.io/mcp/v1ao assistente. Comandos e configurações prontos abaixo. - Peça: "Mostre minhas pesquisas e quantas respostas chegaram na semana".
Claude Code: tudo em uma única instalação
O plugin instala o servidor MCP e todas as 25 habilidades de uma vez. O Claude Code solicitará a chave durante a instalação e a salvará no armazenamento de senhas do sistema.
/plugin marketplace add WebAskio/webask-mcp
/plugin install webask@webask
Se precisar apenas do servidor, sem as habilidades:
claude mcp add --transport http webask https://mcp.webask.io/mcp/v1 \
--header "Authorization: Bearer YOUR_API_KEY"
Outros clientes
Com um clique:
O VS Code solicitará a chave automaticamente. No Cursor, após a instalação, abra as configurações do servidor webask e substitua
YOUR_API_KEY pela chave.
Manualmente — nas configurações abaixo, substitua YOUR_API_KEY pela sua chave.
Claude Desktop
Settings → Developer → Edit Config, no arquivo claude_desktop_config.json. É necessário ter o Node.js instalado:
ele é usado pelo mcp-remote, que transmite a chave ao servidor.
{
"mcpServers": {
"webask": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.webask.io/mcp/v1", "--header", "Authorization:${WEBASK_AUTH}"],
"env": { "WEBASK_AUTH": "Bearer YOUR_API_KEY" }
}
}
}
Após salvar, reinicie o Claude Desktop.
Cursor
Settings → MCP → Add new global MCP server, ou diretamente no arquivo ~/.cursor/mcp.json:
{
"mcpServers": {
"webask": {
"url": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
VS Code
Arquivo .vscode/mcp.json no projeto. O VS Code solicitará a chave na primeira execução e a salvará localmente; ela não
ficará no arquivo:
{
"inputs": [
{ "type": "promptString", "id": "webask-api-key", "description": "WebAsk API key", "password": true }
],
"servers": {
"webask": {
"type": "http",
"url": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer ${input:webask-api-key}" }
}
}
}
Codex
No arquivo ~/.codex/config.toml:
[mcp_servers.webask]
url = "https://mcp.webask.io/mcp/v1"
bearer_token_env_var = "WEBASK_API_KEY"
O Codex obtém a chave da variável de ambiente: export WEBASK_API_KEY=YOUR_API_KEY.
Gemini CLI
Por extensão — servidor e todas as habilidades de uma vez; o Gemini solicitará a chave durante a instalação:
gemini extensions install https://github.com/WebAskio/webask-mcp
Ou apenas o servidor, no arquivo ~/.gemini/settings.json:
{
"mcpServers": {
"webask": {
"httpUrl": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
As mesmas configurações em arquivos separados estão em clients/; instruções passo a passo em
docs/connect.md.
O que é isso
| Endereço do servidor | https://mcp.webask.io/mcp/v1 |
| Transporte | Streamable HTTP, nada precisa ser implantado do seu lado |
| Autenticação | Chave de API no cabeçalho Authorization: Bearer … |
| Ferramentas | 161: 57 apenas leem, 24 são irreversíveis e o servidor as sinaliza. Lista completa |
| Permissões | As mesmas do construtor: papel de participante e plano do espaço |
| Limites | 180 requisições por minuto; links de exportação válidos por uma hora |
O que ele faz
Pesquisas. Criar uma pesquisa a partir de uma descrição ou modelo, configurar perguntas, ramificações, variáveis e campos ocultos. Aplicar tema, publicar, restaurar versão anterior.
Distribuição. Link, QR code, senha para a pesquisa, versão para impressão, códigos promocionais, agendamento online com horários.
Respostas. Ler, marcar com tags e notas, ocultar itens desnecessários, remover respostas de teste.
Relatórios. Resumo, relatório com filtros, relatório de IA, links públicos para o cliente. Exportações em Excel, CSV, SPSS, Word e PDF.
Leads. Notificações por e-mail e SMTP próprio, webhooks com registro de entrega, CRM e amoCRM, Google Planilhas, mensageiros, Zapier.
Conta. Participantes e papéis, pastas e permissões de acesso, branding, domínio próprio, arquivos e armazenamento.
Ferramentas por seção — em docs/tools.md; frases prontas — em docs/prompts.md.
Habilidades
Uma habilidade é uma metodologia pronta para o assistente. Você pede "analise as respostas abertas", e a habilidade orienta quais ferramentas chamar, em que ordem e como apresentar o resultado. As habilidades não contêm código; são instruções de texto: nada é instalado ou executado.
Criar e distribuir
| Habilidade | O que oferece | Baixar |
|---|---|---|
| Criação de pesquisa a partir de descrição | Descreva a tarefa em palavras — receba uma pesquisa pronta, não uma lista de perguntas | ZIP |
| Reescrever formulações | Reescreve as perguntas para que a pesquisa seja concluída — e começa pelos dados, não pelo gosto | ZIP |
| Lógica de exibição e rotas | Monta a ramificação para que nenhum respondente fique preso | ZIP |
| Materiais para lançamento | Reúne tudo para o lançamento de uma vez: links com tags, textos de anúncio e QR code | ZIP |
| Distribuição da pesquisa | Prepara a pesquisa para distribuição para que depois seja possível ver de qual canal vieram as respostas | ZIP |
Verificar antes de publicar
| Habilidade | O que oferece | Baixar |
|---|---|---|
| Verificação da pesquisa antes do lançamento | Encontra o que vai falhar com respondentes reais antes que o link seja enviado a alguém | ZIP |
| Qualidade dos dados coletados | Responde se é possível confiar nesses dados antes que conclusões sejam tiradas | ZIP |
Entender os resultados
| Habilidade | O que oferece | Baixar |
|---|---|---|
| Análise dos resultados da pesquisa | Responde ao "e aí, como foi a pesquisa" com números e conclusões, não com exportação de respostas brutas | ZIP |
| Análise de variantes A/B | Responde se a diferença entre as variantes é real ou apenas aleatoriedade | ZIP |
| Comparação com o passado | Compara a pesquisa com ela mesma no passado: um número isolado não significa nada; a diferença significa | ZIP |
| Análise de respostas abertas | Transforma centenas de linhas de texto livre em alguns temas com números e citações | ZIP |
| Funil de conclusão | Mostra em qual pergunta as pessoas fecham a aba — e por quê | ZIP |
| Quantas respostas são necessárias | Responde se o que já foi coletado é suficiente e quanto mais é preciso para que as conclusões não mudem | ZIP |
| Linha do tempo da pesquisa | Responde ao "por que as respostas pararam de chegar", cruzando a coleta com o histórico de edições | ZIP |
| Comparação de fontes | Mostra qual canal trouxe pessoas e qual trouxe apenas números | ZIP |
| Resultados para o cliente | Reúne os resultados em algo que pode ser enviado: link, arquivo ou relatório com conclusões | ZIP |
| Formatação de relatórios e tema da pesquisa | Organiza o que é visto externamente: tema da pesquisa, paleta de relatórios e logotipo | ZIP |
Gerenciar leads
| Habilidade | O que oferece | Baixar |
|---|---|---|
| Notificações de novas respostas | Configura para onde avisar sobre novas respostas e corrige quando as notificações param | ZIP |
| Configuração de webhook | Configura o envio de respostas para o seu endereço e verifica imediatamente se o receptor as aceitou | ZIP |
| Por que as respostas não chegam | Descobre por que os leads não chegam ao CRM, Telegram ou planilha — e o que fazer | ZIP |
| Qualidade dos leads | Calcula não a taxa de conclusão, mas quantas pessoas deixaram um contato utilizável | ZIP |
Organização da conta
| Habilidade | O que oferece | Baixar |
|---|---|---|
| Auditoria da conta | Mostra em um único relatório onde a conta perde respostas, espaço e dinheiro | ZIP |
| Organização das respostas | Remove respostas de teste e duplicatas, mas primeiro mostra exatamente o que será limpo | ZIP |
| Organização da conta | A habilidade organiza as pesquisas acumuladas, salva as respostas e mostra o plano de mudanças antes de alterar qualquer coisa. | ZIP |
| Participantes e acessos | Descobre por que um participante não vê as pesquisas e concede exatamente as permissões necessárias | ZIP |
Todas as habilidades em um único arquivo: webask-skills-ru.zip. Vitrine com exemplos de resultados — webask.io/skills.
Como instalar uma habilidade sem plugin
Com um único comando em qualquer assistente — skills encontra automaticamente os agentes instalados e pergunta onde colocar as habilidades:
npx skills add https://github.com/WebAskio/webask-mcp/tree/main/skills
Ou manualmente: descompacte o arquivo na pasta da qual seu assistente lê as habilidades e reinicie-o.
| Assistente | Pasta no projeto |
|---|---|
| Claude Code | .claude/skills/ |
| Codex, Cursor | .agents/skills/ |
| Gemini CLI | .gemini/skills/ |
Seu assistente não está na tabela? Experimente .agents/skills/; a maioria dos clientes entende essa pasta.
Detalhes — em skills/README.md.
Segurança
- A chave dá ao assistente as mesmas permissões que você tem no espaço. Você pode revogá-la a qualquer momento: Configurações → API / MCP.
- Ferramentas irreversíveis — exclusão de pesquisas, limpeza de respostas e similares — são sinalizadas pelo servidor com a anotação
destructiveHint, para que o cliente veja que a chamada não pode ser desfeita. - Cada habilidade tem uma seção "O que não fazer": o que o assistente não pode fazer sem a sua autorização.
- Não há segredos no repositório e não deve haver: nas configurações, em vez da chave, está
YOUR_API_KEY. Se encontrar algo parecido com uma chave real — escreva para nós, veja SECURITY.md.
Links
Licença
MIT, veja LICENSE. A licença se aplica ao conteúdo do repositório: documentação, configurações e habilidades. O próprio serviço WebAsk opera sob o contrato do usuário.