mcp/complete

Завершить запрос с согласием или отказом. Требуется обычный IQ session token пользователя. Возвращает redirect_url; форма показывает результат, автоматически не перенаправляет.

POST JSON /mcp-auth.php?method=complete

Параметры

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

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

POST https://api.iq.academy/mcp-auth.php?method=complete
Authorization: Bearer IQ_SESSION_TOKEN
Content-Type: application/json

{
  "request_id": "REQUEST_ID_FROM_LOGIN_URL",
  "approved": true
}

Результат

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

{
  "ok": true,
  "data": {
    "status": "approved",
    "redirect_url": "http://127.0.0.1:49231/callback?code=ONE_TIME_CODE&state=RANDOM_STATE&iss=https%3A%2F%2Fapi.iq.academy",
    "code_expires_in": 120
  }
}

Фронт перенаправляет пользователя через window.location.replace(data.redirect_url). Форме ниже переход не выполняет: она только показывает ответ. При approved=false протокол возвращает status=denied и redirect_url с error=access_denied; текущий фронт требует галочку и отправляет true.

Пример результата при отказе

{
    "ok": true,
    "data": {
        "status": "denied",
        "redirect_url": "http://127.0.0.1:49231/callback?error=access_denied&state=RANDOM_STATE&iss=https%3A%2F%2Fapi.iq.academy"
    }
}

Коды ошибок

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

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

{"error": "TOKEN_NOT_FOUND"}