Клод жұмыс үстелінде MCP серверін қалай құру керек — практикалық нұсқаулық - CometAPI - бір API ішіндегі барлық AI үлгілеріне қалай қол жеткізуге және пайдалануға болады

Anthropic жариялаған кезден бастап Мәтінмәндік протокол үлгісі (MCP) on Қараша 25, 2024, MCP тұжырымдамадан практикалық экожүйеге жылдам көшті: ашық спецификация және бірнеше анықтамалық серверлер қол жетімді, қауымдастық іске асырулары (жад серверлері, файлдық жүйеге кіру, веб-алғыштар) GitHub және NPM жүйелерінде және MCP сияқты клиенттерде қазірдің өзінде қолдау көрсетіледі. Жұмыс үстеліне арналған Клод және үшінші тарап құралдары. Протокол дамыды (спецификация мен сервер мысалдары 2025 жылға дейін жаңартылды) және жеткізушілер мен инженерлер қауіпсіз, таңбалауыш тиімді интеграцияларға арналған үлгілерді жариялауда.

Бұл мақала MCP серверін құру және оны қосу арқылы көрсетеді Клод жұмыс үстелі, және сізге өндірісте қажет практикалық / қауіпсіздік / жад бойынша кеңестер.

Үлгі контекстік протоколы (MCP) дегеніміз не?

Қарапайым ағылшынша анықтама

Үлгі контекстік протоколы (MCP) - бұл ашық, стандартталған хаттама бұл LLM хосттарына (үлгіні басқаратын қолданбалар, мысалы, Клод жұмыс үстелі) сыртқы қызметтерге қоңырау шалуын жеңілдетеді. ресурстар (файлдар, ДҚ жолдары), құралдары (үлгі шақыра алатын функциялар) және шақырады (үлгі пайдалана алатын үлгілер). N×M интеграциясын (әрбір құралға арналған әрбір үлгі) енгізудің орнына MCP клиент-сервер схемасын және кез келген MCP-үйлесімді үлгі хосты кез келген MCP-үйлесімді серверді пайдалана алатындай жұмыс уақыты келісім-шартын қамтамасыз етеді, сондықтан әзірлеушілер қызметтерді бір рет құра алады және кез келген MCP-хабарлама үлгісін немесе UI (мысалы, Клод жұмыс үстелі) оларды пайдалануға мүмкіндік береді.

Неліктен MCP қазір маңызды

2024 жылдың аяғында Anthropic ашық бастапқы MCP бері протокол тез арада құралдарды біріктіру үшін де-факто өзара әрекеттесу деңгейіне айналды (Клод, VS Code кеңейтімдері және басқа агент орталары). MCP қайталанатын жұмыстарды азайтады, қосқыштардың (Google Drive, GitHub, Slack және т.б.) дамуын жылдамдатады және ассистентке тұрақты жад қоймаларын тіркеуді жеңілдетеді.

MCP архитектурасы дегеніміз не және ол қалай жұмыс істейді?

Жоғары деңгейде MCP үш рөлдік топты және бірнеше өзара әрекеттесу үлгілерін анықтайды.

Негізгі компоненттер: клиенттер, серверлер және тізілім

MCP клиенті (хост): Мәтінмәндік деректерді қажет ететін LLM хосты немесе қолданбасы — Клод жұмыс үстелі, VS коды агенті немесе веб-бағдарлама. Клиент бір немесе бірнеше MCP серверлерін табады және оларға қосылады.
MCP сервері (ресурс провайдері): MCP схемасы арқылы ресурстарды (файлдарды, жадтарды, дерекқорларды, әрекеттерді) ашатын желі қызметі. Серверлер өз мүмкіндіктерін жариялайды және клиент қоңырау шала алатын соңғы нүктелерді береді.
Тіркеу / Ашу: Клиентке қол жетімді MCP серверлерін табуға, мүмкіндіктерді тізімдеуге және рұқсаттарды немесе орнатуды басқаруға көмектесетін қосымша құрамдас бөліктер немесе конфигурация файлдары (жұмыс үстелінің «кеңейтімдері» бұл үшін бір UX деңгейі болып табылады).

Хабар ағындары және мүмкіндік келіссөздері

MCP өзара әрекеттесулері әдетте мына үлгіге сәйкес келеді:

