{
  "product": "MCP access — онбординг по ссылке",
  "what": "Каталог инструментов с ценами, знакомство без ключа, ключ через дверь гейта после входа Zitadel (credits=0).",
  "link": "https://access.kiberos.ai/",
  "steps": [
    {
      "step": 1,
      "action": "catalog",
      "where": "MCP https://access.kiberos.ai/mcp (tools/call catalog)",
      "next_step": "try",
      "needs_key": false
    },
    {
      "step": 2,
      "action": "try",
      "where": "MCP tools/call try",
      "args": {
        "tool": "catalog"
      },
      "next_step": "register",
      "needs_key": false,
      "note": "проба — дверной инструмент catalog/describe; гейтовые (в т.ч. intro с ценой 0) требуют ключ"
    },
    {
      "step": 3,
      "action": "register",
      "where": "MCP tools/call register → ссылка Zitadel (PKCE)",
      "next_step": "authorize",
      "needs_key": false
    },
    {
      "step": 4,
      "action": "status",
      "where": "MCP tools/call status {token: status_token}",
      "next_step": "call",
      "needs_key": false
    },
    {
      "step": 5,
      "action": "call",
      "where": "MCP tools/call с заголовком X-API-Key: $MCP_ACCESS_KEY",
      "next_step": "receipt",
      "needs_key": true
    }
  ],
  "identity": {
    "source": "GET https://access.kiberos.ai/catalog → _meta.visitor_token (агент) ИЛИ Set-Cookie onb_vid (браузер)",
    "pass_as": "arguments.visitor_token в tools/call try",
    "cookie": "onb_vid: HttpOnly; Secure; SameSite=Lax; Max-Age 30 дн — сохранять не нужно, но и не терять",
    "note": "visitor_token одноразовый на вызов: для второго try — новый GET /catalog (иначе trial_quota_exceeded)"
  },
  "trial": {
    "tool": "catalog",
    "how": "tools/call try {tool:\"catalog\"} — дверной инструмент, работает без ключа",
    "catalog_tools_require_key": true,
    "note": "гейтовые инструменты (echo; intro с ценой 0) без ключа НЕ вызываются: гейт отвечает -32402 missing_api_key"
  },
  "endpoints": {
    "mcp": "https://access.kiberos.ai/mcp",
    "catalog": "https://access.kiberos.ai/catalog",
    "pricing": "https://access.kiberos.ai/pricing",
    "login": "https://access.kiberos.ai/auth/start",
    "health": "https://access.kiberos.ai/health"
  },
  "price_source": "gate /pricing",
  "connection": {
    "transport": "streamable-http",
    "method": "POST",
    "url": "https://access.kiberos.ai/mcp",
    "content_type": "application/json",
    "protocol": "JSON-RPC 2.0 (MCP)",
    "auth": {
      "header": "X-API-Key",
      "scheme": "header",
      "when": "только после register → вход → выдача ключа; до ключа интро-инструменты работают без авторизации",
      "note": "ключ показывается ОДИН раз в ответе callback; второй раз его нет — сохранить сразу"
    },
    "key_storage": {
      "env": "MCP_ACCESS_KEY",
      "file": "0600 вне репозитория (не коммитить, не логировать)"
    },
    "example": {
      "intro_call_no_key": {
        "method": "POST",
        "url": "https://access.kiberos.ai/mcp",
        "headers": {
          "Content-Type": "application/json"
        },
        "body": {
          "jsonrpc": "2.0",
          "id": 1,
          "method": "tools/call",
          "params": {
            "name": "catalog",
            "arguments": {}
          }
        }
      },
      "paid_call_with_key": {
        "method": "POST",
        "url": "https://access.kiberos.ai/mcp",
        "headers": {
          "Content-Type": "application/json",
          "X-API-Key": "$MCP_ACCESS_KEY"
        },
        "body": {
          "jsonrpc": "2.0",
          "id": 2,
          "method": "tools/call",
          "params": {
            "name": "echo",
            "arguments": {
              "text": "hello"
            }
          }
        },
        "expected": "200 + JSON-RPC result; при нулевом балансе — -32402 insufficient_credits"
      }
    }
  },
  "receipt": {
    "url": "https://access.kiberos.ai/receipt",
    "method": "GET",
    "headers": {
      "X-API-Key": "$MCP_ACCESS_KEY"
    },
    "returns": "одно поле entitlement {key_id, credits, expires_at, allowed_tools, namespace} — read-only, без похода в биллинг",
    "note": "квитанция для человека: агент показывает состояние права, деньги не трогает"
  },
  "customer": {
    "field": "customer_id",
    "where": "ответ callback (выдача ключа) и tools/call status; в квитанции — _meta.customer_id",
    "model": "ключ/кредиты/право крепятся к customer_id; пересоздание учётки с той же ПОДТВЕРЖДЁННОЙ почтой = тот же customer_id",
    "consequence": "агент сохраняет customer_id вместе с ключом: по нему восстанавливается право, а не выдаётся второе",
    "limit": "без подтверждённой почты (email_verified) переноса нет — такой клиент будет новым, и это названо в ответе"
  },
  "_meta": {
    "next_step": "catalog",
    "visitor_source": "агентам: GET /catalog → _meta.visitor_token; браузерам: Set-Cookie onb_vid"
  }
}