WebAsk MCP
Crea encuestas, recopila respuestas y genera informes en WebAsk desde asistentes de IA utilizando 161 herramientas MCP.
Servidor MCP alojado
npx add-mcp 'https://mcp.webask.io/mcp/v1'Se instala en Claude Code, Codex, Cursor y más
Documentación
Inicio rápido · 25 habilidades · 161 herramienta · Qué pedir · English
Servidor MCP WebAsk y habilidades (skills) listas para usar con tu asistente de IA. El asistente creará una encuesta según tu descripción, la revisará antes de lanzarla, leerá las respuestas y generará un informe para el cliente. Solo tú dices qué necesitas.
Funciona con Claude Code, Claude Desktop, Cursor, VS Code, Codex y Gemini CLI.
Вы: Сделай анкету для клиентов автосервиса: оценить работу и собрать контакты
для повторной записи.
ИИ: ✓ подобрал типы вопросов ✓ собрал 7 вопросов и 2 ветвления ✓ применил тему
Черновик готов, пока его видите только вы. Публикуем?
Inicio rápido
- Crea una clave. En el panel de WebAsk, abre Configuración → API / MCP y haz clic en «Crear clave API». La clave se muestra una sola vez, guárdala de inmediato.
- Conecta el servidor
https://mcp.webask.io/mcp/v1a tu asistente. Los comandos y configuraciones listos están abajo. - Pide: «Muéstrame mis encuestas y cuántas respuestas llegaron esta semana».
Claude Code: todo con una sola instalación
El plugin instala el servidor MCP y las 25 habilidades de una vez. Claude Code pedirá la clave durante la instalación y la guardará en el almacén de contraseñas del sistema.
/plugin marketplace add WebAskio/webask-mcp
/plugin install webask@webask
Si solo necesitas el servidor, sin habilidades:
claude mcp add --transport http webask https://mcp.webask.io/mcp/v1 \
--header "Authorization: Bearer YOUR_API_KEY"
Otros clientes
Con un clic:
VS Code pedirá la clave por sí mismo. En Cursor, después de la instalación, abre la configuración del servidor webask y reemplaza
YOUR_API_KEY por tu clave.
Manual: en las configuraciones de abajo, reemplaza YOUR_API_KEY por tu clave.
Claude Desktop
Settings → Developer → Edit Config, en el archivo claude_desktop_config.json. Se necesita Node.js instalado:
lo usa mcp-remote, que transmite la clave al 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" }
}
}
}
Después de guardar, reinicia Claude Desktop.
Cursor
Settings → MCP → Add new global MCP server, o directamente en el archivo ~/.cursor/mcp.json:
{
"mcpServers": {
"webask": {
"url": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
VS Code
Archivo .vscode/mcp.json en el proyecto. VS Code pedirá la clave en el primer inicio y la guardará internamente; no estará
en el archivo:
{
"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
En el archivo ~/.codex/config.toml:
[mcp_servers.webask]
url = "https://mcp.webask.io/mcp/v1"
bearer_token_env_var = "WEBASK_API_KEY"
Codex toma la clave de la variable de entorno: export WEBASK_API_KEY=YOUR_API_KEY.
Gemini CLI
Con la extensión: el servidor y todas las habilidades a la vez; Gemini pedirá la clave durante la instalación:
gemini extensions install https://github.com/WebAskio/webask-mcp
O solo el servidor, en el archivo ~/.gemini/settings.json:
{
"mcpServers": {
"webask": {
"httpUrl": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Las mismas configuraciones como archivos separados están en clients/; la guía paso a paso está en
docs/connect.md.
Qué es esto
| Dirección del servidor | https://mcp.webask.io/mcp/v1 |
| Transporte | Streamable HTTP, no necesitas desplegar nada en tu lado |
| Autorización | Clave API en el encabezado Authorization: Bearer … |
| Herramientas | 161: 57 solo leen, 24 son irreversibles y el servidor las marca. Lista completa |
| Permisos | Los mismos que en el constructor: rol de participante y tarifa del espacio |
| Límites | 180 solicitudes por minuto; los enlaces de exportación duran una hora |
Qué puede hacer
Encuestas. Crear una encuesta a partir de una descripción o plantilla, configurar preguntas, ramificaciones, variables y campos ocultos. Aplicar un tema, publicar, restaurar una versión anterior.
Distribución. Enlace, código QR, contraseña para la encuesta, versión para imprimir, códigos promocionales, reserva en línea con horario.
Respuestas. Leer, etiquetar con tags y notas, ocultar lo innecesario, eliminar las de prueba.
Informes. Resumen, informe con filtros, informe de IA, enlaces públicos para el cliente. Exportaciones a Excel, CSV, SPSS, Word y PDF.
Solicitudes. Notificaciones por correo y SMTP propio, webhooks con registro de entrega, CRM y amoCRM, Google Sheets, mensajeros, Zapier.
Cuenta. Participantes y roles, carpetas y acceso a ellas, marca, dominio propio, archivos y almacenamiento.
Herramientas por secciones — en docs/tools.md; frases listas — en docs/prompts.md.
Habilidades
Una habilidad es una metodología lista para el asistente. Pides «analiza las respuestas abiertas» y la habilidad indica qué herramientas llamar, en qué orden y cómo mostrar el resultado. Las habilidades no contienen código; son instrucciones de texto: no se instala ni se ejecuta nada.
Crear y distribuir
| Habilidad | Qué aporta | Descargar |
|---|---|---|
| Creación de encuesta a partir de una descripción | Describe la tarea con tus palabras y obtén una encuesta lista, no una lista de preguntas | ZIP |
| Reescribir formulaciones | Reescribe las preguntas para que la encuesta se complete hasta el final, y empieza por los datos, no por el gusto | ZIP |
| Lógica de visualización y rutas | Crea ramificaciones para que ningún encuestado llegue a un callejón sin salida | ZIP |
| Materiales para el lanzamiento | Reúne todo para lanzar de una vez: enlaces con etiquetas, textos de anuncio y código QR | ZIP |
| Distribución de la encuesta | Prepara la encuesta para distribuirla de modo que luego se vea de qué canal llegaron las respuestas | ZIP |
Revisar antes de lanzar
| Habilidad | Qué aporta | Descargar |
|---|---|---|
| Revisión de la encuesta antes del lanzamiento | Encuentra lo que fallará con encuestados reales antes de enviar el enlace a alguien | ZIP |
| Calidad de los datos recopilados | Responde si se puede confiar en estos datos antes de que se construyan conclusiones sobre ellos | ZIP |
Entender los resultados
| Habilidad | Qué aporta | Descargar |
|---|---|---|
| Análisis de resultados de la encuesta | Responde al «¿y qué hay con la encuesta?» con cifras y conclusiones, no con una exportación de respuestas crudas | ZIP |
| Análisis de variantes A/B | Responde si la diferencia entre variantes es real o es casualidad | ZIP |
| Comparación con tu yo del pasado | Compara la encuesta con la misma encuesta anterior: un número aislado no significa nada; la diferencia sí | ZIP |
| Análisis de respuestas abiertas | Convierte cien líneas de texto libre en varios temas con cifras y citas | ZIP |
| Embudo de finalización | Muestra en qué pregunta la gente cierra la pestaña y por qué | ZIP |
| Cuántas respuestas se necesitan | Responde si lo ya recopilado es suficiente y cuánto más se necesita para que las conclusiones no se inviertan | ZIP |
| Cronología de la encuesta | Responde al «¿por qué dejaron de llegar respuestas?» cruzando la recopilación con el historial de ediciones | ZIP |
| Comparación de fuentes | Muestra qué canal trajo personas y cuál solo cifras | ZIP |
| Resultados para el cliente | Reúne los resultados en algo que se pueda enviar: un enlace, un archivo o un informe con conclusiones | ZIP |
| Diseño de informes y tema de la encuesta | Ordena lo que se ve desde fuera: tema de la encuesta, paleta de informes y logotipo | ZIP |
Gestionar solicitudes
| Habilidad | Qué aporta | Descargar |
|---|---|---|
| Notificaciones de nuevas respuestas | Configura dónde avisar sobre nuevas respuestas y arregla cuando dejan de llegar | ZIP |
| Configuración de webhook | Activa el envío de respuestas a tu dirección y verifica de inmediato que el receptor las acepta | ZIP |
| Por qué no llegan las respuestas | Encuentra por qué las solicitudes no llegan al CRM, Telegram o la hoja de cálculo, y qué hacer al respecto | ZIP |
| Calidad de las solicitudes | Calcula no la tasa de finalización, sino cuántas personas dejaron un contacto utilizable | ZIP |
Orden en la cuenta
| Habilidad | Qué aporta | Descargar |
|---|---|---|
| Auditoría de la cuenta | Muestra en un solo informe dónde la cuenta pierde respuestas, espacio y dinero | ZIP |
| Orden en las respuestas | Elimina envíos de prueba y duplicados, pero primero muestra qué exactamente se limpiará | ZIP |
| Orden en la cuenta | La habilidad revisa las encuestas acumuladas, guarda las respuestas y muestra el plan de cambios antes de modificar nada. | ZIP |
| Participantes y accesos | Averigua por qué un participante no ve las encuestas y otorga exactamente los permisos necesarios | ZIP |
Todas las habilidades en un solo archivo: webask-skills-ru.zip. Escaparate con ejemplos de resultados — webask.io/skills.
Cómo instalar una habilidad sin el plugin
Con un solo comando en cualquier asistente — skills encuentra automáticamente los agentes instalados y pregunta dónde colocar las habilidades:
npx skills add https://github.com/WebAskio/webask-mcp/tree/main/skills
O manualmente: descomprime el archivo en la carpeta desde la que tu asistente lee las habilidades y reinícialo.
| Asistente | Carpeta en el proyecto |
|---|---|
| Claude Code | .claude/skills/ |
| Codex, Cursor | .agents/skills/ |
| Gemini CLI | .gemini/skills/ |
¿Tu asistente no está en la tabla? Prueba .agents/skills/, esa carpeta la entiende la mayoría de los clientes.
Detalles — en skills/README.md.
Seguridad
- La clave otorga al asistente los mismos permisos que tienes en tu espacio. Puedes revocarla en cualquier momento: Configuración → API / MCP.
- Las herramientas irreversibles — eliminar encuestas, limpiar respuestas y similares — el servidor las marca con la anotación
destructiveHintpara que el cliente vea que la llamada no se puede deshacer. - Cada habilidad incluye una sección «Qué no hacer»: lo que el asistente no debe hacer sin tu palabra.
- No hay secretos en el repositorio ni debería haberlos: en las configuraciones, en lugar de la clave está
YOUR_API_KEY. Si encuentras algo parecido a una clave real, escríbenos; consulta SECURITY.md.
Enlaces
Licencia
MIT, consulta LICENSE. La licencia cubre el contenido del repositorio: documentación, configuraciones y habilidades. El propio servicio WebAsk funciona según el acuerdo de usuario.