Ашу/тіркеу: Клиент қолжетімді серверлер (жергілікті, желілік немесе таңдалған тізілімдер) туралы біледі.
Мүмкіндік туралы хабарландыру: Сервер ресурстарды, әдістерді және авторизация талаптарын сипаттайтын манифестпен бөліседі.
Сұраныс/жауап: Клиент құрылымдық сұрауларды шығарады (мысалы, «X файлын оқу», «Y үшін жадтарды іздеу» немесе «осы файлдармен PR жасау») және сервер терілген мәтінмәндік деректермен жауап береді.
Әрекет нәтижелері және трансляция: Серверлер нәтижелерді ағынмен жіберуі немесе ұзақ жұмыс істейтін соңғы нүктелерді қамтамасыз етуі мүмкін. Ерекшелік терілген ресурс дескрипторлары мен жауаптар үшін схемаларды анықтайды.

Қауіпсіздік моделі және сенім шекаралары

MCP басқару беттерін әдейі стандарттайды, осылайша LLM пайдаланушы деректеріне әрекет етіп, әрекеттерді орындай алады. Бұл қуат мұқият қауіпсіздік бақылауын қажет етеді:

Пайдаланушының нақты келісімі/сұраулары серверлер жеке деректерге қол жеткізе алатын немесе артықшылықты әрекеттерді орындаған кезде ұсынылады (мысалы, репоға жазу).
Ең аз артықшылық мыналарды көрсетеді: Серверлер ең аз аумақтарды жариялауы керек және клиенттер тек қажетті мүмкіндіктерді сұрауы керек.
Тасымалдау және аутентификация: Сезімтал интеграциялар үшін TLS, таңбаланған тіркелгі деректері және тек жергілікті соңғы нүктелерді пайдаланыңыз. Қауымдастық пен платформа жеткізушілері (мысалы, Windows жүйесіндегі Microsoft) тәуекелдерді азайту үшін тізілімдермен және UI мүмкіндіктерімен тәжірибе жасауда.

Неліктен Клодты MCP серверлерімен біріктіру керек?

Клодты MCP серверлерімен біріктіру мүмкіндіктердің үш практикалық класын ашады:

Нақты уақыттағы, әрекет етуге болатын контекст

Ескірген суреттерді көшіру және сұрауларға ендірудің орнына, Клод сұрау уақытында жаңартылған контекстті (файлдар, сөйлесулер тарихы, ДҚ жолдары) сұрай алады. Бұл шамамен іздеулер аз және жаңарақ нәтижелер дегенді білдіреді. Anthropic демонстрациялары Клодқа GitHub PR жасау немесе MCP арқылы жергілікті файлдарды оқу сияқты әрекеттерді көрсетеді.

Бір алып адаптерден гөрі шағын, құрастырылатын құралдар

Сіз фокусталған MCP серверлерін жаза аласыз (біреуі күнтізбе үшін, біреуі файлдық жүйе үшін, екіншісі векторлық жад қоймасы үшін) және оларды әртүрлі Клод даналарында немесе клиенттерде (жұмыс үстелі, IDE, веб) қайта пайдалануға болады. Бұл модульдік арнайы интеграцияларға қарағанда жақсырақ масштабталады.

Тұрақты және стандартталған жады

MCP жад қызметтерін қосады: сөйлесу тарихын, жеке қалауларды және құрылымдық пайдаланушы күйін кодтайтын тұрақты қоймалар. MCP ресурс үлгісін стандарттайтындықтан, бірнеше клиенттер бір жад серверін қайта пайдалана алады және қолданбалар арасында тұрақты пайдаланушы контекстін сақтай алады. Бірнеше қауымдастық жады қызметтері мен кеңейтім үлгілері бұрыннан бар.

Жақсырақ UX және жергілікті басқару (Клод жұмыс үстелі)

Жұмыс үстеліндегі клиенттерде MCP жергілікті серверлерге пайдаланушының файлдық жүйесіне тікелей қатынасумен (келісіммен) мүмкіндік береді, бұл құпиялылыққа сезімтал интеграцияларды бұлттық API интерфейстерінсіз мүмкін етеді. Anthropic's Desktop Extensions жергілікті машиналарда MCP серверлерін орнатуды және табуды жеңілдетудің мысалы болып табылады.

MCP серверін қалай құруға болады

Бастамас бұрын сізге не қажет

