mcp/inspect

Контекст запроса подключения. До входа токен необязателен; после входа используется обычный IQ session token.

GET /mcp-auth.php?method=inspect

Параметры

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

Условные значения REQUEST_ID_FROM_LOGIN_URL, IQ_SESSION_TOKEN, ONE_TIME_CODE и MCP_ACCESS_TOKEN замените своими. Пример PKCE-пары иллюстративный; агент создаёт собственную случайную пару для каждого подключения.

GET https://api.iq.academy/mcp-auth.php?method=inspect&request_id=REQUEST_ID_FROM_LOGIN_URL
Authorization: Bearer IQ_SESSION_TOKEN (необязательно)

Результат

HTTP/1.1 200 OK
Content-Type: application/json

{
  "ok": true,
  "data": {
    "request_id": "REQUEST_ID_FROM_LOGIN_URL",
    "client": {
      "id": "iq-academy-pilot",
      "name": "ИИ-агент"
    },
    "user": null,
    "requested_scopes": [
      "read",
      "write"
    ],
    "expires_at": "2026-10-18T18:10:00Z",
    "access_duration_seconds": 2592000
  }
}

До входа user=null. При передаче действующей IQ-сессии user содержит проверенные id и name. Запрос действует 10 минут, выдаваемый доступ — 30 дней.

Коды ошибок

Как в существующем API: ошибка возвращается с HTTP 200, error — строка с кодом. Проверяйте поле error, одного HTTP-статуса недостаточно.

Пример ошибки

{"error": "TOKEN_NOT_FOUND"}