MCP Server

Model Context Protocol (MCP) — стандарт, позволяющий AI-моделям (Claude, Cursor, Copilot и др.) подключаться к WebAsk и работать с вашими данными напрямую: читать опросы, ответы, аналитику и выполнять действия без ручного копирования.

1. Подключение

Получение API-ключа

1. Войдите в свой аккаунт WebAsk.
2. Перейдите в раздел Настройки → API / MCP.
3. Нажмите «Создать API-ключ» и скопируйте его — ключ показывается только один раз.

Эндпоинт

Аутентификация

Передайте API-ключ в заголовке Authorization:

Конфигурация для Claude Desktop

Файл claude_desktop_config.json

Клиент общается с MCP-серверами через stdio, поэтому удалённый сервер подключается через прокси. Ниже сторонний пакет mcp-remote: своего npm-пакета у WebAsk нет.

{
  "mcpServers": {
    "webask": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.webask.io/mcp/v1",
        "--header",
        "Authorization:${WEBASK_AUTH}"
      ],
      "env": {
        "WEBASK_AUTH": "Bearer <ваш_api_ключ>"
      }
    }
  }
}

• После Authorization: пробела нет намеренно, а слово Bearer вынесено в переменную окружения: Claude Desktop под Windows и Cursor не экранируют пробелы внутри args, и заголовок доходит искажённым. Это описано в документации самого mcp-remote.
• После правки файла клиент надо полностью закрыть и запустить заново.
• Нужны установленные Node.js и npm, команда npx должна работать из терминала.

Конфигурация для Cursor

Файл ~/.cursor/mcp.json. Прокси не нужен, ключ верхнего уровня mcpServers.

{
  "mcpServers": {
    "webask": {
      "url": "https://mcp.webask.io/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${env:WEBASK_API_KEY}"
      }
    }
  }
}

Конфигурация для VS Code

Файл .vscode/mcp.json. Ключ верхнего уровня здесь другой, servers, и нужен тип транспорта.

{
  "servers": {
    "webask": {
      "type": "http",
      "url": "https://mcp.webask.io/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${input:webask-api-key}"
      }
    }
  }
}

Лимиты

• 180 запросов в минуту на пользователя (tools/call, resources/read и т.д.)
• Экспортные ссылки действуют 1 час

2. Ресурсы (Resources)

Ресурсы предназначены только для чтения данных. Для их вызова отправляется запрос resources/read с соответствующим URI.

3. Инструменты (Tools)

Tools — действия, которые выполняются на стороне WebAsk по запросу AI-модели через метод tools/call.

4. Технические детали

Стандартные JSON-RPC методы

Пример запроса

POST https://mcp.webask.io/mcp/v1
Authorization: Bearer 42|xK7mP9nQ2wL5eH8jR3vU6tY0iD4aF1bG
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "rename_quiz",
    "arguments": {
      "quiz_id": 123,
      "name": "Новое название опроса"
    }
  }
}

Формат ответа при ошибке

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params: quiz_id is required"
  }
}

5. Типичные сценарии