Клод жұмыс үстелі: ОЖ үшін соңғы Claude Desktop шығарылымын орнатыңыз және параметрлерде MCP/кеңейтімдер қолдауының қосылғанын тексеріңіз. Кейбір мүмкіндіктер ақылы жоспарды қажет етуі мүмкін (Claude Pro немесе баламасы).
Әзірлеуші машина: Node.js (>=16/18 ұсынылады) немесе Python 3.10+, сонымен қатар жергілікті серверді тестілеу үшін интернетке шығарғыңыз келсе, ngrok немесе жергілікті туннельдеу шешімі. Өндірісте TLS пайдаланыңыз.
MCP жобасы негізгі құжаттарда және GitHub репосында SDK және үлгілерді қамтамасыз етеді; Python немесе Node SDK файлын docs/repo ішіндегі ресми нұсқаулар арқылы орнатыңыз.

А опциясы — Бар (мысал) MCP серверін орнатыңыз

Anthropic жадты, файлдық жүйені және құралдарды қоса алғанда, мысал серверлерін ұсынады.

Анықтамалық серверлерді клондау:

git clone https://github.com/modelcontextprotocol/servers.git
cd servers

Ішінде сіз келесідей қалталарды таба аласыз:

filesystem/
fetch/
memory/
weather/

Мысал серверді орнату үшін:

cd memory
npm install
npm run dev

Бұл MCP серверін бастайды, әдетте:

http://localhost:3000

Манифесттің соңғы нүктесінің жұмыс істейтінін және құралды шақыру дұрыс терілген JSON қайтаратынын растаңыз.

В опциясы — жеке MCP серверін жасаңыз (үйрену үшін ұсынылады)

1) Жоба қалтасын жасаңыз

mkdir my-mcp-server
cd my-mcp-server
npm init -y

2) MCP сервер SDK орнатыңыз

npm install @modelcontextprotocol/server

3) Негізгі сервер файлын жасаңыз

жасау server.js:

touch server.js

MCP серверінің минималды орындалуын қойыңыз:

import { createServer } from "@modelcontextprotocol/server";

const server = createServer({
  name: "my-custom-server",
  version: "0.1.0",

  tools: [
    {
      name: "hello_world",
      description: "Returns a simple greeting",
      input_schema: {
        type: "object",
        properties: {
          name: { type: "string" }
        },
        required: 
      },
      output_schema: {
        type: "object",
        properties: {
          message: { type: "string" }
        }
      },
      handler: async ({ name }) => {
        return { message: `Hello, ${name}!` };
      }
    }
  ]
});

server.listen(3000);
console.log("MCP server running on http://localhost:3000");

Бұл толық MCP сервері бір құралды көрсету: hello_world.

Клод жұмыс үстелін MCP серверіне қалай қосуға болады?

Төменде қарапайым MCP серверін жасауға және оны Клод жұмыс үстелінде тіркеуге арналған практикалық қадам берілген. Бұл бөлім практикалық: ол ортаны орнатуды, сервер манифестін жасауды, клиент күткен соңғы нүктелерді көрсетуді және серверді пайдалану үшін Клод жұмыс үстелін конфигурациялауды қамтиды.

1) Claude Desktop әзірлеушісінің қосылым аймағын ашыңыз

Клод жұмыс үстелінде: Параметрлер → Әзірлеуші (немесе Параметрлер → Коннекторлар клиент құрылысына байланысты). Қашықтағы/жергілікті MCP серверін немесе «Қосқышты қосу» опциясы бар. Нақты пайдаланушы интерфейсі шығарылымдар арасында өзгеруі мүмкін — егер оны көрмесеңіз, жұмыс үстелінің «Әзірлеуші» мәзірін немесе соңғы шығарылым жазбаларын тексеріңіз.

Клод жұмыс үстеліндегі MCP сервері

2) Жергілікті серверді конфигурациялап жатсаңыз: Конфигурация файлын жасаңыз немесе орналастырыңыз

Claude жұмыс үстелі қолданбасын іске қосқаннан кейін ол барлық табылған MCP серверлерін ClaudeDesktopConfig.json деп аталатын файлға автоматты түрде конфигурациялайды. Бірінші қадам - бұл файлды табу және ашу немесе ол бұрыннан жоқ болса, оны жасау:

Windows пайдаланушылары үшін файл “%APPDATA%\Claude\claude_desktop_config.json” астында орналасқан.

Mac пайдаланушылары үшін файл “~/Library/Application Support/Claude/claude_desktop_config.json” астында орналасқан.

3) Серверді Клод жұмыс үстеліне қосыңыз

Клод жұмыс үстеліне MCP серверіңіз туралы білуге мүмкіндік беретін екі UX үлгісі бар:

