Kirish Boshlash

Qo'llanma

Telegram MCP — Telegram akkauntingizni sun'iy intellekt yordamchilariga ulaydigan MCP server.

Boshlash

  1. Ro'yxatdan o'ting (email va parol).
  2. Telegram'ni ulang: QR kodni Telegram → Sozlamalar → Qurilmalar → «Kompyuterni ulash» orqali skanerlang yoki telefon raqam bilan kiring.
  3. MCP manzilini AI ilovangizga qo'shing: https://telegram.5k.uz/mcp

AI ilovaga ulash

  1. claude.ai → Settings → Connectors bo'limini oching (Claude Desktop ilovasida ham xuddi shu joyda).
  2. Add custom connector tugmasini bosing.
  3. Nomiga Telegram, URL maydoniga https://telegram.5k.uz/mcp manzilini kiriting va Add bosing.
  4. Connect bosing. Ochilgan oynada shu saytga kiring va Ruxsat berishni bosing.
  5. Suhbatda «+» → Connectors menyusidan Telegram'ni yoqing va «O'qilmagan xabarlarimni xulosala» deb yozing.
  1. ChatGPT'da Settings → Apps & Connectors → Advanced settings bo'limida Developer modeni yoqing (Plus, Pro, Business tariflari).
  2. Apps & Connectors sahifasida Create tugmasini bosing.
  3. Name: Telegram, MCP Server URL: https://telegram.5k.uz/mcp, Authentication: OAuth qilib qo'ying va saqlang.
  4. Ochilgan oynada shu saytga kiring va Ruxsat berishni bosing.
  5. Yangi chatda «+» → Developer mode orqali Telegram konnektorini tanlang.

OAuth orqali (tavsiya etiladi). Buyruqni bajaring, keyin Claude Code ichida /mcp yozib, Telegram'ni tanlang va brauzerda ruxsat bering:

claude mcp add --transport http --scope user telegram https://telegram.5k.uz/mcp

Yoki API kalit bilan:

claude mcp add --transport http --scope user telegram https://telegram.5k.uz/mcp --header "Authorization: Bearer YOUR_API_KEY"

~/.gemini/settings.json fayliga qo'shing:

{
  "mcpServers": {
    "telegram": {
      "httpUrl": "https://telegram.5k.uz/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Gemini CLI'ni qayta ishga tushiring va /mcp buyrug'i bilan tekshiring.

Cursor Settings → MCP → Add new MCP server yoki ~/.cursor/mcp.json fayli:

{
  "mcpServers": {
    "telegram": {
      "url": "https://telegram.5k.uz/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

headers qatorini olib tashlasangiz, Cursor OAuth orqali brauzerda ruxsat so'raydi.

Loyihada .vscode/mcp.json fayli (GitHub Copilot Agent mode):

{
  "servers": {
    "telegram": {
      "type": "http",
      "url": "https://telegram.5k.uz/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

MCP'ni qo'llab-quvvatlaydigan istalgan ilova uchun:

  • Transport: Streamable HTTP
  • URL: https://telegram.5k.uz/mcp
  • Avtorizatsiya: OAuth 2.1 (avtomatik aniqlanadi) yoki Authorization: Bearer <API kalit> sarlavhasi

Faqat stdio qo'llaydigan ilovalar uchun (Claude Desktop config, Windsurf va boshqalar) mcp-remote ko'prigi:

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://telegram.5k.uz/mcp",
               "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

API kalit kerak bo'lgan usullar uchun boshqaruv panelida «API kalitlar → Yangi» tugmasini bosing. Kalit shu yerdagi yo'riqnomalarga avtomatik qo'yiladi.

Asboblar

o'qish
get_me

Ulangan Telegram akkaunt haqida ma'lumot (ism, username, ID).

o'qish
list_chats

Telegram chatlari (dialoglar) ro'yxati: oxirgi xabar, o'qilmaganlar soni. Filtr va nom bo'yicha qidirish mumkin.

o'qish
get_messages

Bitta chatdagi xabarlarni o'qish (eng yangilari). Sahifalash uchun before_id, chat ichida qidirish uchun query.

o'qish
search_messages

Barcha chatlar bo'ylab (yoki bitta chatda) matn bo'yicha xabar qidirish.

o'qish
get_unread

O'qilmagan xabarlari bor chatlar va ulardagi oxirgi o'qilmagan xabarlar (xulosa uchun qulay).

o'qish
get_chat

Foydalanuvchi, guruh yoki kanal haqida batafsil ma'lumot (bio, a'zolar soni, holat).

o'qish
list_contacts

Telegram kontaktlari ro'yxati, ism/username/telefon bo'yicha qidirish bilan.

yozish
send_message

Foydalanuvchi nomidan Telegram xabar yuborish. Yuborishdan oldin matn va qabul qiluvchini foydalanuvchi bilan tasdiqlang.

yozish
mark_as_read

Chatdagi barcha xabarlarni o'qilgan deb belgilash.

yozish
forward_messages

Xabarlarni bir chatdan boshqasiga uzatish (forward).

o'zgartirish
edit_message

O'zingiz yuborgan xabar matnini o'zgartirish.

o'zgartirish
delete_messages

Xabarlarni o'chirish (qaytarib bo'lmaydi). Avval foydalanuvchidan aniq tasdiq oling.

Chatni bir necha usulda ko'rsatish mumkin: @username, raqamli ID, telefon raqam, chat nomi yoki me (Saqlangan xabarlar).

Ruxsatlar

  • O'qish doim yoqilgan: chatlar, xabarlar, qidiruv, kontaktlar.
  • Xabar yuborish: yuborish, uzatish, o'qilgan deb belgilash. Standart holatda yoqilgan, uni o'chirib qo'yishingiz mumkin.
  • Tahrirlash va o'chirish: standart holatda o'chirilgan.

O'chirilgan ruxsatga tegishli asboblar AI'ga umuman ko'rsatilmaydi.

Xavfsizlik

  • Telegram sessiyasi serverda shifrlangan holda saqlanadi.
  • Parollar Argon2id bilan xeshlanadi. Tokenlar va API kalitlar bazada faqat HMAC ko'rinishida saqlanadi.
  • OAuth 2.1, PKCE (S256) bilan. Access token 1 soat amal qiladi, refresh token 90 kun.
  • Telegram'da sessiya Telegram MCP nomi bilan ko'rinadi. Uni Telegram → Sozlamalar → Qurilmalar bo'limidan istalgan payt tugatish mumkin.
  • AI ilovalarga Telegram xabarlari ichidagi ko'rsatmalarga amal qilmaslik buyurilgan. Shunday bo'lsa ham, AI yuborgan xabarlarni kuzatib boring.

Muammolar

«Telegram akkaunt ulanmagan» xatosi

Telegram'ni ulang. Agar sessiyani Telegram'ning o'zidan tugatgan bo'lsangiz, qayta ulash kerak bo'ladi.

«Telegram cheklov qo'ydi (FloodWait)»

Telegram bir vaqtda juda ko'p so'rov yuborilganda vaqtincha cheklov qo'yadi. Ko'rsatilgan vaqt o'tgach qayta urinib ko'ring.

Kod kelmayapti

Kod SMS orqali emas, telefoningizdagi Telegram ilovasiga «Telegram» rasmiy chatiga keladi. QR kod usulini ham sinab ko'ring.

Dasturchilar uchun

curl -s https://telegram.5k.uz/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_me","arguments":{}}}'