2026 жылы Claude Code-қа арналған MCP серверлері: 7 интеграция және орнату
MarkdownMCP деген не және оны claude mcp add пәрменімен 5 минутта қалай қосуға болады. 7 сервер: GitHub, Postgres, Slack, Notion, Sentry, Playwright. hooks арқылы рұқсат етілген тізім.
Мақаланы толық оқу
Ailoot-пен жұмыс істеуге арналған қосымша нұсқаулар құжаттамада берілген.
MCP сервері деген не және ол Claude Code-қа не үшін керек?
Негізгі түйін
MCP (Model Context Protocol) — Anthropic ұсынған, Claude Code-қа бірыңғай интерфейс арқылы сыртқы құралдар мен деректерге қол жеткізуге мүмкіндік беретін ашық стандарт. Он түрлі API орнына бір протокол. Anthropic оны «AI қолданбаларына арналған USB-C» деп атайды: портты қоссаңыз, Claude дерекқорыңызды, электрондық поштаңызды, мессенджеріңізді немесе репозиторийіңізді көре алады.
Anthropic MCP-ті 2024 жылғы 25 қарашада ашық стандарт ретінде жариялады. Бір жылдың ішінде бұл протокол салалық стандартқа айналды: OpenAI, Google DeepMind және Microsoft оны қолдайды. Ресми modelcontextprotocol/servers репозиторийінде MCP жобасының өзінен шыққан анықтамалық серверлер бар (Filesystem, Memory, Sequential Thinking, Fetch және басқалары); GitHub, Notion, Stripe, Linear, Cloudflare және Sentry сияқты жеткізушілер MCP серверлерін өз репозиторийлерінде жариялайды. Қауымдастық индекстеріндегі серверлердің жалпы саны мыңдап саналады.
Техникалық тұрғыдан MCP JSON-RPC 2.0 арқылы жұмыс істейді. Архитектурасы қарапайым: Claude Code — клиентіңіз, кез келген қызмет — сервер, ал олардың арасындағы MCP серверінде үш нысан бар: tools (AI шақыра алатын нәрселер), resources (AI оқи алатын нәрселер) және prompts (дайын үлгілер).
USB-C құрылғыларды әртүрлі перифериялық құрылғыларға қосудың стандартты тәсілін ұсынатыны сияқты, MCP де AI модельдерін әртүрлі дереккөздер мен құралдарға қосудың стандартты тәсілін ұсынады.
Бұл vibe coder үшін неге маңызды: MCP пайда болғанға дейін Claude пен үшінші тарап қызметі арасындағы әрбір байланыс өз wrapper-і бар бөлек интеграция болатын. MCP арқылы Postgres, Slack және GitHub-ты қосуға үш ұқсас пәрмен жеткілікті, ал қызмет қажет болмай қалса, оларды ажырату да оңай.
MCP Skills пен Subagents-тен несімен ерекшеленеді?
Негізгі түйін
Бұл үш механизм бір-біріне ұқсас көрінеді, бірақ әртүрлі мәселелерді шешеді. Skills — код түріндегі жұмыс процестері мен сұрау мәтіндері. Subagents — өз контексті бар бөлек маманданған «әріптестер». MCP Claude сыртқы қызметтер мен деректерге жете алатын құралдарды ұсынады. Олардың токен шығындары әртүрлі: skill ең арзан, ал MCP әдетте қымбатырақ. Бастапқыда MCP контекске тек құрал атаулары мен сервер нұсқауларын қосады; Claude толық сипаттамаларды қажет болғанда жүктейді. Шығынның басым бөлігі қызмет жауаптарынан туындайды: олар үлкен болуы және әңгімеде қалуы мүмкін.
Айырмашылықтарды есте сақтауға арналған қарапайым кесте:
| Механизм | Бұл не | Қашан қолдану керек | Токен құны |
|---|---|---|---|
| Skill | .claude/skills/ ішіндегі нұсқаулар мен сұрау мәтіндері бар файл | Жұмыс процесі қайталанғанда: электрондық хат жазу, есеп құрастыру, жазба жариялау | Төмен. Триггер болғанда жүктеледі |
| Subagent | Өз контексті мен құралдары бар бөлек агент | Ұзақ параллель тапсырма: шолу, аудит, зерттеу | Орташа. Өз контексті бар |
| MCP сервері | JSON-RPC арқылы құралдар/ресурстар ұсынатын қызмет | Деректерге тікелей қол жеткізу керек болғанда: дерекқор, электрондық пошта, мессенджер, репозиторий | Орташа немесе жоғары. Контексте тек құрал атаулары қалады; сипаттамалар қажет болғанда жүктеледі, ал қызмет жауаптары үлкен болуы мүмкін |
Іс жүзіндегі түйін: егер тапсырма бір рет сипатталып, мәтін ретінде қайталанса, бұл — skill. Егер AI сыртқы жүйеден тікелей жауап алуы керек болса, бұл — MCP. Егер тапсырма ұзақ, тармақталған және бөлек ойлау ортасын қажет етсе, бұл — subagent.
Осыған іргелес екі механизм туралы толығырақ: Claude Code Skills: How to Build Your Own Library және Claude Code Subagents: 5 Ready-Made Examples.
MCP серверін орнату: 5 минуттағы алғашқы пәрменіңіз
Негізгі түйін
Барлық жағдайға бірдей синтаксис жарайды: claude mcp add [name] -- [launch command]. Сервер claude mcp list тізімінде пайда болады. Содан кейін Claude сервердің құралдарын тауып, оларды әңгімеде қолдана бастайды. Конфигурацияны қолмен өңдеудің қажеті жоқ — бәрі CLI арқылы орындалады.
Ресми құжаттамадағы толық синтаксис:
claude mcp add <name> [options] -- <command> [args...]
Үш тасымалдау түріне қолдау бар: --transport stdio (әдепкісі, жергілікті процесс), --transport http (қашықтағы HTTP) және --transport sse (ескірген деп белгіленген; тек сервер әлі көшірілмеген болса қолданыңыз).
--scope жалаушасы арқылы үш ауқымға қолдау бар:
local— тек ағымдағы жоба қалтасында (әдепкісі).project—.mcp.jsonфайлына жазылады, репозиторийге коммиттеледі және бүкіл командаға қолжетімді болады.user— құрылғыдағы барлық жобаларға ортақ.
MCP жобасының анықтамалық Filesystem серверімен берілген ең аз мысал. Ол жарты минутта іске қосылады:
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
claude mcp list
list пәрменінен кейін пәрменде көрсетілген қалта бар болса, тізімде filesystem көрінеді; қалта болмаса, сервер іске қосылмайды. Сервер Claude Code-тың жұмыс қалталарын, яғни оны іске қосқан қалтаны көре алады. Мұның себебін және бұл сервердің нақты қай кезде пайдалы болатынын төмендегі 5.2-бөлімде түсіндіремін.
MCP қосылғанын тексеру үшін Claude Code сессиясының ішінде /mcp пәрменін орындаңыз. Ол барлық серверді, олардың күйін және құралдар тізімін көрсетеді. Ailoot-пен жұмыс істеуге арналған қосымша нұсқаулар құжаттамада берілген. Таңдалған MCP серверінің нақты пәрмендерін README файлынан қараңыз.
stdio ма, әлде HTTP пе: қай тасымалдау түрін таңдау керек?
Негізгі түйін
stdio — құрылғыңыздағы жергілікті процесс; бәрі желісіз жұмыс істейді, OAuth қажет емес. HTTP — қашықтағы қызмет, оған токен не OAuth арқылы қол жеткізіледі және оны әртүрлі құрылғыларда ортақ пайдалануға болады. Егер MCP сервері npx немесе uvx арқылы орнатылса, ол stdio қолданады. Қызметтің өз жария мекенжайы болса, ол HTTP қолданады. SSE ресми түрде ескірген деп белгіленген, сондықтан оған сүйенбеңіз.
Негізгі өлшемдер бойынша салыстыру:
| Өлшем | stdio | HTTP |
|---|---|---|
| Қайда жұмыс істейді | Жергілікті (Claude Code-тың еншілес процесі) | Қашықтағы сервер |
| Авторизация | Қажет емес | OAuth 2.1 немесе Bearer token |
| Желілік порттар | Жоқ | Жария мекенжай |
| Қолдану жағдайлары | Filesystem, Postgres, жергілікті утилиталар | GitHub, Slack, Notion, Linear, Sentry |
| Қайта қосылу | Қажет емес | Экспоненциалды кідіріс, 5 әрекетке дейін |
| Орналастыру | Пакетті жергілікті орнату | Жеткізушінің қызметі |
Жалпы ереже: дискіңізде немесе жергілікті дерекқорда сақталған нәрсенің бәрі stdio қолданады. Бұлттағының бәрі HTTP қолданады. SSE ресми түрде ескірген; оны таңдамаңыз.
Кәсіпкерлерге арналған дайын 7 MCP сервері
Негізгі түйін
Мұнда vibe coder тапсырмаларының 80% қамтитын жеті баптау берілген: код (GitHub), файлдар (Filesystem), дерекқор (DBHub арқылы Postgres), команда байланысы (Slack), білім базасы (Notion), қателерді бақылау (Sentry) және браузердегі жұмыс процестері (Playwright). Төмендегі әр баптау үшін орнатудың бір жолдық пәрменін және нақты әңгімеде Claude-қа жұмысты қалай тапсыруға болатынының мысалын беремін.
5.1. GitHub MCP — GitHub-тың ресми сервері
Не істейді: Claude Code-қа issues, pull requests, репозиторий файлдары мен action іске қосылымдарына қол жеткізуге мүмкіндік береді. Сервердің бастапқы коды ашық және GitHub-та 30,000-нан астам жұлдызы бар.
Орнату (HTTP, OAuth арқылы):
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
OAuth орнына PAT токені керек болса, Docker арқылы stdio қолдануға болады.
Мысал: “bug белгісі бар ашық issues-ті оқып, компоненттер бойынша топта да, оларды жабу ретін ұсын.” Claude GitHub MCP-ті шақырып, барлық issue-ді оқиды да, басымдығы бойынша реттелген тізім береді.
Репозиторий: github/github-mcp-server.
5.2. Filesystem MCP — MCP жобасының анықтамалық сервері
Не істейді: AI-ға рұқсат етілген қалталар ішіндегі компьютер файлдарына қол жеткізуге мүмкіндік береді. Оны MCP жобасының өзі шығарған; npm тізілімінде авторы ретінде Model Context Protocol a Series of LF Projects, LLC көрсетілген.
Орнату (stdio), бекітілген нұсқамен:
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
Claude Code қосылғанда, ол жұмыс қалталарын серверге береді, ал сервер пәрменде көрсетілген қалталардың бәрін ауыстырады. Claude Code-тың жұмыс қалталары — оны іске қосқан қалта және /add-dir пәрменімен немесе --add-dir жалаушасымен қосылған қалталар. Пәрмен арқылы серверге бөлек макет қалтасын бере алмайсыз. Пәрменде көрсетілген қалта бәрібір болуы керек, әйтпесе сервер іске қосылмайды.
Сондықтан Claude Code ішінде бұл сервер негізінен кіріктірілген құралдарды қайталайды. Басқа қалтадағы файлдарға қол жеткізу үшін /add-dir жеткілікті: содан кейін Claude Code-тың өз құралдары да сол қалтаны оқи алады. Бұл сервер файлдарға өздігінен қол жеткізе алмайтын бағдарламалар үшін пайдалырақ. Claude Desktop-та тағы бір мәселе туындауы мүмкін: құрал сипаттамалары ескі схема пішімін қолданатындықтан, сервер құралдары қабылданбайды; бұл мәселе әлі шешілмеген.
Тек қажет қалталарға ғана рұқсат беріңіз — пәрменде де, /add-dir арқылы да. Диск түбіріне қол жеткізуге рұқсат бермеңіз — бұл қауіпсіздіктегі алғашқы саңылау.
Мысал: алдымен /add-dir ~/Documents/design, содан кейін “~/Documents/design/landing-v3/ ішіндегі барлық макетті ағымдағы жобаға көшіріп, hero-*.png үлгісіне сай атауларын өзгерт.”
5.3. Postgres MCP — DBHub (Bytebase)
Не істейді: Claude-ты Postgres, MySQL, SQL Server, MariaDB немесе SQLite жүйесіне қосады. Тек оқуға арналған режимі бар, сондықтан AI агенті бір пәрменмен дерекқорды өшіре алмайды. Оны Anthropic-тың мұрағатталған server-postgres анықтамалық серверінің орнына жиі қолданады.
Орнату (HTTP, тек оқуға арналған):
claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly
Өндірістік дерекқор үшін әрқашан тек оқуға арналған рұқсаттары бар бөлек пайдаланушыны қолданыңыз әрі VIEW немесе делдал API маршруты арқылы жеке деректерді анонимдеңіз. Өндірістік дерекқорды жазу рұқсаттарымен қоспаңыз.
Мысал: “Өткен айда жазылым күйі expired болған клиенттерді сұратып, төлемнің жалпы сомасы бойынша алғашқы 20-ын тіз.”
Репозиторий: bytebase/dbhub.
5.4. Slack MCP — команда байланысы
Не істейді: Claude-қа Slack арналарын оқуға және хабар жіберуге мүмкіндік береді. Автоматтандыруға пайдалы: “Құрастыру сәтті аяқталғанда, #releases арнасына жаз”; “#engineering арнасынан апталық қорытынды құрастыр.”
Орнату (stdio, @modelcontextprotocol/server-slack сияқты npx wrapper-і немесе жеткізушінің баламасы арқылы):
claude mcp add slack \
-e SLACK_BOT_TOKEN=xoxb-... \
-e SLACK_TEAM_ID=T0... \
-- npx -y @modelcontextprotocol/server-slack
Авторизация Slack Bot Token арқылы жасалады; қолжетімділік Slack жағындағы ауқымдармен шектеледі. AI-ға тек chat:read және chat:write:user рұқсаттарын беруге болады, сонда ол жұмыс кеңістігінің параметрлерін өзгерте алмайды. Таңдалған сервердің ағымдағы пәрмендерін README файлынан қараңыз; экожүйе жылдам өзгеріп жатыр.
Мысал: “Күн сайын таңғы 9:00-де кеше біріктірілген PR тізімін #daily арнасына жібер.”
5.5. Notion MCP — білім базасы
Не істейді: Claude-қа Notion беттері мен дерекқорларына қол жеткізуге мүмкіндік береді. Бұл жобаңыздан тыс білім базасы: егер онда жазбалар, клиенттер тізілімі немесе редакциялық саясат сақталса, AI оларды оқи алады.
Орнату (HTTP, OAuth арқылы):
claude mcp add --transport http notion https://mcp.notion.com/mcp
Балама ретінде Anthropic-тың ресми @makenotion/claude-code-notion-plugin плагинін қолданыңыз.
Мысал: “Notion-дағы ‘Customers’ дерекқорынан күйі ‘active’ болып, соңғы екі аптадан астам уақыт бойы қоңырау болмаған адамдардың бәрін тап. Әрқайсысына электрондық хаттың жобасын дайында.”
Notion нұсқаулығы: developers.notion.com/guides/mcp.
5.6. Sentry MCP — қателерді бақылау
Не істейді: Claude-ты өндірістік жүйеңіздегі қателерге қосады. Бет 500 қатесімен істен шыққанда, “Жоба бойынша Sentry-дегі ең соңғы 10 мәселені көрсетіп, әрқайсысының түпкі себебін түсіндір” деп сұрап, бірден талдау алуға болады.
Орнату (HTTP):
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Авторизация Sentry OAuth арқылы жасалады. Қолжетімділікті белгілі бір жобамен шектеуге болады.
Мысал: “Соңғы 24 сағаттағы ең жиі кездесетін үш мәселені ал. Не болғанын қарапайым тілмен түсіндіріп, қалай түзетуге болатынын ұсын.”
Репозиторий: getsentry/sentry-mcp.
5.7. Playwright MCP — браузердегі жұмыс процестері
Не істейді: Claude-қа браузер береді. AI бетті аша алады, баса алады, пішінді толтыра алады және скриншот түсіре алады. UI тексерулеріне, жарияланғаннан кейінгі қолмен тестілеуге және жұмыс процесін талдауға пайдалы.
Орнату (stdio):
claude mcp add playwright -- npx -y @playwright/mcp@latest
2026 жылғы 7 мамырда шығарылған v0.0.75 нұсқасын Microsoft белсенді түрде қолдайды (32,000-нан астам жұлдызы бар).
Мысал: “Веб-сайтымыздың басты бетін ашып, барлық карточканың дұрыс көрсетілгенін тексер де, компьютер мен мобильді құрылғыда скриншот түсір.”
Репозиторий: microsoft/playwright-mcp.
Бекітілген нұсқасы бар пәрменді, бірнеше қатар сессияға арналған жалаушаны және жиі кездесетін орнату қателерін білу үшін таңдалған Playwright MCP нұсқасының README файлын қараңыз.
PreToolUse hook көмегімен қауіпсіздікті қалай бақылауға болады
Негізгі түйін
MCP AI-ға үлкен мүмкіндіктер береді: ол дерекқорларға жаза алады, хабар жібере алады және файлдарды өшіре алады. PreToolUse hook сәйкес құрал шақыруларын басқара алады, бірақ SQL префиксінің regex-і дерекқор авторизациясы емес және тек Postgres matcher-і Slack пен файл құралдарын қамтымайды. Алдымен нақты қызмет және файлдық рұқсаттарды қолданып, hook-тың дәл ауқымын бөлек сынаңыз.
SQL префикстерінің қара тізімі тек оқуға арналған рұқсат шекарасы емес: кіші әріпті SQL, пікірлер, UPDATE, INSERT, ALTER, бірнеше оператор және жанама әсері бар функциялар үш бас әріпті префикспен қамтылмайды. Дерекқор қосылымына бөлек, тек оқуға арналған рөл беріп, рұқсаттарын уақытша сынақ дерекқорында тексеріңіз. Hook — осы рұқсаттарды алмастырмайтын қосымша құрал шақыру бақылауы.
Міне, әдейі тар карантин мысалы: нақтырақ саясат қаралып, сыналғанша аталған үш MCP сервер тобының барлық шақыруына тыйым салынады. Оқуды да, жазуды да бұғаттайды. Нақты сервер/құрал атауларын сәйкестендіріңіз; аты өзгерген сервер, кіріктірілген Bash не басқа коннектор бұл үлгілерге кірмейді.
Бөлек ережелерді .claude/settings.json ішіне жазыңыз:
{
"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\""}]
}
]
}
}
Мына скриптті .claude/hooks/deny-unapproved-mcp.sh ретінде сақтаңыз. Ол ескі жоғарғы деңгейдегі decision: approve/block пішімін емес, құжатталған PreToolUse шешім келісімін қайтарады:
#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"This MCP server family is quarantined pending a reviewed policy."}}'
Бұл скрипт SQL-ді талдамайды не жіктемейді. Сәйкес шақырудың бәріне тыйым салады. Құнды деректерді қоспас бұрын оқшау сеанста сәйкестендіру мен hook нәтижесін тексеріңіз: құрал атаулары сәйкес болса, SELECT 1, кіші әріпті delete, алдында пікірі бар UPDATE, Slack оқу не жіберу құралы және Filesystem арқылы .env оқу — бәрі қабылданбауы керек. Басқа сервер тобының құралы мысалдан тыс қалуы керек; осы бөлек шекараны анық тексеріңіз.
Дерекқорды тек оқуға рұқсат ету үшін тексерілген дерекқор рұқсаттарын қолданып, карантинді нақты құралдарға арналған қаралған саясатпен алмастырыңыз. Slack тек оқуды қажет етсе, жіберу құқығы жоқ кіру дерегін пайдаланыңыз. Файлдар үшін сервердің рұқсат етілген түбірлері мен процестің файлдық рұқсаттарын шектеңіз. Бұл hook басқа құралдар, shell пәрмендері, промпт тіркемелері немесе агент өңдей алатын саясат файлы арқылы қолжетімділікті тоқтатады деп айтпаңыз.
Осы тәсіл Claude Code-тағы Plan Mode нұсқаулығында да толығырақ қарастырылған — онда да “орындамас бұрын тексеру” логикасы ұқсас.
40+ құрал болғанда Claude шатасса, не істеу керек?
Негізгі түйін
Жеті сервер 50–100 құралды оңай қамтуы мүмкін. Claude Code әдепкіде Tool Search қолданады: іске қосылғанда контекске тек құрал атаулары мен сервер нұсқаулары енгізіледі, ал Claude құрал қажет болғанда оның толық сипаттамасын жүктейді. Іздеу өшірулі болса, барлық сипаттамалар бірден жүктеледі де, шамамен 40 құралдан кейін Claude шатаса бастайды: дұрыс емес құралды таңдайды немесе кәдімгі пәрмен жеткілікті болса да MCP-ке жүгінеді.
Claude Code құжаттамасына сәйкес, ол қазір әдепкіде қосулы және оны қолмен қосудың қажеті жоқ.
Claude Code барлық құралды бірден жүктейтін ерекшеліктер: үшінші тарап проксиі арқылы жұмыс істеу (ANTHROPIC_BASE_URL Anthropic мекенжайынан басқа мекенжайға орнатылғанда), Google Cloud-та 4.5 буынынан ескі модельдер және Azure-дегі Microsoft Foundry орналастырулары. ENABLE_TOOL_SEARCH айнымалысы әрекетті өзгертеді:
- орнатылмаған — барлық MCP құралдары кейінге қалдырылып, сұраныс бойынша жүктеледі;
true— дәл солай, оған қоса Claude Code прокси арқылы іздеуді қосуға тырысады;auto— шек режимі: барлық құрал сипаттамалары контекст терезесінің 10%-ынан азын алса, бірден жүктеледі; одан асса, кейінге қалдырылады;auto:N— дәл солай, бірақ пайыздық шегі өзіңіз көрсетіледі, мысалыauto:5;false— бұрынғы әрекет; барлық құрал бірден контекске енгізіледі.
Әрдайым көрініп тұруы керек маңызды құралдар үшін сервер сипаттамасының қасындағы .mcp.json ішінде alwaysLoad: true жалаушасы бар. Мұндай әр құрал алғашқы минуттан бастап контексті алады, сондықтан мұны Claude-қа жауаптардың басым бөлігінде қажет құралдарға ғана қолданыңыз.
Егер сізде бес немесе одан көп MCP сервері болып, Claude қай құралды шақыру керегін шатастырса, алдымен іздеудің өшірілмегенін тексеріңіз: параметрлерден ENABLE_TOOL_SEARCH=false бар-жоғын және прокси арқылы жұмыс істеп жатқаныңызды қараңыз.
Сондай-ақ /compact көмегімен контексті азайту пайдалы болуы мүмкін.
MCP қашан қажет емес: Skill, Subagent немесе CLI жақсырақ па?
Негізгі түйін
Токен тұрғысынан Claude-қа сыртқы мүмкіндіктер берудің ең қымбат жолы — MCP. Тапсырманы дайын CLI құралымен (gh issue list, psql, curl) немесе бір беттік skill арқылы орындауға болса, MCP серверлерін жасаудың орнына соларды қолданыңыз. Ереже: MCP тек AI-ға қызметпен тікелей, екіжақты байланыс қажет болғанда негізді; бір реттік жауап үшін емес.
Токен құны мен күрделілігі бойынша реті:
- Bash арқылы CLI пәрмені — дерлік тегін. AI
gh pr list,psql -cнемесеcurlорындап, кәдімгі терминал пайдаланушысы сияқты жауап алады. - Skill — арзан. Нені шақыру және нәтижені қалай өңдеу керегін түсіндіретін дайын сұрау үлгісі. Қалта атауындағы триггерге қарай жүктеледі.
- Subagent — орташа. Ұзақ тапсырмаға арналған бөлек контекст, өз токен сессиясы бар.
- MCP сервері — қымбат. Контексте тек құрал атаулары қалады, бірақ Claude шақыру алдында құралды тапқанда оның сипаттамасы жүктеледі, ал қызмет жауаптары үлкен болуы мүмкін: құрал жауабы 10,000 токеннен асқанда Claude Code ескерту береді. Бұған қоса HTTP үшін OAuth сессиясы қажет.
Күтпегендей естілетін кеңес: веб-беттерді талдауға, git-пен жұмыс істеуге, PDF ашуға және ашық бастапқы утилиталарды пайдалануға MCP емес, CLI таңдаңыз. AI терминал пәрмендерін адам сияқты орындай алады; токендер құрал сипаттамаларына немесе сервер үстеме шығынына емес, тек пәрмен мен оның жауабына жұмсалады.
MCP екі жағдайда орынды:
- Қызмет жабық: Slack, Notion, Sentry, Linear. CLI құралдары да бар, бірақ MCP OAuth пен ауқымды шектеу арқылы қолжетімділікті дәлірек басқарады.
- Тікелей екіжақты байланыс қажет: AI Postgres-ке қосылып, схеманы тексереді, қосымша сұрау жолдайды, деректерді алып, келесі қадамды орындайды. CLI арқылы мұны 10 қолмен орындалатын пәрменге айналдыруға тура келер еді.
MCP-ке қосылуда жиі жіберілетін 6 қате
Негізгі түйін
MCP-пен алғашқы апталарда vibe coder-лер жиі сүрінетін алты нақты қате. Әрқайсысын бір минутта түзетуге болады: claude mcp list ашып, тізімді қарап, ауқымдар мен hook-тарды тексеріңіз. Көп мәселе жаңа сервер қосудан емес, қажетсіз серверді алып тастаудан шешіледі; бұл бөлім жоғарыдан төмен қарай өтуге арналған қысқа тексеру тізімі.
MCP шкафы. “Керек болып қалар” деп 10 сервер қостыңыз; Claude қай құралды шақыру керегін шатастырады, ал олардың жауаптары контексті толтырады. Шешімі: ағымдағы жоба үшін 3–5 сервер қалдырып, қалғанын
claude mcp removeарқылы алып тастаңыз.Өндірістік дерекқорға жазу рұқсаты. Postgres MCP-ті
--readonly, бөлек пайдаланушы немесе рұқсаттар тізімі жоқ өндірістік дерекқорға қостыңыз. Бір сұрау — “сынақ жазбаларын өшір” — өндірістік деректерді өшіреді. Шешімі: тексерілген тек оқу рұқсаттары бар бөлек дерекқор рөлі, қолданылатын жерде сервердің read-only режимі және сыналған құрал шақыру бақылаулары.DROP|TRUNCATE|DELETEпрефиксінің қара тізімі жеткілікті авторизация емес.Анонимдеусіз PII. Клиенттердің электрондық пошта мекенжайлары, телефон нөмірлері мен паспорт деректері бар дерекқорды тікелей қостыңыз. Claude деректерді көреді, олар Anthropic журналдарына түседі. Шешімі:
j***@gmail.comсияқты бүркемеленген деректерді қайтаратын VIEW немесе делдал API маршруты.Skill орнына MCP. Сізге “X пішімінде сату есебін жасау” керек — бұл дайын сұрауы бар skill шешетін күнделікті тапсырма. MCP серверін жасамаңыз.
Ашық бастапқы CLI орнына MCP. PDF-ті мәтінге айналдыру керек. Ол үшін
pdftotextбар. “PDF MCP” құрастырмаңыз — ол тек токенді босқа жұмсайды.Токен шығындарын бақыламау. Қосылған серверді
claude mcp listарқылы көре аласыз, бірақ әр әңгімеде оның қанша ресурс пайдаланатынын көрмейсіз. Бір аптадан соң “MCP контекстің 40%-ын жұмсап, осы уақыт бойы оған ақы төлеп келгенімді” білмей қаласыз. Шешімі: пайдаланылмайтын серверлерді мезгіл-мезгіл өшіріп, қолданыстың қалай өзгергенін Claude Code usage limit tracking арқылы бақылаңыз.
MCP байланысы сәтсіз болса, қалай жөндеуге болады?
Негізгі түйін
Ең жиі кездесетін мәселелер: OAuth callback жұмыс істемейді, сервер атауы бұрыннан бар атаумен қайшы келеді немесе add пәрменінен кейін құрал claude mcp list ішінде көрінбейді. Стандартты ақау іздеу циклі оларды шешеді: list қосылғандарды көрсетеді, status күй индикаторын тексереді, ал ол қызыл болса, logs stack trace қайтарады. --scope немесе ENV айнымалысын өзгерткеннен кейін бәрін қайта іске қосыңыз.
Қадамдық тексеру тізімі:
Сервер тізімде көріне ме?
claude mcp listКөрінбесе,
claude mcp addаяқталмаған. Ең жиі себебі —--scope: оныlocalмәнімен қосып, басқа жобадан тексеріп отырсыз.Сервер күйі жасыл ма?
claude mcp status <name>Қызыл түс процесс іске қосылмағанын (stdio үшін) немесе сервер жауап бермегенін (HTTP үшін) білдіреді.
Сервер журналдарында пайдалы ақпарат бар ма?
claude mcp logs <name>Stack trace көрсеңіз, мәселе әдетте пакетте болады (
npxоны таба алмаған немесе Node нұсқасы 20-дан төмен).OAuth callback қайта оралмай жатыр ма? Мәселе көбіне
--callback-portнемесе желілік сүзгіге байланысты. Белгілі бір портты бағыттаңыз:claude mcp add --transport http --callback-port 8765 [name] [url]Құрал атауы қайшы келе ме? Екі сервер бірдей атаулы құрал ұсынады, сондықтан Claude қате бірін шақырады. Tool Search қолданыңыз (алдыңғы H2 бөлімін қараңыз) немесе артық серверді
claude mcp removeарқылы қолмен алып тастаңыз.claude.ai кеңейтімдерін (connectors) көре алмайсыз ба? Бұл белгілі мәселе: claude.ai веб-интерфейсіндегі кеңейтімдер (connectors) API кілтін пайдаланғанда Claude Code-та қолжетімсіз. Шешімі: MCP-ті веб-интерфейс арқылы емес, CLI арқылы қосыңыз.
Әрі қарай не істеу керек: OAuth, өз MCP серверлеріңіз және плагиндер базары
Негізгі түйін
Дайын жеті серверден кейінгі келесі үш қадам: командамен MCP-ті бөліскіңіз келсе, өз HTTP серверлеріңізге OAuth қосу; бірегей қызмет үшін өз MCP-іңізді жазу; Anthropic Plugin Marketplace-ке қосылу. Marketplace 2025 жылғы 9 қазанда іске қосылды; онда MCP бір пәрменмен орнатылатын плагиндерге біріктірілген.
Plugin Marketplace орнату пәрмендерін есте сақтағысы келмейтіндер үшін жұмысты жылдамдатады. Пішімі — бір пакеттегі серверлер жиынын сипаттайтын .claude-plugin/marketplace.json манифесі.
Marketplace-тен плагин орнату:
claude plugin install <plugin-name>
Плагинде бірден бірнеше MCP сервері, skill және subagent болуы мүмкін — электрондық коммерция, маркетинг немесе заң бөлімі сияқты нақты жағдайға арналған жинақталған баптау.
modelcontextprotocol.io сипаттамасына сай өз MCP серверіңізді жазыңыз. Ең аз үлгі Anthropic-тың Python немесе TypeScript SDK-ын пайдаланады; одан кейін құралдарды сипаттап, тасымалдау түрін қосыңыз. Күрделілігі FastAPI арқылы REST API жазумен шамалас.
Егер жобаңызда бапталған CLAUDE.md және контекст инжинирингі туралы түсінік бар болса, өз MCP серверіңізді қосуға бір күн кетеді. Бұлар болмаса, алдымен негіздерін үйренген дұрыс.
Дереккөздер
- Model Context Protocol — ресми сайт
- Anthropic MCP-ті таныстырады — 2024 жылғы 25 қараша
- Claude Code MCP құжаттамасы
- Claude Code: MCP Tool Search
- Claude Code плагиндері туралы хабарландыру — 2025 жылғы 9 қазан
- Code with Claude 2026
- modelcontextprotocol/servers — ресми тізілім
- github/github-mcp-server
- microsoft/playwright-mcp
- bytebase/dbhub — Postgres MCP
- getsentry/sentry-mcp
- makenotion/claude-code-notion-plugin
- Notion MCP нұсқаулығы
- Anthropic Claude Code репозиторийі — issues және өзгерістер журналы
Модельдермен жұмысты жалғастыру үшін Ailoot сайтына өтіңіз.
Толығырақ
Жиі қойылатын сұрақтар
Бұл hook өндірістік дерекқорды тек оқуға арналған ете ме?
Жоқ. Мысал аталған MCP топтарына сәйкес барлық шақыруды карантинге қояды; SQL-ді жіктемейді. Тек оқу тәртібі тексерілген read-only рұқсаттары бар бөлек рөлден келуі керек, hook қосымша бақылау ретінде қолданылады.
Hook ауқымын қалай сынаймын?
Оқшау сеанста сәйкес құрал атаулары үшін оқу да, жазу да, соның ішінде кіші әріпті не алдында пікірі бар SQL де қабылданбайтынын тексеріңіз. Кейін қатысы жоқ құрал matcher-ден тыс екенін қараңыз; қамтылмаған жолға өз рұқсаты не саясаты қажет.