WebAsk

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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>'
إعداد 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>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

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

الأسئلة الشائعة

ما هو WebAsk؟

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

كيف أثبّت WebAsk؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http webask 'https://mcp.webask.io/mcp/v1' --header 'Authorization: <WebAsk API key: Settings → API / MCP>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج WebAsk إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل WebAsk مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون WebAsk؟

ينشره WebAskio. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.