WebAsk MCP
Build surveys, collect responses and create reports in WebAsk from AI assistants using 161 MCP tools.
Hosted MCP Server
npx add-mcp 'https://mcp.webask.io/mcp/v1'Installs into Claude Code, Codex, Cursor and more
Documentation
Быстрый старт · 25 навыков · 161 инструмент · Что попросить · English
MCP-сервер WebAsk и готовые навыки (skills) для ИИ-ассистента. Ассистент соберёт анкету по описанию, проверит её перед запуском, прочитает ответы и сделает отчёт для заказчика. Вы только говорите, что нужно.
Работает с Claude Code, Claude Desktop, Cursor, VS Code, Codex и Gemini CLI.
Вы: Сделай анкету для клиентов автосервиса: оценить работу и собрать контакты
для повторной записи.
ИИ: ✓ подобрал типы вопросов ✓ собрал 7 вопросов и 2 ветвления ✓ применил тему
Черновик готов, пока его видите только вы. Публикуем?
Быстрый старт
- Создайте ключ. В кабинете WebAsk откройте Настройки → API / MCP и нажмите «Создать API-ключ». Ключ показывается один раз, сохраните его сразу.
- Подключите сервер
https://mcp.webask.io/mcp/v1к ассистенту. Готовые команды и конфиги ниже. - Попросите: «Покажи мои опросы и сколько ответов пришло за неделю».
Claude Code: всё одной установкой
Плагин ставит MCP-сервер и все 25 навыков сразу. Ключ Claude Code спросит при установке и сохранит в системном хранилище паролей.
/plugin marketplace add WebAskio/webask-mcp
/plugin install webask@webask
Если нужен только сервер, без навыков:
claude mcp add --transport http webask https://mcp.webask.io/mcp/v1 \
--header "Authorization: Bearer YOUR_API_KEY"
Другие клиенты
В один клик:
VS Code спросит ключ сам. В Cursor после установки откройте настройки сервера webask и замените
YOUR_API_KEY на ключ.
Вручную — в конфигах ниже замените YOUR_API_KEY на свой ключ.
Claude Desktop
Settings → Developer → Edit Config, в файл claude_desktop_config.json. Нужен установленный Node.js:
его использует mcp-remote, он передаёт ключ серверу.
{
"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" }
}
}
}
После сохранения перезапустите Claude Desktop.
Cursor
Settings → MCP → Add new global MCP server, или напрямую в файл ~/.cursor/mcp.json:
{
"mcpServers": {
"webask": {
"url": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
VS Code
Файл .vscode/mcp.json в проекте. Ключ VS Code спросит при первом запуске и сохранит у себя, в файле его
не будет:
{
"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
В файл ~/.codex/config.toml:
[mcp_servers.webask]
url = "https://mcp.webask.io/mcp/v1"
bearer_token_env_var = "WEBASK_API_KEY"
Ключ Codex берёт из переменной окружения: export WEBASK_API_KEY=YOUR_API_KEY.
Gemini CLI
Расширением — сервер и все навыки сразу, ключ Gemini спросит при установке:
gemini extensions install https://github.com/WebAskio/webask-mcp
Или только сервер, в файл ~/.gemini/settings.json:
{
"mcpServers": {
"webask": {
"httpUrl": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Те же конфиги отдельными файлами лежат в clients/, пошаговая инструкция — в
docs/connect.md.
Что это такое
| Адрес сервера | https://mcp.webask.io/mcp/v1 |
| Транспорт | Streamable HTTP, на своей стороне ничего разворачивать не нужно |
| Авторизация | API-ключ в заголовке Authorization: Bearer … |
| Инструменты | 161: 57 только читают, 24 — необратимые, сервер их помечает. Весь список |
| Права | Те же, что в конструкторе: роль участника и тариф пространства |
| Лимиты | 180 запросов в минуту, ссылки на выгрузки действуют час |
Что умеет
Опросы. Собрать опрос по описанию или из шаблона, настроить вопросы, ветвления, переменные и скрытые поля. Применить тему, опубликовать, вернуть прошлую версию.
Раздача. Ссылка, QR-код, пароль на опрос, версия для печати, промокоды, онлайн-запись с расписанием.
Ответы. Прочитать, разметить тегами и заметками, скрыть лишнее, убрать тестовые.
Отчёты. Сводка, отчёт с фильтрами, AI-отчёт, публичные ссылки для заказчика. Выгрузки в Excel, CSV, SPSS, Word и PDF.
Заявки. Уведомления на почту и свой SMTP, вебхуки с журналом доставки, CRM и amoCRM, Google Таблицы, мессенджеры, Zapier.
Аккаунт. Участники и роли, папки и доступ к ним, брендинг, свой домен, файлы и хранилище.
Инструменты по разделам — в docs/tools.md, готовые фразы — в docs/prompts.md.
Навыки
Навык — готовая методика для ассистента. Вы просите «разбери открытые ответы», а навык подсказывает, какие инструменты вызвать, в каком порядке и как показать результат. Кода в навыках нет, это текстовые инструкции: ничего не устанавливается и не запускается.
Собрать и раздать
| Навык | Что даёт | Скачать |
|---|---|---|
| Сборка опроса по описанию | Опишите задачу словами — получите готовый опрос, а не список вопросов | ZIP |
| Переписать формулировки | Переписывает вопросы так, чтобы опрос дочитывали, — и начинает с данных, а не со вкуса | ZIP |
| Логика показа и маршруты | Собирает ветвление так, чтобы ни один респондент не упёрся в тупик | ZIP |
| Материалы для запуска | Собирает всё для запуска разом: ссылки с метками, тексты анонса и QR-код | ZIP |
| Раздача опроса | Готовит опрос к раздаче так, чтобы потом было видно, из какого канала пришли ответы | ZIP |
Проверить перед запуском
| Навык | Что даёт | Скачать |
|---|---|---|
| Проверка опроса перед запуском | Находит то, что сломается на живых респондентах, пока ссылку ещё никому не отправили | ZIP |
| Качество собранных данных | Отвечает, можно ли верить этим данным, до того как на них построят выводы | ZIP |
Понять результаты
| Навык | Что даёт | Скачать |
|---|---|---|
| Разбор результатов опроса | Отвечает на «ну и что там по опросу» цифрами с выводом, а не выгрузкой сырых ответов | ZIP |
| Анализ A/B-вариантов | Отвечает, реальна разница между вариантами или это случайность | ZIP |
| Сравнение с собой прошлым | Сравнивает опрос с ним же прошлым: отдельная цифра ничего не значит, разница — значит | ZIP |
| Разбор свободных ответов | Превращает сотню строк свободного текста в несколько тем с числами и цитатами | ZIP |
| Воронка прохождения | Показывает, на каком вопросе люди закрывают вкладку — и почему | ZIP |
| Сколько ответов нужно | Отвечает, хватает ли уже собранного и сколько ещё нужно, чтобы выводы не развернулись | ZIP |
| Хронология опроса | Отвечает на «почему перестали приходить ответы», сопоставляя сбор с историей правок | ZIP |
| Сравнение источников | Показывает, какой канал привёл людей, а какой — только цифры | ZIP |
| Результаты — заказчику | Собирает результаты в то, что можно отправить: ссылку, файл или отчёт с выводами | ZIP |
| Оформление отчётов и тема опроса | Приводит в порядок то, что видят снаружи: тему опроса, палитру отчётов и логотип | ZIP |
Довести заявки
| Навык | Что даёт | Скачать |
|---|---|---|
| Уведомления о новых ответах | Настраивает, куда сообщать о новых ответах, и чинит, когда сообщать перестало | ZIP |
| Настройка вебхука | Заводит отправку ответов на ваш адрес и сразу проверяет, что приёмник их принял | ZIP |
| Почему ответы не уходят | Находит, почему заявки не доходят до CRM, Telegram или таблицы — и что с этим делать | ZIP |
| Качество заявок | Считает не завершаемость, а сколько людей оставили пригодный контакт | ZIP |
Порядок в аккаунте
| Навык | Что даёт | Скачать |
|---|---|---|
| Аудит аккаунта | Показывает одним отчётом, где аккаунт теряет ответы, место и деньги | ZIP |
| Порядок в ответах | Убирает тестовые прохождения и дубли, но сначала показывает, что именно попадёт под чистку | ZIP |
| Порядок в аккаунте | Навык разберёт накопившиеся опросы, сохранит ответы и покажет план изменений до того, как что-либо поменяет. | ZIP |
| Участники и доступы | Разбирается, почему участник не видит опросы, и выдаёт ровно те права, что нужны | ZIP |
Все навыки одним архивом: webask-skills-ru.zip. Витрина с примерами результата — webask.io/skills.
Как поставить навык без плагина
Одной командой в любой ассистент — skills сам найдёт установленные агенты и спросит, куда положить навыки:
npx skills add https://github.com/WebAskio/webask-mcp/tree/main/skills
Или вручную: распакуйте архив в папку, из которой ваш ассистент читает навыки, и перезапустите его.
| Ассистент | Папка в проекте |
|---|---|
| Claude Code | .claude/skills/ |
| Codex, Cursor | .agents/skills/ |
| Gemini CLI | .gemini/skills/ |
Вашего ассистента нет в таблице? Попробуйте .agents/skills/, эту папку понимает большинство клиентов.
Подробности — в skills/README.md.
Безопасность
- Ключ даёт ассистенту те же права, что у вас в пространстве. Отозвать его можно в любой момент: Настройки → API / MCP.
- Необратимые инструменты — удаление опросов, чистка ответов и подобное — сервер помечает аннотацией
destructiveHint, чтобы клиент видел, что вызов не отменить. - В каждом навыке есть раздел «Чего не делать»: что ассистенту нельзя делать без вашего слова.
- Секретов в репозитории нет и не должно быть: в конфигах вместо ключа стоит
YOUR_API_KEY. Нашли что-то похожее на настоящий ключ — напишите нам, см. SECURITY.md.
Ссылки
Лицензия
MIT, см. LICENSE. Лицензия распространяется на содержимое репозитория: документацию, конфиги и навыки. Сам сервис WebAsk работает по пользовательскому соглашению.