WebAsk

Registre officiel IA et agents

Build surveys, read answers and make reports in WebAsk from an AI assistant.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code
claude mcp add --transport http webask 'https://mcp.webask.io/mcp/v1' --header 'Authorization: <WebAsk API key: Settings → API / MCP>'
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "webask": {
            "type": "http",
            "url": "https://mcp.webask.io/mcp/v1",
            "headers": {
                "Authorization": "<WebAsk API key: Settings → API / MCP>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Быстрый старт
  2. Что это такое
  3. Что умеет
  4. Навыки
  5. Безопасность
  6. Ссылки
  7. Лицензия

Быстрый старт · 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 на свой ключ.

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 работает по пользовательскому соглашению.

Questions fréquentes

Qu'est-ce que WebAsk ?

Build surveys, read answers and make reports in WebAsk from an AI assistant.

Comment installer WebAsk ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http webask 'https://mcp.webask.io/mcp/v1' --header 'Authorization: <WebAsk API key: Settings → API / MCP>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour WebAsk ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

WebAsk est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient WebAsk ?

Il est publié par WebAskio. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.