Ulanish

3 qadamda uloqing

Quyida har bir mijoz uchun aniq ko'rsatmalar. Menyular vaqt o'tishi bilan o'zgarishi mumkin — bu holatlar uchun umumiy qoida: server manzilini kiriting va OAuth (yoki Bearer token) ni tanlang.

Server manzili

Avval shuni nusxalang

# MCP server manzili (barcha mijozlar uchun bir xil)
/mcp/mcp.php

Qaysi mijozda "OAuth" so'rasa — avtomatik ro'yxatdan o'tish (DCR) va kirish sahifasi ishlaydi. Qaysi birida Bearer token so'rasa — hujjatlardagi API kalitidan foydalaning.

Claude.ai — Custom connector

Claude.ai oching → Settings → Connectors → Add custom connector (menyu nomi vaqt o'tishi bilan o'zgarishi mumkin).
Nomi: Kirame
Server manzili: /mcp/mcp.php
Authentication turini Sign in now deb tanlang (OAuth oqimi boshlanadi).
Ochilgan sahifada Kirame hisobingiz bilan kiring va ruxsat bering.
Claude connectorni tekshiradi va Add ni bosing — tayyor.

"Couldn't register with ar's sign-in service" chiqsa — qayta urinib ko'ring yoki connector sozlamalarida Register automatically ni tanlang. Muammo davom etsa, sahifadagi eng pastdagi yechimlarni o'qing.

ChatGPT — Connector

ChatGPT → Settings → Connectors → Add connector.
Server manzilini kiriting: /mcp/mcp.php
OAuth oqimida kirishingiz so'raladi — Kirame hisobingiz bilan kiring.
Ruxsatdan so'ng connector ulanadi va vositalar ro'yxati yuklanadi.

ChatGPT versiyasiga qarab menyu nomi farq qilishi mumkin.

Claude Desktop / mcp-remote

Claude Desktop bevosita Streamable HTTP'ni qo'llab-quvvatlamasa, mcp-remote ko'prig'idan foydalaning:

{
  "mcpServers": {
    "aura-retail": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "/mcp/mcp.php"
      ]
    }
  }
}

Fayl: macOS/Windows'da claude_desktop_config.json, keyin Claude Desktop'ni qayta ishga tushiring.

Cursor

Cursor → Settings → MCP → Add new MCP Server.
Nomi: aura-retail
Turi: command (yoki HTTP bo'lsa url).
Quyidagi buyruqni kiriting:

npx -y mcp-remote /mcp/mcp.php

Keyin MCP Server ro'yxatida ulanishni tasdiqlang.

MCP Inspector yoki curl

# 1. Inizializatsiya
curl -X POST /mcp/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mcp_YOUR_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

# 2. Vositalar ro'yxati
curl -X POST /mcp/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mcp_YOUR_TOKEN" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. Inspector (brauzerda)
npx @modelcontextprotocol/inspector

Inspector'da Transport: Streamable HTTP, URL: manzil yuqoridagi, Authentication: Bearer.

Muammolar

Yechimlar jadvali

Eng ko'p uchraydigan xatolar va nima qilish kerak

Alomat	Sabab	Yechim
"Couldn't register with ar's sign-in service"	DCR endpoint yoki discovery javob bermadi	Sahifani yangilang; connectorda Register automatically tanlang; `/mcp/register` 202 qaytarishini tekshiring
"Couldn't check the server / determine how this server signs in"	401 javobda `resource_metadata` yo'q edi	Server yangilandi — qayta urinib ko'ring (endi RFC 9728 discovery ishlaydi)
401 Unauthorized loop	Token eskirgan yoki bekor qilingan	Yangi token oling yoki connectorni qayta ulang (OAuth refresh 30 kun)
Bo'sh vositalar ro'yxati	Tarif ruxsati yo'q yoki xato token	Max/Enterprise tarifini tekshiring, `/mcp/tools.json` ni oching
Authorization header yo'qoladi	Apache/FastCGI sarlavhani kesadi	`.htaccess`da `E=HTTP_AUTHORIZATION` qoidasi borligini tekshiring
Noto'g'ri Content-Type	`text/plain` yuborilgan	`Content-Type: application/json` qo'ying
PKCE mismatch	code_verifier mos kelmaydi	PKCE S256 yoqilgan bo'lishi kerak (eskirgan kodni qayta boshlang)
redirect_uri mismatch	URL registratsiyadagidan farq qiladi	`https://claude.ai/api/mcp/auth_callback` ro'yxatda bo'lishi shart
Javob buzilgan (gzip/ob)	Buffer JSON'ni buzadi	`ob_end_clean()` va `JSON_UNESCAPED_UNICODE` qo'llangan
Session xatosi	`Mcp-Session-Id` talab qilinadi	Server stateless — session headerni qayta ishlash shart emas