Claude Code’da MCP’ni sozlash usullari: 2026-yilda 7 ta integratsiya
MarkdownClaude Code’da MCP’ni claude mcp add buyrug‘i bilan 5 daqiqada sozlash: 7 ta integratsiya, stdio yoki HTTP, ruxsatlar ro‘yxati va hooklar.
Maqolani to‘liq o‘qish
Ailoot bilan ishlash bo‘yicha qo‘shimcha ko‘rsatmalar hujjatlarda berilgan.
MCP serveri nima va u Claude Code’ga nima uchun kerak?
Asosiy xulosa
MCP (Model Context Protocol) — Anthropic’ning ochiq standarti bo‘lib, Claude Code’ga yagona interfeys orqali tashqi vositalar va ma’lumotlardan foydalanish imkonini beradi. O‘nta turli API o‘rniga bitta protokol. Anthropic uni “AI ilovalari uchun USB-C” deb ataydi: portni ulang, shunda Claude ma’lumotlar bazangiz, elektron pochtangiz, messenjer yoki repozitoriyingizni ko‘ra oladi.
Anthropic MCP’ni 2024-yil 25-noyabrda ochiq standart sifatida e’lon qildi. Bir yil ichida protokol sanoat standartiga aylandi: OpenAI, Google DeepMind va Microsoft uni qo‘llab-quvvatlaydi. Rasmiy modelcontextprotocol/servers repozitoriysida MCP loyihasining o‘zidagi namunaviy serverlar bor (Filesystem, Memory, Sequential Thinking, Fetch va boshqalar); GitHub, Notion, Stripe, Linear, Cloudflare va Sentry kabi yetkazib beruvchilar MCP serverlarini o‘z repozitoriylarida nashr etadi. Hamjamiyat indekslaridagi serverlar soni minglabni tashkil qiladi.
Texnik jihatdan MCP JSON-RPC 2.0 orqali ishlaydi. Arxitekturasi sodda: Claude Code — mijoz, istalgan xizmat — server, ularning orasidagi MCP serverida esa uchta obyekt bor: tools (AI chaqira oladigan narsalar), resources (AI o‘qiy oladigan narsalar) va prompts (tayyor shablonlar).
USB-C qurilmalarni turli periferik qurilmalarga ulashning standart usulini taqdim etgani kabi, MCP ham AI modellarini turli ma’lumot manbalari va vositalariga ulashning standart usulini taqdim etadi.
Bu vibe-coder uchun nima sababdan muhim: MCP’dan oldin Claude va uchinchi tomon xizmati o‘rtasidagi har bir ulanish o‘z wrapperiga ega alohida integratsiya edi. MCP yordamida Postgres, Slack va GitHub’ni ulash uchun bir-biriga o‘xshash uchta buyruq kifoya; xizmat endi kerak bo‘lmaganda, uni uzish ham shunchalik oson.
MCP Skills va subagentlardan nimasi bilan farq qiladi?
Asosiy xulosa
Bu uch mexanizm bir-biriga o‘xshab ko‘rinadi, ammo turli muammolarni hal qiladi. Skills — kod ko‘rinishidagi ish jarayonlaringiz va so‘rovlaringiz. Subagentlar — o‘z kontekstiga ega alohida ixtisoslashgan “hamkasblar”. MCP Claude xizmatlar va ma’lumotlarga yetib borishi uchun tashqi vositalarni taqdim etadi. Ularning token xarajatlari har xil: skill eng arzoni, MCP esa odatda qimmatroq. Dastlab MCP kontekstga faqat vositalar nomi va server ko‘rsatmalarini kiritadi; Claude to‘liq tavsiflarni kerak bo‘lganda yuklaydi. Xarajatning katta qismi xizmat javoblariga to‘g‘ri keladi: ular katta bo‘lishi va suhbatda qolishi mumkin.
Farqlarni eslab qolish uchun sodda jadval:
| Mexanizm | Bu nima | Qachon ishlatish kerak | Token xarajati |
|---|---|---|---|
| Skill | .claude/skills/ ichidagi ko‘rsatmalar va so‘rovlar fayli | Ish jarayoni takrorlansa: xat yozish, hisobot tuzish, post e’lon qilish | Kam. Trigger bo‘lganda yuklanadi |
| Subagent | O‘z konteksti va vositalariga ega alohida agent | Uzoq parallel vazifa: ko‘rib chiqish, audit, tadqiqot | O‘rtacha. O‘z kontekstiga ega |
| MCP serveri | JSON-RPC orqali vositalar/resurslarni taqdim etadigan xizmat | Ma’lumotlarga jonli kirish kerak bo‘lsa: ma’lumotlar bazasi, elektron pochta, messenjer, repozitoriy | O‘rtacha yoki yuqori. Kontekstda faqat vositalar nomi qoladi; tavsiflar kerak bo‘lganda yuklanadi, xizmat javoblari esa katta bo‘lishi mumkin |
Amaliy xulosa: agar vazifa bir marta belgilangan va matn shaklida takrorlansa, bu skill. Agar AI’ga tashqi tizimdan jonli javob kerak bo‘lsa, bu MCP. Agar vazifa uzoq, tarmoqlangan va alohida aqlni talab qilsa, bu subagent.
Yonma-yon keladigan bu ikki mexanizm haqida batafsil: Claude Code Skills: o‘z kutubxonangizni qanday yaratish va Claude Code subagentlari: 5 ta tayyor misol.
Claude Code’da MCP’ni sozlash: 5 daqiqada birinchi buyruq
Asosiy xulosa
Har bir holatda bir xil sintaksis ishlaydi: claude mcp add [name] -- [launch command]. Server claude mcp list ro‘yxatida paydo bo‘ladi. Shundan so‘ng Claude server vositalarini topadi va suhbatda ulardan foydalana boshlaydi. Konfiguratsiyani qo‘lda tahrirlash shart emas — hammasi CLI orqali bajariladi.
Rasmiy hujjatlardagi to‘liq sintaksis:
claude mcp add <name> [options] -- <command> [args...]
Uchta transport turi qo‘llab-quvvatlanadi: --transport stdio (standart, mahalliy jarayon), --transport http (masofaviy HTTP) va --transport sse (eskirgan deb belgilangan; faqat server hali ko‘chmagan bo‘lsa ishlating).
--scope bayrog‘i orqali uchta doira qo‘llab-quvvatlanadi:
local— faqat joriy loyiha papkasida (standart).project—.mcp.jsonfayliga yoziladi, repozitoriyga commit qilinadi va butun jamoaga ochiq bo‘ladi.user— kompyuterdagi barcha loyihalar uchun global.
MCP loyihasining namunaviy Filesystem serveri bilan minimal misol. U yarim daqiqada ishga tushadi:
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
claude mcp list
list dan keyin buyruqda ko‘rsatilgan papka mavjud bo‘lsa, ro‘yxatda filesystem ni ko‘rasiz; mavjud bo‘lmasa, server ishga tushmaydi. U Claude Code’ning ishchi papkalarini, ya’ni Claude Code’ni ishga tushirgan papkangizni ko‘ra oladi. Buning sababi va bu server qachon foydali ekanini quyida 5.2-bo‘limda tushuntiraman.
MCP ulanganini tekshirish uchun Claude Code seansida /mcp buyrug‘ini bajaring. Unda barcha serverlar, ularning holati va vositalar ro‘yxati ko‘rsatiladi. Ailoot bilan ishlash bo‘yicha qo‘shimcha ko‘rsatmalar hujjatlarda mavjud. Muayyan buyruqlar uchun tanlangan MCP serverining README faylini tekshiring.
stdio yoki HTTP: qaysi transportni tanlash kerak?
Asosiy xulosa
stdio — kompyuteringizdagi mahalliy jarayon; hammasi tarmoqsiz ishlaydi va OAuth kerak emas. HTTP — token yoki OAuth orqali kiriladigan masofaviy xizmat bo‘lib, uni qurilmalar o‘rtasida ulashish mumkin. MCP serveri npx yoki uvx orqali o‘rnatilsa, u stdio’dan foydalanadi. Xizmatning o‘z ochiq manzili bo‘lsa, u HTTP’dan foydalanadi. SSE rasmiy ravishda eskirgan deb belgilangan, shuning uchun unga tayanmang.
Asosiy mezonlar bo‘yicha taqqoslash:
| Mezon | stdio | HTTP |
|---|---|---|
| Qayerda ishlaydi | Mahalliy (Claude Code’ning yordamchi jarayoni) | Masofaviy server |
| Avtorizatsiya | Kerak emas | OAuth 2.1 yoki Bearer token |
| Tarmoq portlari | Yo‘q | Ochiq manzil |
| Ishlatish holatlari | Filesystem, Postgres, mahalliy utilitalar | GitHub, Slack, Notion, Linear, Sentry |
| Qayta ulanish | Kerak emas | Eksponensial kutish, 5 tagacha urinish |
| Joylashtirish | Paketni mahalliy o‘rnatish | Yetkazib beruvchining xizmati |
Oddiy qoida: diskingizda yoki mahalliy ma’lumotlar bazasida saqlanadigan narsalar stdio’dan foydalanadi. Bulutdagi narsalar HTTP’dan foydalanadi. SSE rasman eskirgan; uni tanlamang.
Tadbirkorlar uchun 7 ta tayyor MCP serveri
Asosiy xulosa
Quyida vibe-coder vazifalarining 80% ini qamrab oladigan yettita sozlama bor: kod (GitHub), fayllar (Filesystem), ma’lumotlar bazasi (DBHub orqali Postgres), jamoa muloqoti (Slack), bilimlar bazasi (Notion), xatolarni kuzatish (Sentry) va brauzer jarayonlari (Playwright). Har bir sozlama uchun o‘rnatish buyrug‘ini bir qatorda va haqiqiy suhbatda Claude’dan ishni aynan qanday so‘rash mumkinligiga misol keltiraman.
5.1. GitHub MCP — GitHub’ning rasmiy serveri
Nima qiladi: Claude Code’ga issues, pull requestlar, repozitoriy fayllari va action ishga tushirishlariga kirish imkonini beradi. Server ochiq kodli va GitHub’da 30 000 dan ortiq yulduzga ega.
O‘rnatish (HTTP, OAuth orqali):
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
OAuth o‘rniga PAT token kerak bo‘lsa, Docker orqali stdio’dan foydalanish ham mumkin.
Misol: “bug yorlig‘i qo‘yilgan ochiq issue’larni o‘qing, ularni komponentlar bo‘yicha guruhlang va qaysi tartibda yopishni taklif qiling.” Claude GitHub MCP’ni chaqiradi, barcha issue’larni o‘qiydi va ustuvorlik bo‘yicha tartiblangan ro‘yxatni qaytaradi.
Repozitoriy: github/github-mcp-server.
5.2. Filesystem MCP — MCP loyihasining namunaviy serveri
Nima qiladi: AI’ga kompyuterdagi tasdiqlangan papkalar ichidagi fayllardan foydalanish imkonini beradi. Uni MCP loyihasining o‘zi chiqargan; npm reyestrida muallif sifatida Model Context Protocol a Series of LF Projects, LLC ko‘rsatilgan.
O‘rnatish (stdio), versiyasi aniq belgilangan:
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
Claude Code ulanganda, u o‘z ishchi papkalarini serverga uzatadi va bu papkalar buyruqda ko‘rsatilganlarning o‘rnini egallaydi. Claude Code’ning ishchi papkalari — uni ishga tushirgan papkangiz va /add-dir buyrug‘i yoki --add-dir bayrog‘i orqali qo‘shilgan papkalar. Buyruq orqali serverga maketlar uchun alohida papka bera olmaysiz. Buyruqda ko‘rsatilgan papka baribir mavjud bo‘lishi kerak, aks holda server ishga tushmaydi.
Demak, Claude Code’da bu asosan ichki vositalarni takrorlaydi. Boshqa papkadagi fayllarga kirish uchun /add-dir kifoya: shundan keyin Claude Code’ning o‘z vositalari ham papkani o‘qiy oladi. Server o‘z fayl kirish imkoniyatiga ega bo‘lmagan dasturlar uchun foydaliroq. Claude Desktop’da boshqa muammo yuz berishi mumkin: server vositalari tavsiflarida eski sxema formati ishlatilgani uchun rad etiladi; bu muammo hali ham hal etilmagan.
Faqat o‘zingizga kerak bo‘lgan papkalarga, ham buyruq orqali, ham /add-dir orqali ruxsat bering. Disk ildiziga ruxsat bermang — bu birinchi xavfsizlik teshigi.
Misol: avval /add-dir ~/Documents/design, keyin: “~/Documents/design/landing-v3/ ichidagi barcha maketlarni joriy loyihaga ko‘chiring va ularni hero-*.png kelishuviga muvofiq nomlang.”
5.3. Postgres MCP — DBHub (Bytebase)
Nima qiladi: Claude’ni Postgres, MySQL, SQL Server, MariaDB yoki SQLite’ga ulaydi. U faqat o‘qish rejimini qo‘llab-quvvatlaydi, shuning uchun AI agenti bitta buyruq bilan ma’lumotlar bazasini o‘chirib yubora olmaydi. Ko‘pincha u Anthropic’ning arxivlangan namunaviy server-postgres serveri o‘rniga ishlatiladi.
O‘rnatish (HTTP, faqat o‘qish rejimi):
claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly
Ishlab turgan ma’lumotlar bazasi uchun doimo faqat o‘qish ruxsatlari berilgan alohida foydalanuvchidan foydalaning va VIEW yoki vositachi API marshruti orqali shaxsiy ma’lumotlarni anonimlashtiring. Ishlab turgan ma’lumotlar bazasiga yozish ruxsati bilan ulamang.
Misol: “So‘nggi oyda obunasi expired holatiga o‘tgan mijozlarni so‘rov orqali toping va ularni umumiy to‘lov miqdori bo‘yicha saralab, eng yaxshi 20 tasini ko‘rsating.”
Repozitoriy: bytebase/dbhub.
5.4. Slack MCP — jamoa muloqoti
Nima qiladi: Claude’ga Slack kanallarini o‘qish va xabar yuborish imkonini beradi. Avtomatlashtirishda foydali: “Build muvaffaqiyatli o‘tganda, #releases kanaliga yoz”; “#engineering kanalidan haftalik xulosa tuz.”
O‘rnatish (npx wrapperi orqali stdio, masalan @modelcontextprotocol/server-slack yoki unga teng yetkazib beruvchi vositasi):
claude mcp add slack \
-e SLACK_BOT_TOKEN=xoxb-... \
-e SLACK_TEAM_ID=T0... \
-- npx -y @modelcontextprotocol/server-slack
Avtorizatsiya Slack Bot Token orqali amalga oshiriladi; kirish Slack tomonidagi scope’lar bilan cheklanadi. AI’ga faqat chat:read va chat:write:user ruxsatlarini berishingiz mumkin, shunda u workspace sozlamalarini tahrirlay olmaydi. Joriy buyruqlar uchun tanlangan serverning README faylini tekshiring; ekotizim tez o‘zgaradi.
Misol: “Har kuni ertalab soat 9:00 da kecha merge qilingan PR’lar ro‘yxatini #daily kanaliga yuboring.”
5.5. Notion MCP — bilimlar bazasi
Nima qiladi: Claude’ga Notion sahifalari va ma’lumotlar bazalariga kirish imkonini beradi. Bu loyihangizdan tashqaridagi bilimlar bazasi: agar u yerda qaydlar, mijozlar ro‘yxati yoki tahrir siyosatini saqlasangiz, AI ularni o‘qiy oladi.
O‘rnatish (HTTP, OAuth orqali):
claude mcp add --transport http notion https://mcp.notion.com/mcp
Buning o‘rniga Anthropic’ning rasmiy @makenotion/claude-code-notion-plugin plaginidan foydalanish mumkin.
Misol: “Notion’dagi ‘Customers’ ma’lumotlar bazasidan holati ‘active’ bo‘lgan va ikki haftadan ko‘proq vaqt davomida qo‘ng‘iroq qilinmagan barcha odamlarni toping. Har biriga elektron xat loyihasini tayyorlang.”
Notion qo‘llanmasi: developers.notion.com/guides/mcp.
5.6. Sentry MCP — xatolarni kuzatish
Nima qiladi: Claude’ni ishlab turgan tizimingizdagi xatolarga ulaydi. Sahifa 500 xatosi bilan yiqilganda, “Loyiha uchun Sentry’dagi eng so‘nggi 10 ta muammoni ko‘rsating va har birining tub sababini tushuntiring” deb so‘rashingiz va darhol tahlil olishingiz mumkin.
O‘rnatish (HTTP):
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Avtorizatsiya Sentry OAuth orqali amalga oshiriladi. Kirishni muayyan loyiha bilan cheklash mumkin.
Misol: “So‘nggi 24 soat ichida eng ko‘p uchragan uchta muammoni oling. Nima bo‘lganini sodda tilda tushuntiring va tuzatish yo‘lini taklif qiling.”
Repozitoriy: getsentry/sentry-mcp.
5.7. Playwright MCP — brauzer jarayonlari
Nima qiladi: Claude’ga brauzer beradi. AI sahifani ochishi, bosishi, shaklni to‘ldirishi va skrinshot olishi mumkin. Interfeysni tekshirish, e’lon qilingandan keyin qo‘lda sinash va jarayonlarni tahlil qilish uchun foydali.
O‘rnatish (stdio):
claude mcp add playwright -- npx -y @playwright/mcp@latest
2026-yil 7-mayda chiqarilgan v0.0.75 versiyasiga Microsoft faol xizmat ko‘rsatadi (32 000 dan ortiq yulduz).
Misol: “Veb-saytimiz bosh sahifasini oching, barcha kartalar to‘g‘ri ko‘rsatilayotganini tekshiring va kompyuter hamda mobil qurilmada skrinshot oling.”
Repozitoriy: microsoft/playwright-mcp.
Tanlangan Playwright MCP versiyasi uchun aniq belgilangan versiyali buyruq, bir vaqtning o‘zida bir nechta seans uchun bayroq va keng tarqalgan o‘rnatish xatolari haqida README faylini tekshiring.
PreToolUse hook’i yordamida xavfsizlikni qanday boshqarish mumkin?
Asosiy xulosa
MCP AI’ga katta vakolat beradi: u ma’lumotlar bazalariga yozishi, xabar yuborishi va fayllarni o‘chirishi mumkin. PreToolUse hook’i matcher’ga mos chaqiruvlarni boshqarishi mumkin. SQL prefiks regex’i baza avtorizatsiyasi emas; faqat Postgres matcher’i Slack yoki fayl vositalarini qamramaydi. Avval haqiqiy xizmat va fayl ruxsatlarini qo‘llang, hook’ning aniq ko‘lamini alohida sinang.
SQL prefiksi qora ro‘yxati read-only ruxsat chegarasi emas: kichik harfli SQL, izoh, UPDATE, INSERT, ALTER, bir nechta statement va yon ta’sirli funksiyalar uchta bosh harfli prefiks bilan qamralmaydi. Bazaga alohida read-only grantli rol bering va uni tashlab yuboriladigan test bazasida tekshiring. Hook qo‘shimcha nazorat, ruxsat o‘rnini bosmaydi.
Quyidagi karantin misoli aniq siyosat ko‘rib chiqilib sinalguncha uch nomlangan MCP oilasining barcha chaqiruvlarini rad etadi: o‘qish ham, yozish ham. Haqiqiy server/vosita nomlaringizga moslang. Qayta nomlangan server, ichki Bash yoki boshqa connector bu andozadan tashqarida.
Alohida qoidalarni .claude/settings.json ga qo‘ying:
{
"hooks": {
"PreToolUse": [
{
"matcher": "mcp__postgres__.*",
"hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
},
{
"matcher": "mcp__slack__.*",
"hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
},
{
"matcher": "mcp__filesystem__.*",
"hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
}
]
}
}
Skriptni .claude/hooks/deny-unapproved-mcp.sh ga saqlang. U eski yuqori darajadagi decision: approve/block emas, hujjatdagi PreToolUse qaror shartnomasini qaytaradi:
#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"This MCP server family is quarantined pending a reviewed policy."}}'
Skript SQL’ni parse yoki tasniflamaydi: mos chaqiruvni har doim rad etadi. Qimmatli ma’lumotdan oldin ajratilgan seansda matcher va natijani tekshiring. Mos vosita nomlarida SELECT 1, kichik harfli delete, izohli UPDATE, Slack o‘qish/yuborish va Filesystem orqali .env o‘qishning hammasi rad etilishi kerak. Boshqa server oilasi bu misoldan tashqarida qolishini ham aniq sinang.
Read-only baza ishi uchun tekshirilgan grantlardan foydalanib, karantinni haqiqiy vositalar uchun ko‘rib chiqilgan siyosatga almashtiring. Faqat o‘qiydigan Slack vazifasiga yuborish huquqisiz credential bering. Fayllarda server ildizlari va jarayonning fayl ruxsatlarini cheklang. Hook boshqa vosita, shell buyrug‘i, topshiriqqa biriktirilgan fayl yoki agent tahrirlay oladigan siyosat fayli orqali kirishni to‘sadi deb aytmang.
Xuddi shu yondashuv Claude Code’da Plan Mode qo‘llanmasida batafsil yoritilgan — u yerda ham “bajarishdan oldin tekshirish” mantiqi o‘xshash.
40 dan ortiq vosita bo‘lsa va Claude adashsa, nima qilish kerak?
Asosiy xulosa
Yettita server bemalol 50–100 ta vositani anglatishi mumkin. Claude Code sukut bo‘yicha Tool Search’dan foydalanadi: ishga tushganda kontekstga faqat vosita nomlari va server ko‘rsatmalari kiradi, Claude esa vosita kerak bo‘lganda uning to‘liq tavsifini yuklaydi. Qidiruv o‘chiq bo‘lsa, barcha tavsiflar birdan yuklanadi va taxminan 40 ta vositadan keyin Claude adasha boshlaydi: noto‘g‘ri vositani tanlaydi yoki oddiy buyruq yetarli bo‘lsa ham MCP’ga murojaat qiladi.
Claude Code hujjatlariga ko‘ra, u endi sukut bo‘yicha yoqilgan va qo‘lda yoqish shart emas.
Claude Code barcha vositalarni darhol yuklaydigan istisno holatlar: uchinchi tomon proksisi orqali ishlash (ANTHROPIC_BASE_URL Anthropic’nikidan boshqa manzilga o‘rnatilgan bo‘lsa), Google Cloud’da 4.5-avloddan eski modellar va Azure’dagi Microsoft Foundry joylashtirishlari. ENABLE_TOOL_SEARCH o‘zgaruvchisi xatti-harakatni o‘zgartiradi:
- belgilanmagan — barcha MCP vositalari kechiktiriladi va kerak bo‘lganda yuklanadi;
true— xuddi shu holat, bundan tashqari Claude Code proksi orqali qidiruvni yoqishga urinadi;auto— chegara rejimi: barcha vosita tavsiflari kontekst oynasining 10% idan kam joy olsa, darhol yuklanadi; bu chegaradan oshsa, keyinga qoldiriladi;auto:N— xuddi shu holat, lekin foiz chegarasi sozlanishi mumkin, masalanauto:5;false— eski xatti-harakat; barcha vositalar darhol kontekstga kiritiladi.
Doimo ko‘rinib turishi kerak bo‘lgan muhim vositalar uchun server tavsifi yonidagi .mcp.json faylida alwaysLoad: true bayrog‘i bor. Har bir bunday vosita birinchi daqiqadanoq kontekstdan joy oladi, shuning uchun buni faqat deyarli har bir javobda Claude’ga kerak bo‘ladigan vositalar uchun ishlating.
Agar besh yoki undan ko‘p MCP serveringiz bo‘lsa va Claude qaysi vositani chaqirish borasida adashsa, avval qidiruv o‘chirilgan-o‘chirilmaganini tekshiring: sozlamalarda ENABLE_TOOL_SEARCH=false bor-yo‘qligini va proksi orqali ishlayotganingizni ko‘ring.
Shuningdek, /compact yordamida kontekstni qisqartirish ham foyda berishi mumkin.
Qachon MCP kerak emas: Skill, subagent yoki CLI ma’qulmi?
Asosiy xulosa
Tokenlar nuqtayi nazaridan MCP Claude’ga tashqi imkoniyatlar berishning eng qimmat usuli. Agar vazifani tayyor CLI vositasi (gh issue list, psql, curl) yoki bir sahifalik skill bajara olsa, MCP serverlari yaratish o‘rniga ulardan foydalaning. Qoida: MCP faqat AI’ga xizmat bilan bir martalik javob emas, balki jonli, ikki tomonlama muloqot kerak bo‘lganda o‘zini oqlaydi.
Token xarajati va murakkabligi bo‘yicha ketma-ketlik:
- Bash orqali CLI buyrug‘i — deyarli bepul. AI
gh pr list,psql -cyokicurlni ishga tushiradi va oddiy terminal foydalanuvchisiga o‘xshash javob oladi. - Skill — arzon. Nimani chaqirish va natijani qanday qayta ishlash kerakligini ko‘rsatuvchi tayyor so‘rov shabloni. Papka nomidagi triggerga qarab yuklanadi.
- Subagent — o‘rtacha. O‘z token seansiga ega, uzoq vazifa uchun alohida kontekst.
- MCP serveri — qimmat. Kontekstda faqat vosita nomlari qoladi, ammo Claude chaqiruvdan oldin vositani topganda uning tavsifi yuklanadi, xizmat javoblari esa katta bo‘lishi mumkin: vosita javobi 10,000 tokendan oshganda Claude Code ogohlantiradi. HTTP uchun OAuth seansi ham kerak.
Kutilmagan maslahat: veb-sahifalarni tahlil qilish, git bilan ishlash, PDF ochish va ochiq kodli utilitalardan foydalanish uchun MCP’ni emas, CLI’ni tanlang. AI terminal buyruqlarini odam kabi chaqira oladi, tokenlar esa vosita tavsiflari yoki server qo‘shimcha xarajatlarisiz faqat buyruq va uning javobiga sarflanadi.
MCP ikki holatda o‘zini oqlaydi:
- Xizmat yopiq bo‘lsa: Slack, Notion, Sentry, Linear. CLI vositalari ham bor, ammo MCP OAuth va scope boshqaruvi orqali aniqroq kirish imkonini beradi.
- Jonli, ikki tomonlama muloqot zarur bo‘lsa: AI Postgres’ga ulanadi, sxemani tekshiradi, keyingi so‘rovni beradi, ma’lumotlarni oladi va keyingi qadamni bajaradi. CLI bilan bu 10 ta qo‘lda yoziladigan buyruqqa aylanadi.
MCP’ga ulanishdagi 6 ta noto‘g‘ri yondashuv
Asosiy xulosa
MCP bilan ishlashning dastlabki haftalarida vibe-coderlar yo‘l qo‘yadigan oltita aniq xato. Har birini bir daqiqada tuzatish mumkin: claude mcp list ni oching, ro‘yxatni ko‘rib chiqing va scope hamda hook’larni tekshiring. Muammolarning aksariyati yangi server qo‘shish bilan emas, keraksiz serverni olib tashlash bilan hal bo‘ladi; bu bo‘lim yuqoridan pastga qarab ko‘rib chiqiladigan qisqa ro‘yxat.
MCP javoni. “Kerak bo‘lib qolar” deb 10 ta server uladingiz; Claude qaysi vositani chaqirishni bilmay qoladi, javoblar esa kontekstni to‘ldiradi. Yechim: joriy loyiha uchun 3–5 ta server qoldiring va qolganlarini
claude mcp removebilan olib tashlang.Ishlab turgan ma’lumotlar bazasiga yozish ruxsati. Postgres MCP’ni ishlab turgan ma’lumotlar bazasiga
--readonly, alohida foydalanuvchi yoki ruxsatlar ro‘yxati hook’isiz uladingiz. “Test yozuvlarini o‘chir” degan bitta so‘rov — va ishlab turgan ma’lumotlar o‘chirib yuboriladi. Yechim: tekshirilgan read-only grantli alohida baza roli, mos server read-only rejimi va sinalgan vosita-chaqiruv nazorati.DROP|TRUNCATE|DELETEprefiks qora ro‘yxati yetarli avtorizatsiya emas.Anonimlashtirilmagan PII. Mijozlarning elektron pochta manzillari, telefon raqamlari va pasport ma’lumotlari bor ma’lumotlar bazasini to‘g‘ridan-to‘g‘ri uladingiz. Claude ma’lumotlarni ko‘radi va ular Anthropic jurnallarida qoladi. Yechim:
j***@gmail.comkabi niqoblangan ma’lumotlarni qaytaradigan VIEW yoki vositachi API marshruti.Skill o‘rniga MCP. “X formatida savdo hisobotini yarating” degan muntazam vazifa uchun tayyor so‘rovli skill yetarli. MCP serveri yaratmang.
Ochiq kodli CLI o‘rniga MCP. PDF’ni matnga aylantirish kerak. Buning uchun
pdftotextbor. “PDF MCP” qurmang — u shunchaki tokenlarni isrof qiladi.Token xarajatlarini kuzatmaslik.
claude mcp listda ulangan serverni ko‘rasiz, ammo har bir suhbatda qancha sarflayotganini ko‘rmaysiz. Bir haftadan keyin “MCP kontekstning 40% ini sarflagani va men shu vaqt davomida buning uchun to‘lab kelganim” haqida tasavvuringiz bo‘lmaydi. Yechim: ishlatilmayotgan serverlarni vaqti-vaqti bilan o‘chirib turing va foydalanish o‘zgarishini Claude Code foydalanish cheklovlarini kuzatish orqali tekshiring.
MCP ulanishidagi nosozlikni qanday tuzatish mumkin?
Asosiy xulosa
Eng ko‘p uchraydigan muammolar: OAuth qayta chaqiruv manzili ishlamaydi, server nomi mavjud server nomiga zid keladi yoki add dan keyin vosita claude mcp list da ko‘rinmaydi. Standart muammo aniqlash sikli bularni tuzatadi: list nima ulanganini ko‘rsatadi, status holat indikatorini tekshiradi, indikator qizil bo‘lsa, logs stek izini qaytaradi. --scope yoki ENV o‘zgaruvchisini o‘zgartirgandan so‘ng, hammasini qayta ishga tushiring.
Bosqichma-bosqich tekshiruv ro‘yxati:
Server ro‘yxatda ko‘rinyaptimi?
claude mcp listKo‘rinmasa,
claude mcp addtugallanmagan. Eng ko‘p uchraydigan sabab —--scope: servernilocaldoirasiga qo‘shgansiz, ammo boshqa loyihadan tekshiryapsiz.Server holati yashilmi?
claude mcp status <name>Qizil rang jarayon ishga tushmaganini (stdio uchun) yoki server javob bermaganini (HTTP uchun) bildiradi.
Server jurnallarida foydali ma’lumot bormi?
claude mcp logs <name>Stek izini ko‘rsangiz, muammo odatda paketda bo‘ladi (
npxuni topa olmagan yoki Node versiyasi 20 dan past).OAuth qayta chaqiruvi qaytmayaptimi? Muammo odatda
--callback-portyoki tarmoq filtri bilan bog‘liq. Muayyan portni yo‘naltiring:claude mcp add --transport http --callback-port 8765 [name] [url]Vosita nomlari to‘qnashyaptimi? Ikki server bir xil nomli vositani taqdim etadi va Claude noto‘g‘risini chaqiradi. Tool Search’dan foydalaning (oldingi H2 bo‘limiga qarang) yoki ortiqcha serverni
claude mcp removebilan qo‘lda olib tashlang.claude.ai kengaytmalarini (connector’larni) ko‘ra olmayapsizmi? Bu ma’lum muammo: claude.ai veb-interfeysidagi kengaytmalar (connector’lar) API kaliti ishlatilganda Claude Code’da mavjud bo‘lmaydi. Yechim: MCP’ni veb-interfeys orqali emas, CLI orqali ulang.
Keyingi qadamlar: OAuth, o‘z MCP serverlaringiz va plaginlar bozori
Asosiy xulosa
Yettita tayyor serverdan keyingi uch qadam: jamoangiz bilan MCP’ni ulashmoqchi bo‘lsangiz, o‘z HTTP serverlaringiz uchun OAuth sozlash; o‘ziga xos xizmat uchun shaxsiy MCP yozish; Anthropic’ning Plugin Marketplace’iga ulanish. Marketplace 2025-yil 9-oktabrda ishga tushdi va MCP’ni bitta buyruq bilan o‘rnatiladigan plaginlarga jamlaydi.
Plugin Marketplace o‘rnatish buyruqlarini eslab qolishni istamaydiganlar uchun ishni tezlashtiradi. Format — bitta paketdagi serverlar to‘plamini tavsiflovchi .claude-plugin/marketplace.json manifesti.
Marketplace’dan plagin o‘rnatish:
claude plugin install <plugin-name>
Bitta plagin bir vaqtning o‘zida bir nechta MCP server, skill va subagentni o‘z ichiga olishi mumkin — bu elektron tijorat, marketing yoki yuridik bo‘lim kabi muayyan vaziyatga mo‘ljallangan tayyor sozlama.
modelcontextprotocol.io spetsifikatsiyasiga muvofiq o‘z MCP serveringizni yozing. Minimal shablonda Anthropic’ning Python yoki TypeScript SDK’i ishlatiladi; keyin vositalarni tavsiflab, transportni ulang. Murakkabligi FastAPI yordamida REST API yozishga yaqin.
Agar loyihangizda sozlangan CLAUDE.md va kontekst muhandisligi tushunchasi allaqachon bo‘lsa, o‘z MCP’ingizni qo‘shish bir kun oladi. Bular bo‘lmasa, avval asoslarni o‘rganganingiz ma’qul.
Manbalar
- Model Context Protocol — rasmiy sayt
- Anthropic MCP’ni taqdim etadi — 2024-yil 25-noyabr
- Claude Code MCP hujjatlari
- Claude Code: MCP Tool Search
- Claude Code plaginlari e’loni — 2025-yil 9-oktabr
- Code with Claude 2026
- modelcontextprotocol/servers — rasmiy reyestr
- github/github-mcp-server
- microsoft/playwright-mcp
- bytebase/dbhub — Postgres MCP
- getsentry/sentry-mcp
- makenotion/claude-code-notion-plugin
- Notion MCP qo‘llanmasi
- Anthropic Claude Code repozitoriysi — muammolar va o‘zgarishlar jurnali
Modellar bilan ishlashni davom ettirish uchun Ailoot saytiga o‘ting.
Batafsil
Ko‘p beriladigan savollar
Bu hook production bazaga kirishni read-only qiladimi?
Yo‘q. Misol nomlangan MCP oilalariga mos barcha chaqiruvni karantinga oladi, SQL’ni tasniflamaydi. Read-only xulq alohida roldagi tekshirilgan grantlardan kelishi kerak; hook qo‘shimcha nazorat.
Hook ko‘lamini qanday sinayman?
Ajratilgan seansda mos nomli o‘qish va yozish vositalari, jumladan kichik harfli yoki izohli SQL rad etilishini tekshiring. Keyin aloqasiz vosita matcher’dan tashqaridaligini sinang. Ochiq qolgan yo‘lga alohida ruxsat yoki siyosat kerak.