Спроси.Ева MCP Server

Обзор #

MCP-сервер Спроси.Ева реализует Model Context Protocol через Streamable HTTP. Он предоставляет инструменты для AI-агентов, позволяющие читать и записывать данные в аккаунте Спроси.Ева — без единой строки интеграционного кода.

Сервер использует транспорт JSON-RPC 2.0 через единственный эндпоинт POST /mcp. Аутентификация выполняется с помощью стандартного JWT Bearer-токена.

Эндпоинт #

Все MCP-запросы отправляются на единый эндпоинт:

Сервер поддерживает только метод POST. Методы GET и DELETE возвращают 405 Method Not Allowed.

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

Эндпоинт MCP требует действительный JWT Bearer-токен. Получите его, войдя через API Спроси.Ева, и передавайте с каждым запросом.

POST https://my.whyeva.ru/api/account/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "your-password"
}

Authorization: Bearer <your-access-token>

Быстрое подключение #

Добавьте MCP-сервер Спроси.Ева в ваш AI-клиент, вставив конфигурацию ниже. Замените на Bearer-токен, полученный выше.

{
  "mcpServers": {
    "whyeva": {
      "url": "https://my.whyeva.ru/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "whyeva": {
      "type": "http",
      "url": "https://my.whyeva.ru/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

{
  "servers": {
    "whyeva": {
      "type": "http",
      "url": "https://my.whyeva.ru/mcp",
      "headers": {
        "Authorization": "Bearer ${input:whyevaToken}"
      }
    }
  },
  "inputs": [
    {
      "id": "whyevaToken",
      "type": "promptString",
      "description": "Спроси.Ева JWT Bearer Token",
      "password": true
    }
  ]
}

{
  "mcpServers": {
    "whyeva": {
      "serverUrl": "https://my.whyeva.ru/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

curl -X POST https://my.whyeva.ru/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": { "name": "my-agent", "version": "1.0" }
    }
  }'

Инструменты #

Сервер предоставляет 29 инструментов, сгруппированных в три категории. Вызовите tools/list для получения полного списка с определениями JSON Schema.

Вакансии  16 tools

Вопросы  6 tools

Кандидаты  7 tools

Методы JSON-RPC #

Сервер реализует транспорт MCP Streamable HTTP с использованием JSON-RPC 2.0.

initialize

Выполняет MCP-рукопожатие и возвращает возможности сервера.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": { "name": "my-agent", "version": "1.0" }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": { "tools": { "listChanged": false } },
    "serverInfo": { "name": "WhyEva-MCP", "version": "1.0.0" }
  }
}

tools/list

Возвращает все доступные инструменты с их определениями JSON Schema.

{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }

tools/call

Вызывает конкретный инструмент по имени, передавая аргументы как JSON-объект.

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "getVacancy",
    "arguments": {
      "vacancyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  }
}

notifications/initialized

Отправляется клиентом после успешного initialize. Сервер возвращает 200 OK без тела.

Коды ошибок #