Модель контекстік протоколы (MCP) - Anthropic сияқты үлгілерге мүмкіндік беретін ашық стандарт. Клод және әзірлеуші құралдары сияқты Клод коды қауіпсіз, стандартты жолмен сыртқы құралдарға, деректер көздеріне және сұрауларға қоңырау шалыңыз.
Бұл нұсқаулық сізге нөлден бастап жеке MCP серверін құруға көмектеседі, бұл Клод кодына теңшелетін мүмкіндіктерге қол жеткізуге мүмкіндік береді және осылайша оның функционалдығын кірістірілген мүмкіндіктерден әлдеқайда кеңейтеді.
Үлгі контекстік протоколы (MCP) дегеніміз не?
MCP (Model Context Protocol) - бұл ашық спецификация Тіл үлгісіндегі клиенттердің (мысалы, Клод, Клод коды немесе басқа LLM интерфейстері) құрал серверлері мен деректер көздеріне қосылу жолын стандарттау үшін жасалған. MCP-ді «LLM-ге арналған USB-C порты» ретінде қарастырыңыз: ол тасымалдау/JSON-RPC схемасын және серверлердің мүмкіндіктердің үш түрін жариялаудың жалпы әдісін анықтайды:
- ресурстар — клиент оқи алатын файлға ұқсас немесе құжат деректері (мысалы, дерекқор жолы, мәтіндік файл, JSON пайдалы жүктемесі).
- Құралдар — модель хосттан орындауды сұрай алатын шақырылатын функциялар (пайдаланушының рұқсатымен).
- Өсиеттер — үлгі/клиент шақыра алатын қайта пайдалануға болатын шақыру үлгілері немесе жұмыс үрдістері.
MCP бірнеше тасымалдауларды (stdio, HTTP, SSE) қолдайды және схеманы, SDK және мысал серверлерін қамтамасыз етеді, сондықтан сым пішімін өзіңіз ойлап табудың қажеті жоқ. Протокол жалпыға қолжетімді (спецификация + SDK) және қабылдауды жылдамдату үшін оқулықтар мен мысал серверлерінің галереясы бар.
MCP қалай құрастырылған?
MCP архитектурасы әдейі қарапайым және модульдік: негізгі бөліктер MCP болып табылады серверлер, MCP клиенттер, және көлік желісі олардың арасында JSON-RPC жақтаулы хабарламаларды тасымалдайтын. Төменде Claude Code (немесе басқа MCP клиенттері) үшін сервер құру кезінде өзара әрекеттесетін негізгі құрамдас бөліктер берілген.
Сервер, клиент және протокол
- MCP сервері — Бұл қызмет жариялайды құралдар, ресурстар және нұсқаулар. Құралдар жанама әсерлер жасай алады немесе деректерді ала алады; ресурстар бетіндегі тек оқуға арналған мазмұн; шақырулар клиент үлгіден үлгі алуды сұрай алатын қайта пайдалануға болатын шақыру үлгілері.
- MCP клиенті (хост) — Әдетте LLM хостының бөлігі (мысалы, Claude Code, VS Code плагині, браузер клиенті). Ол қол жетімді серверлерді табады, үлгіге құрал сипаттамаларын ұсынады және модельден басталатын қоңырауларды серверлерге бағыттайды.
- Хаттама — Хабарлар JSON-RPC ретінде кодталады; спецификация өмірлік цикл оқиғаларын, құралды табуды, шақыруды, аяқтауларды/іріктеуді және құрылымдық нәтижелердің клиент пен үлгіге қалай тасымалданатынын анықтайды.
Байланыс үлгісі (құрал пайдаланылғанда не болады)
- Клиент модельге пайдаланушы хабарламасын жібереді.
- Үлгі мәтінмәнді талдайды және MCP (немесе бірнеше құралдар) арқылы ашылған құралды шақыруды шешеді.
- Клиент құрал шақыруын MCP серверіне таңдалған тасымалдау арқылы жібереді.
- Сервер құралды орындайды және нәтижелерді қайтарады.
- Модель құралдың шығысын алады және пайдаланушыға соңғы жауапты құрастырады.
Іске асыру примитивтері
- JSON-RPC хабарлар MCP схемасына сәйкес келеді.
- Құрал анықтамалары сервердің анықтау жауаптарында жарияланады, осылайша клиенттер оларды UI-де көрсете алады.
- ресурстар сілтеме жасайды
@source:pathклиенттердің синтаксисі (мысалы,@postgres:...), рұқсат беру үлгілері шақыруға үлкен деректерді кірістірмей сыртқы мазмұнға сілтеме жасайды.
Неліктен Клод кодын MCP серверлерімен біріктіру керек?
Claude Code — кодқа және әзірлеушіге бағытталған жұмыс процестеріне (редактор/IDE интеграциясы, кодты түсіну және т.б.) бағытталған Anthropic ұсынысы. MCP серверлері арқылы ішкі құралдарыңызды (көзді іздеу, CI жүгірткісі, билет жүйесі, жеке тізілімдер) көрсету Клод кодына оларды шақыруға мүмкіндік береді. бірінші дәрежелі құралдар сұхбаттар мен агент ағындарын кодтау ішінде.
Клод кодын MCP серверлерімен біріктіру кодтау агенті үшін практикалық, өндіріске қатысты мүмкіндіктерді ашады:
1. Үлгіге рұқсат етіңіз акт нақты жүйелерде
Клод коды MCP серверінен мәселе трекерлерін сұрауды, дерекқор сұрауларын іске қосуды, үлкен құжаттарды оқуды немесе GitHub PR жасауды сұрай алады, бұл кодтау сеансы ішінде түпкілікті автоматтандыруды қосады. Бұған Клод кодының құжаттары нақты қолдау көрсетеді (мысалы: Postgres, Sentry сұрауы немесе PR жасау).
2. Үлкен деректер мен арнайы логиканы түсіру
Әрбір деректер көзін шақыруға (токендерді тұтынатын) ендірудің орнына, сіз MCP арқылы деректер мен құралдарды жариялайсыз. Модель құралды шақырады, құрылымдық жауап алады және оның себептерін анықтайды — бұл таңбалауышты пайдалануды азайтады және серверлерге ауыр жұмыстарды орындауға мүмкіндік береді (ДҚ сұраулары, ұзақ файлдарды оқу, аутентификация).
3. Қауіпсіздік және басқару
MCP сервер деңгейінде кіруді басқаруды және аудитті орталықтандырады, ұйымдарға мақұлданған серверлерді ақ тізімге енгізуге, қандай құралдар бар екенін бақылауға және шығыстарды шектеуге мүмкіндік береді. Клод коды сонымен қатар кәсіпорынның MCP конфигурациясын және әр аумақтың келісімін қолдайды.
4. Қайта пайдалану және экожүйе
MCP серверлері клиенттер мен топтарда қайта пайдалануға болады. Бір рет құрастырыңыз және көптеген Claude/LLM клиенттері бірдей қызметтерді (немесе своп енгізулерін) пайдалана алады.
Бастамас бұрын сізге не қажет?
Ең төменгі талаптар
- бар әзірлеу машинасы Python 3.10+ (мысалда Python-ды қолданамыз). Немесе Түйін/басқа тілдерге MCP SDK қолдау көрсетеді.
uv(Astral құралы) немесе MCP stdio серверлерін іске қосуға арналған баламалы жүгіргіш (MCP оқулығы пайдаланадыuv). Төменде көрсетілген орнату қадамдары.- Клод коды орнатылды немесе серверді тіркеу және тексеру үшін Клод клиентіне (жұмыс үстелі немесе CLI) қол жеткізу; немесе кез келген MCP қабілетті клиент. Клод коды HTTP, SSE және жергілікті stdio серверлерін қолдайды.
- Қауіпсіздік жазбасы: Клод кодына тек сенімді MCP серверлерін топ немесе кәсіпорын параметрлерінде қосыңыз — MCP серверлерге құпия деректерге рұқсат береді және сервер зиянды мазмұнды қайтарса, жылдам енгізу қаупі бар.
Клод кодын CLI қалай орнатуға және тексеруге болады
Бұл Клод кодын орнату және пайдалану жөніндегі нұсқаулық.
1) Жылдам қорытынды — ұсынылған орнату әдістері
пайдаланыңыз жергілікті орнатушы (ұсынылады) немесе macOS/Linux жүйесінде Homebrew. Түйінге негізделген орнату қажет болса, NPM қолжетімді. Windows жүйесі PowerShell / CMD орнатушыларын алады. Дереккөз: ресми Claude Code құжаттары және GitHub.
2) Пререквизиттер
- macOS 10.15+, Ubuntu 20.04+/Debian 10+ немесе Windows 10+ (Windows жүйесінде WSL ұсынылады).
- Node.js 18+ тек қажет NPM орнату әдісі үшін.
3) Орнату пәрмендері (біреуін таңдаңыз)
Түпнұсқа (ұсынылады — түйінге тәуелділік жоқ), macOS / Linux / WSL:
curl -fsSL https://claude.ai/install.sh | bash
# optional: install latest explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest
# or install a specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
# or for latest: & (::Create((irm https://claude.ai/install.ps1))) latest
(Бұл ресми жергілікті орнатушы сценарийлері).
NPM (егер сіз түйін негізіндегі жаһандық орнатуды қаласаңыз):
# requires Node.js 18+
npm install -g @anthropic-ai/claude-code
емес пе пайдалану sudo npm install -g — sudo жаһандық орнатуларына қарсы ескерту (рұқсат/қауіпсіздік мәселелері). Рұқсат қателеріне тап болсаңыз, пайдаланыңыз nvm немесе sudo пайдаланудың орнына npm жаһандық префиксін түзетіңіз.
4) Екілік орнатылғанын тексеріңіз (негізгі тексерулер)
Орнатқаннан кейін оларды дереу жергілікті түрде іске қосыңыз:
# is the command on PATH?
which claude
# version (or -v)
claude --version
# or
claude -v
# help (sanity check)
claude --help
Күтілетін: which жолды көрсетеді (мысалы /usr/local/bin/claude or ~/.nvm/.../bin/claude) және claude --version семвер тәрізді жолды басып шығарады. Құжаттар мен README екеуі де көрсетеді claude негізгі CLI кіру нүктесі ретінде.
5) Орнату денсаулығы мен конфигурациясын тексеріңіз (ұсынылатын тексерулер)
a) claude doctor，Жүгіру:
claude doctor
Бұл кірістірілген диагностика орнату түрін, жалпы мәселелерді (npm рұқсат мәселелері сияқты), тәуелділіктерді тексереді. ripgrep, және түзетулерді ұсынады. Құжаттар нақты іске қосуды ұсынады claude doctor орнатқаннан кейін.
б) Түтін сынағы (интерактивті емес)
Жоба каталогыңыздан:
cd /path/to/your/project
claude -p "Explain this project in 3 sentences"
Бұл пайдаланады басу режимі (-p) бір сұрауды жіберу, содан кейін шығу; CI немесе жылдам функционалды тексерулер үшін жақсы.
c) Аутентификацияны тексеру (CLI-ның Anthropic-ке жете алатынына көз жеткізіңіз)
Клод коды бірнеше аутентификация ағындарын қолдайды (Console OAuth, API кілті, провайдер интеграциясы). Жалпы тексерулер:
- API кілтін пайдалансаңыз (CI / headless / local env var):
export ANTHROPIC_API_KEY="sk-..."
# then
claude auth status
claude auth whoami # or `claude auth whoami` / `claude whoami` depending on version
Сіз пайдалана аласыз CometAPIКлод кодын пайдалану үшін API кілті, CometAPI арқылы Клод API пайдалану сізге 20% жеңілдік береді.
- Консоль арқылы OAuth пайдалансаңыз - жүгіру:
claude auth status
claude auth whoami
Тіркелгі/жоспар туралы ақпаратты немесе аутентификациядан өткеніңізді растауды көруіңіз керек.
Қоршаған ортаны кезең-кезеңімен дайындау
Төменде екі жалпы әзірлеуші стектерін (TypeScript және Python) дайындаудың нақты қадамдары берілген, содан кейін барлығының жұмыс істейтініне көз жеткізу үшін жылдам тексерулер.
H3 — A. TypeScript / Түйінді орнату (ең жылдам жол)
- Жоба жасаңыз және SDK орнатыңыз:
mkdir mcp-demo && cd mcp-demo
npm init -y
npm install @modelcontextprotocol/sdk express zod
npm install --save-dev typescript tsx @types/node @types/express
- жасау
server.ts. (Біз толық мысалды «Қалай жылдам құрастыруға болады...» бөлімінде береміз.) - Іске қосу:
npx -y tsx server.ts
- көмегімен жергілікті түрде сынақтан өткізіңіз MCP инспекторы немесе Клод кодына қосыңыз:
npx @modelcontextprotocol/inspector
# or (for Claude Code)
claude mcp add --transport http my-server http://localhost:3000/mcp
(Инспектор және Клод пәрмендері табуды тексеруге және құралдарды шақыруға мүмкіндік береді.)
Claude Code үшін MCP серверін қалай тез құруға болады?
жылдам тексеру парағы
1.Серверді іске қосыңыз (ағынды HTTP ұсынылады): node server.ts or uvicorn server:app.
- Әзірлеуші құрылғыңыздан:
- пайдалану MCP инспекторы растау (
npx @modelcontextprotocol/inspector) және растаңызtools/listжәнеresources/list; немесе - Серверді Клод кодына қосыңыз:
claude mcp add --transport http <name> http://<host>:<port>/mcp(немесе клиент қашықтағы MCP-ді қолдаса, веб-UI ағындарын бақылаңыз).
Қашықтағы MCP үшін Anthropic's Messages API қосқышын пайдалануды жоспарласаңыз (бөлек клиент жоқ), Клод құжаттарын оқыңыз — бета тақырыбы қажет болуы мүмкін (нақты тақырып пен ағымдағы қолдау күйі үшін құжаттарды тексеріңіз).
Төменде Клод кодына (немесе MCP инспекторына) көшіруге, іске қосуға және қосылуға болатын екі толық, бірақ ықшам сервер мысалдары берілген. TypeScript мысалы Express + TypeScript SDK пайдаланады; Python мысалы FastAPI монтажын көрсетеді.
Ескерту: төмендегі код жалпыға қолжетімді SDK мысалдарына сәйкес келеді және түсінікті болу үшін әдейі минималды болып табылады. Өндіріс үшін SDK әдепкі параметрлерінен тыс аутентификацияны, журналды тіркеуді, жылдамдықты шектеуді және енгізуді тексеруді қосыңыз.
1-мысал: TypeScript + Express (ағынды HTTP)
жасау server.ts (толық):
// server.ts
import express from "express";
import * as z from "zod/v4";
import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
const server = new McpServer({ name: "claude-code-demo", version: "0.1.0" });
// Register a simple tool: add two numbers
server.registerTool(
"add",
{
title: "Add",
description: "Add two numbers a and b",
inputSchema: { a: z.number(), b: z.number() },
outputSchema: { result: z.number() }
},
async ({ a, b }) => {
const output = { result: a + b };
return {
content: ,
structuredContent: output
};
}
);
// Register a resource: greet user (dynamic)
server.registerResource(
"greeting",
new ResourceTemplate("greeting://{name}", { list: undefined }),
{ title: "Greeting", description: "Return a greeting for the name" },
async (uri, params) => {
return {
contents:
};
}
);
// Express + Streamable HTTP transport
const app = express();
app.use(express.json());
app.post("/mcp", async (req, res) => {
const transport = new StreamableHTTPServerTransport({ enableJsonResponse: true });
// Close transport when connection closes
res.on("close", () => transport.close());
await server.connect(transport);
await transport.handleRequest(req, res, req.body);
});
const port = parseInt(process.env.PORT || "3000", 10);
app.listen(port, () => console.log(`MCP server listening: http://localhost:${port}/mcp`));
Іске қосу:
npm install
npx -y tsx server.ts
Содан кейін Клод кодына қосылыңыз (мысал):
# Add the remote server to your Claude Code MCP list (local dev)
claude mcp add --transport http my-demo http://localhost:3000/mcp
Бұл мысал ресми TypeScript SDK Quick Start бағдарламасынан бейімделген және құралдар мен ресурстарды тіркеу жолын көрсетеді, содан кейін оларды Streamable HTTP арқылы көрсету.
2-мысал: Python + FastAPI (FastMCP + Streamable HTTP)
жасау server.py (толық):
# server.py
from fastapi import FastAPI
from mcp.server.fastmcp import FastMCP
app = FastAPI()
mcp = FastMCP("claude-python-demo", stateless_http=True)
# tool: simple sum
@mcp.tool()
def add(a: int, b: int) -> dict:
"""Add two integers"""
return {"result": a + b}
# resource: simple greeting resource template
@mcp.resource("greeting://{name}")
def greeting(name: str):
return {"contents": }
# mount the streamable-http MCP endpoint (FastMCP exposes an ASGI app)
app.mount("/mcp", mcp.streamable_http_app())
# optional endpoint to demonstrate other API routes
@app.get("/")
async def root():
return {"status": "OK"}
Іске қосу:
uvicorn server:app --reload --port 8000
Инспектормен байланысыңыз:
npx @modelcontextprotocol/inspector
# In Inspector select Streamable HTTP and enter http://localhost:8000/mcp
Python SDK мысалдары және FastMCP утилиталары тіркелуді жеңілдетеді @mcp.tool() және @mcp.resource() LLM тауып, шақыра алатын безендірілген функциялар.
Клод Код сіздің құралдарыңызды қалай атайды?
LLM құралды пайдалануды шешкенде, клиент MCP серверіне JSON-RPC шақыруын жібереді. Сервер сұралған құралды орындайды (мысалы, ДҚ сұрауы, сынақтарды іске қосу немесе сыртқы API шақыруы) және қайтарады құрылымдық мазмұн және ұсынылатын мазмұн. Содан кейін клиент (Клод коды) құрылымдық нәтижені үлгі контекстіне қоса алады, осылайша модель сервердің мәтіндік шығысымен ғана емес, сол сенімді деректермен пікірлесуді жалғастыра алады. TypeScript SDK тіркеуді қолдайды inputSchema және outputSchema (zod) сондықтан аргументтер мен шығыстар тексеріледі және машинада теріледі.
Қандай сынақ және жөндеу құралдарын пайдалану керек?
MCP инспекторы
The MCP инспекторы MCP серверлерін сынауға арналған ресми визуалды әзірлеуші құралы болып табылады. Ол серверге қосылуға (stdio, SSE немесе streamable-HTTP), құралдарды тізімдеуге, оларды қолмен шақыруға және JSON-RPC хабарларының өмірлік циклін тексеруге мүмкіндік береді — әзірлеу кезінде баға жетпес. арқылы бастаңыз npx @modelcontextprotocol/inspector.
Жергілікті және қашықтағы тестілеу
- Жергілікті (студио) — жұмыс үстелі қолданбаларына және офлайн күйін келтіруге арналған жылдам итерация циклі.
- Ағынды HTTP — Инспектормен сынақтан өтіңіз немесе арқылы Клод кодына қосылыңыз
claude mcp addҚашықтағы сынақтар үшін CLI немесе Messages API ішіндегі MCP қосқышы. Серверіңізге қажетті аутентификация тақырыптарын қамтамасыз етіңіз.
қорытынды
MCP қазіргі заманғы LLM-лер мен деректерді нақты сақтайтын және әрекеттерді орындайтын жүйелер арасындағы практикалық көпір болып табылады. Кодтық жұмыс үрдістері үшін Клод кодын MCP серверімен біріктіру үлгіге репозиторийлерге, CI-ге, ақауларды бақылаушыларға және реттелетін құралдарға құрылымдалған, тексерілетін қатынасты береді, бұл дәлірек автоматтандыруға және қауіпсіз жанама әсерлерге әкеледі. TypeScript және Python тілдеріндегі ресми SDK файлдары, қашықтан хостингке арналған ағынды HTTP және MCP инспекторы сияқты құралдардың көмегімен сіз бірнеше минут ішінде минималды сервер құра аласыз және өндірісті орналастыруға қарай қайталай аласыз.
Әзірлеушілер қол жеткізе алады Claude Sonnet 4.5 API және Claude Opus 4.1 API CometAPI арқылы және т.б. соңғы үлгі нұсқасы әрқашан ресми сайтпен жаңартылып отырады. Бастау үшін үлгінің мүмкіндіктерін зерттеңіз Ойын алаңы және кеңесіңіз API нұсқаулығы егжей-тегжейлі нұсқаулар үшін. Қол жеткізу алдында CometAPI жүйесіне кіріп, API кілтін алғаныңызға көз жеткізіңіз. CometAPI біріктіруге көмектесу үшін ресми бағадан әлдеқайда төмен баға ұсыныңыз.
Баруға дайынсыз ба?→ CometAPI-ге бүгін тіркеліңіз !
Егер сіз AI туралы көбірек кеңестер, нұсқаулықтар және жаңалықтар білгіңіз келсе, бізге жазылыңыз VK, X және Арасындағы айырмашылық!