WebAsk MCP
Xây dựng khảo sát, thu thập phản hồi và tạo báo cáo trong WebAsk từ các trợ lý AI bằng 161 công cụ MCP.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://mcp.webask.io/mcp/v1'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
Быстрый старт · 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 работает по пользовательскому соглашению.