Жұмыс үстелі кеңейтімдері / Бір рет басу арқылы орнатушылар: Anthropic бағдарламасы пайдаланушылар бір рет басу ағыны арқылы серверлерді қоса алатын (кеңірек тарату үшін ұсынылады) бума манифесттері мен орнатушылары болатын «Жұмыс үстелі кеңейтімдерін» құжаттады. Оңай орнату үшін манифест пен сервер метадеректерін бумалауға болады.

Жергілікті серверді тіркеу (әзірлеуші режимі): Жергілікті тестілеу үшін:

Манифестті белгілі жергілікті жолға орналастырыңыз немесе оған қызмет көрсетіңіз https://localhost:PORT/.well-known/mcp-manifest.json.
Клод жұмыс үстелінің параметрлерінде MCP/кеңейтімдер тақтасын ашып, «Жергілікті серверді қосу» немесе «URL арқылы серверді қосу» опциясын таңдап, манифест URL мекенжайын немесе таңбалауышты қойыңыз.
Клиент сұраған кезде қажетті рұқсаттарды беріңіз. Клод сервер ресурстарын санап, оларды қолжетімді құралдар/жадтар ретінде ұсынады.

Енді біз жергілікті MCP орнатуды таңдаймыз:Қосу mcpServers бөлім бұл сервер атауын және оны бастау үшін абсолютті жолды/пәрменді тізімдейді. Клод жұмыс үстелін сақтаңыз және қайта іске қосыңыз.

Қайта іске қосқаннан кейін Клодтың пайдаланушы интерфейсі MCP құралдарын (Іздеу және құралдар белгішесі) ұсынады және сізге ашық әрекеттерді тексеруге мүмкіндік береді (мысалы, «Сакраментодағы ауа-райы қандай?»). Егер хост сіздің серверіңізді анықтамаса, келесіге хабарласыңыз mcp.log файлдар және mcp-server-<name>.log STDERR шығысы үшін.

4) Интеграцияны сынау

Клод чатында теріңіз:

Call the hello_world tool with name="Alice"

Клод MCP серверіңізді шақырады және құрал шығысын пайдаланып жауап береді.

MCP (қосымша кеңестер) арқылы жад қызметін қалай жүзеге асыруға болады?

Жад қызметтері ең қуатты MCP серверлерінің бірі болып табылады, себебі олар тұрақты және сеанстар бойынша пайдаланушы контекстін көрсетеді. Келесі ең жақсы тәжірибелер мен енгізу бойынша кеңестер спецификацияны, Клод құжаттарын және қауымдастық үлгілерін көрсетеді.

Жад деректерінің моделі және дизайны

Құрылымды және құрылымсыз: Құрылымдық фактілерді (мысалы, атау, таңдау жалаулары) және құрылымдалмаған сөйлесу бөліктерін сақтаңыз. Жылдам сүзгілеу үшін терілген метадеректерді пайдаланыңыз.
Бөлшектеу және ендіру: Ұзақ құжаттарды немесе сөйлесулерді мағыналық жағынан біріктірілген бөліктерге бөліп, ұқсастықты іздеуді қолдау үшін векторлық ендірулерді сақтаңыз. Бұл еске түсіруді жақсартады және шығарып алу кезінде таңбалауышты пайдалануды азайтады.
Соңғы және маңызды сигналдар: Уақыт белгілерін және маңызды ұпайларды жазыңыз; соңғы немесе маңызды естеліктерді ұнататын сұрауларға рұқсат етіңіз.
Құпиялық тегтері: Сезімталдық белгілері бар элементтерді (жеке, ортақ, уақытша) белгілеңіз, осылайша клиент келісім сұрай алады.

Жад операцияларына арналған API үлгілері

Кем дегенде үш операцияны орындаңыз:

write: метадеректері бар жад элементін қабылдайды, растау мен сақтау идентификаторын қайтарады.
query: Табиғи тіл сұрауын немесе құрылымдық сүзгіні қабылдайды және ең жақсы сәйкес келетін жадтарды қайтарады (міндетті түрде түсіндірме метадеректерімен бірге).
delete/update: Өмірлік цикл операцияларын және ұмыту үшін анық пайдаланушы сұрауларын қолдау.

Жауаптарды клиент пен модель жадты қаншалықты агрессивті пайдалану керектігін шеше алуы үшін шығу тегі (жад қайдан пайда болды) және сенімділік/ұқсастық ұпайын қамтитындай етіп құрастырыңыз.

