webask-mcp

Быстрый старт  ·  25 навыков  ·  161 инструмент  ·  Что попросить  ·  English

MCP-сервер WebAsk и готовые навыки (skills) для ИИ-ассистента. Ассистент соберёт анкету по описанию, проверит её перед запуском, прочитает ответы и сделает отчёт для заказчика. Вы только говорите, что нужно.

Работает с Claude Code, Claude Desktop, Cursor, VS Code, Codex и Gemini CLI.

Вы:  Сделай анкету для клиентов автосервиса: оценить работу и собрать контакты
     для повторной записи.
ИИ:  ✓ подобрал типы вопросов  ✓ собрал 7 вопросов и 2 ветвления  ✓ применил тему
     Черновик готов, пока его видите только вы. Публикуем?

Быстрый старт

1. Создайте ключ. В кабинете WebAsk откройте Настройки → API / MCP и нажмите «Создать API-ключ». Ключ показывается один раз, сохраните его сразу.
2. Подключите сервер https://mcp.webask.io/mcp/v1 к ассистенту. Готовые команды и конфиги ниже.
3. Попросите: «Покажи мои опросы и сколько ответов пришло за неделю».

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 на свой ключ.

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.

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" }
    }
  }
}

Файл .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/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 спросит при установке:

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.

Ссылки

• Витрина навыков
• Документация MCP-сервера
• Поддержка
• Telegram · VK · MAX

Лицензия

MIT, см. LICENSE. Лицензия распространяется на содержимое репозитория: документацию, конфиги и навыки. Сам сервис WebAsk работает по пользовательскому соглашению.