Клод үшін іздеуді кеңейту стратегиялары

Қысқа мәтінмәндік терезелер: Толық құжаттардың орнына қысқаша жад үзінділерін қайтарыңыз; қажет болса, Клод толық мәтінмәнді сұрауға рұқсат етіңіз.
Қорытындылау қабаты: Таңбаларды азайту үшін әрбір жадтың қысқаша мазмұнын қосымша сақтаңыз. Жазу кезінде қосымша қорытындылауды пайдаланыңыз.
Бақыланатын инъекция: Жадты тіркелетін «контекстік бума» ретінде қамтамасыз етіңіз, клиент үлгіні барлығымен толтырмай, сұрауларға таңдаулы түрде енгізе алады.

Жад MCP үшін қауіпсіздік және басқару

Келісім және аудит ізі: Жад қашан жасалғанын және пайдаланушы оны үлгімен бөлісуге келісімін бергенін жазыңыз. Клод жұмыс үстелінде естеліктерді қарап шығу және жою үшін нақты UI мүмкіндіктерін ұсыныңыз.
Бағаны шектеу және тексеру: Түрлерді тексеру және серверлерден күтпеген кодты орындау сұрауларына жол бермеу арқылы жедел инъекциядан немесе эксфильтрациядан қорғаңыз.
Демалыс және транзит кезіндегі шифрлау: Сақталған элементтер үшін күшті шифрлауды және барлық MCP соңғы нүктелері үшін TLS пайдаланыңыз. Бұлт қолдайтын дүкендер үшін конверт шифрлауын немесе бар болса, тұтынушы басқаратын кілттерді пайдаланыңыз.

Қорытынды: Claude Desktop жүйесінде MCP серверін қалай құруға болады

Мақала нөлден өтуге арналған ықшам, прагматикалық рецепт → ноутбукта жұмыс істейтін Claude + жад сервері:

Жұмыс процесін тексеру: Клодтан қысқа фактіні «есте сақтауын» және оны сақтаған серверді тексеруді сұраңыз; содан кейін Клодтан бұл фактіні кейінірек еске түсіруін сұраңыз. Журналдарды бақылаңыз және іздеу рейтингін реттеңіз.
Орнату алғышарттары: Node.js >= 18, Git, Claude Desktop (соңғы).
Анықтамалық серверді клондау: шанышқымен modelcontextprotocol/servers мысалдар немесе GitHub жүйесіндегі қауымдастық жады сервері.
Орнату және іске қосу: npm install → npm run dev (немесе README репосын орындаңыз). Манифесттің соңғы нүктесін растаңыз (мысалы, http://localhost:3000/manifest) JSON қайтарады. ()
Клод жұмыс үстеліндегі қосқышты тіркеңіз: Параметрлер → Әзірлеуші / Қосқыштар → Қосқышты қосу → нүктесін көрсетіңіз http://localhost:3000 және аумақтарын бекітеді.

Клодты (немесе кез келген хостты) MCP серверлерімен біріктіру қосқышты бір рет жасауға және оны MCP клиенттерінде — Клод жұмыс үстелінде, IDE-де немесе басқа агент құрылымдарында қол жетімді етуге мүмкіндік береді, бұл техникалық қызмет көрсетуді күрт төмендетеді және құралдар арасындағы мүмкіндіктер паритетін жылдамдатады.

Әзірлеушілер claude AI соңғы API интерфейсіне (осы мақаланың жарияланған күнінен бастап) қол жеткізе алады, мысалы Claude Sonnet 4.5 API және Claude Opus 4.1 API CometAPI арқылы, соңғы үлгі нұсқасы әрқашан ресми сайтпен жаңартылып отырады. Бастау үшін үлгінің мүмкіндіктерін зерттеңіз Ойын алаңы және кеңесіңіз API нұсқаулығы егжей-тегжейлі нұсқаулар үшін. Қол жеткізу алдында CometAPI жүйесіне кіріп, API кілтін алғаныңызға көз жеткізіңіз. CometAPI біріктіруге көмектесу үшін ресми бағадан әлдеқайда төмен баға ұсыныңыз.

Баруға дайынсыз ба?→ CometAPI-ге бүгін тіркеліңіз !

Егер сіз AI туралы көбірек кеңестер, нұсқаулықтар және жаңалықтар білгіңіз келсе, бізге жазылыңыз VK, X және Арасындағы айырмашылық!

Клод жұмыс үстелінде MCP серверін қалай құру керек — практикалық нұсқаулық