Claude Code үшін MCP Server құру — практикалық, қадамдық нұсқаулық

CometAPI
AnnaNov 22, 2025
Claude Code үшін MCP Server құру — практикалық, қадамдық нұсқаулық

Model Context Protocol (MCP) — Anthropic-тің Claude сияқты үлгілеріне және Claude Code сияқты әзірлеуші құралдарына сыртқы құралдарды, дереккөздерді және промпттарды қауіпсіз, стандартты тәсілмен шақыруға мүмкіндік беретін ашық стандарт.

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

Model Context Protocol (MCP) деген не?

MCP (Model Context Protocol) — бұл тілдік модель клиенттері (мысалы, Claude, Claude Code немесе басқа LLM фронтендтері) құрал серверлері мен дереккөздеріне қалай қосылатынын стандарттауға арналған ашық спецификация. MCP-ті LLM-дер үшін “USB-C портындай” деп елестетіңіз: ол транспорт/JSON-RPC схемасын және серверлерге үш түрлі қабілеттілікті жариялаудың ортақ тәсілін анықтайды:

  • Resources — клиент оқи алатын файл іспетті немесе құжат деректері (мысалы, дерекқор жолы, мәтін файлы, JSON жүктемесі).
  • Tools — модель хосттан (пайдаланушы мақұлдауымен) орындауды сұрай алатын шақырылатын функциялар.
  • Prompts — модель/клиент шақыра алатын қайта пайдаланылатын промпт үлгілері немесе жұмыс процестері.

MCP бірнеше транспорттарды (stdio, HTTP, SSE) қолдайды және сұлбалар, SDK-лар мен мысал серверлерін ұсынады, сондықтан сізге сымдық форматты өзіңіз ойлап табудың қажеті жоқ. Протокол ашық түрде сүйемелденеді (спек + SDK-лар) және қабылдауды жеделдетуге арналған оқулықтар мен мысал серверлер галереясы бар.

MCP қалай архитектураланған?

MCP архитектурасы әдейі қарапайым және модульдік: негізгі бөліктер — MCP серверлері, MCP клиенттері, және олардың арасында JSON-RPC қапталған хабарламаларды тасымалдайтын транспорттар. Төменде Claude Code (немесе басқа MCP клиенттері) үшін сервер құру барысында әрекеттесетін негізгі компоненттер келтірілген.

Сервер, клиент және протокол

  • MCP сервері — құралдарды, ресурстарды және промпттарды жариялайтын сервис. Құралдар жанама әрекеттер орындай алады немесе дерек әкеле алады; ресурстар тек оқуға болатын мазмұн ұсынады; промпттар — клиент модельден үлгі алуды сұрай алатын қайта пайдаланылатын промпт үлгілері.
  • MCP клиенті (хост) — әдетте LLM хостының бір бөлігі (мысалы, Claude Code, VS Code плагині, браузер клиенті). Ол қолжетімді серверлерді табады, құрал сипаттамаларын модельге ұсынады және модель бастаған шақыруларды серверлерге бағдарлайды.
  • Протокол — Хабарламалар JSON-RPC ретінде кодталады; спецификация өмірлік цикл оқиғаларын, құралдарды анықтауды, шақыруды, комплишндер/үлгі алуды және құрылымдалған нәтижелердің клиент пен модельге қалай жеткізілетінін анықтайды.

Қарым-қатынас үлгісі (құрал қолданылған кезде не болады)

  1. Клиент пайдаланушы хабарының моделге жіберіледі.
  2. Модель контекстті талдап, MCP арқылы ашылған құралды (немесе бірнеше құралды) шақыруды шешеді.
  3. Клиент таңдалған транспорт арқылы құрал шақыруын MCP серверіне жібереді.
  4. Сервер құралды орындайды және нәтижелерді қайтарады.
  5. Модель құралдың шығысын алып, пайдаланушыға соңғы жауапты құрастырады.

Іске асыру примитивтері

  • JSON-RPC хабарламалары MCP сұлбасын ұстанады.
  • Құрал анықтамалары клиенттердің оларды UI-да көрсетуі үшін сервердің discovery жауаптарында жарияланады.
  • Ресурстар клиенттер тарапынан @source:path синтаксисі арқылы сілтенеді (мысалы, @postgres:...), бұл модельдерге үлкен деректерді промптқа ендірмей-ақ сыртқы мазмұнға сілтеме жасауға мүмкіндік береді.

Неге Claude Code-ты MCP серверлерімен интеграциялау керек?

Claude Code — Anthropic-тің кодқа және әзірлеушіге бағытталған жұмыс процестеріне (редактор/IDE интеграциясы, кодты түсіну және т.б.) арналған ұсынысы. Ішкі құралдарыңызды (source search, CI runner, ticket system, private registries) MCP серверлері арқылы жариялау Claude Code-қа оларды кодтау диалогтары мен агент ағындарының ішінде бірінші класты құралдар ретінде шақыруға мүмкіндік береді.

Claude Code-ты MCP серверлерімен интеграциялау кодтық агент үшін тәжірибеде пайдалы, өндірістік маңызы бар мүмкіндіктерді ашады:

1. Модельге нақты жүйелерде әрекет етуге мүмкіндік беру

Claude Code MCP серверінен ишью-трекерлерді сұрата алады, дерекқор сұрауларын орындайды, үлкен құжаттарды оқиды немесе GitHub PR-ларын жасайды — осылайша кодтау сессиясының ішінен ұршығы бір бүтін автоматтандыруды іске асырады. Бұл Claude Code құжаттарында ашық қолдау тапқан (мысалдар: Postgres, Sentry-ді сұрату немесе PR жасау).

2. Үлкен деректер мен мамандандырылған логиканы оффлоадтау

Әрбір дереккөзді промптқа ендірудің орнына (бұл токендерді тұтынады), сіз деректер мен құралдарды MCP арқылы жариялайсыз. Модель құралды шақырып, құрылымдалған жауап алады және сонымен жұмыс істейді — бұл токен тұтынуды азайтады және серверлерге ауыр жұмысты (DB сұраулар, ұзақ файл оқулар, аутентификация) тапсырады.

3. Қауіпсіздік және басқарушылық

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

4. Қайта пайдаланымдылық және экожүйе

MCP серверлері клиенттер мен командалар арасында қайта пайдалануға жарайды. Бір рет құрып, көптеген Claude/LLM клиенттері бір сервистерді пайдалана алады (немесе іске асыруларды алмастыра алады).

Бастамас бұрын не қажет?

Ең төменгі талаптар

  • Python 3.10+ орнатылған әзірлеу машинасы (мысал үшін Python қолданамыз). Балама ретінде Node / басқа тілдерді MCP SDK-лары қолдайды.
  • uv (Astral құралы) немесе MCP stdio серверлерін іске қосуға арналған баламалы раннер (MCP оқулығы uv қолданады). Орнату қадамдары төменде көрсетілген.
  • Claude Code орнатылған немесе серверіңізді тіркеу және сынау үшін Claude клиентіне (desktop немесе CLI) қолжетімділік; не болмаса кез келген MCP-ті қолдайтын клиент. Claude Code HTTP, SSE және жергілікті stdio серверлерін қолдайды.
  • Қауіпсіздік ескертпесі: Командалық немесе кәсіпорындық параметрлерде Claude Code-қа тек сенімді MCP серверлерін қосыңыз — MCP серверлерге сезімтал деректерге қол жеткізу береді және егер сервер зиянды мазмұн қайтаратын болса, промпт-инъекция қауіптері бар.

Claude Code CLI-ін қалай орнатып, тексеруге болады

Бұл — Claude Code Installation and Usage Guide.

1) Жылдам шолу — ұсынылатын орнату тәсілдері

Нативтік орнатқышты (ұсынылады) немесе macOS/Linux үшін Homebrew пайдаланыңыз. Қажет болса, NPM арқылы Node негізіндегі орнату бар. Windows үшін PowerShell / CMD орнатқыштары ұсынылады. Дереккөз: ресми Claude Code құжаттары және GitHub.

2) Алдын ала талаптар

  • macOS 10.15+, Ubuntu 20.04+/Debian 10+, немесе Windows 10+ (Windows-та WSL ұсынылады).
  • Node.js 18+ тек NPM арқылы орнату тәсілі үшін ғана қажет.

3) Орнату командалары (біреуін таңдаңыз)

Native (ұсынылады — Node тәуелділігі жоқ), 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 (егер Node негізіндегі глобал орнатуды қаласаңыз)：

# requires Node.js 18+

npm install -g @anthropic-ai/claude-code

sudo npm install -g қолданбаңыз — sudo арқылы глобал орнатудан сақтандырады (рұқсаттар/қауіпсіздік мәселелері). Егер рұқсат қателері туындаса, nvm пайдаланыңыз немесе npm global prefix-ті түзетіңіз, sudo қолданудың орнына.

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 немесе ~/.nvm/.../bin/claude), ал claude --version semver-ға ұқсас жолды шығарады. Құжаттар мен README екеуі де негізгі CLI entrypoint ретінде claude көрсетеді.

5) Орнатудың жарамдылығы мен конфигурациясын тексеру (ұсынылатын тексерулер)

a) claude doctor іске қосыңыз:

claude doctor

Бұл кіріктірілген диагностика орнату түрін, жиі кездесетін мәселелерді (мысалы, npm рұқсат қателері), ripgrep сияқты тәуелділіктерді тексереді және түзетулер ұсынады. Құжаттар орнатудан кейін claude doctor орындауды нақты ұсынады.

b) Смоук-тест орындау (интерактивті емес)

Жоба каталогыңыздан:

cd /path/to/your/project
claude -p "Explain this project in 3 sentences"

Бұл print режимін (-p) пайдаланады: бір промпт жіберіп, шығады; CI немесе жедел функционалдық тексерулер үшін ыңғайлы.

c) Аутентификацияны тексеру (CLI Anthropic-қа жете алатынына көз жеткізіңіз)

Claude Code бірнеше аутентификация ағымдарын қолдайды (Console OAuth, API ключ, провайдер интеграциялары). Жалпы тексерулер:

  1. Егер API key қолдансаңыз (CI / headless / жергілікті env var):
export ANTHROPIC_API_KEY="sk-..."
# then

claude auth status
claude auth whoami    # or `claude auth whoami` / `claude whoami` depending on version

Claude-тың API-ін пайдалану үшін CometAPI API ключін қолдануға болады, CometAPI арқылы Claude API-ін пайдалану сізге 20% жеңілдік береді.

  1. Егер консоль арқылы OAuth қолдансаңыз — орындаңыз:
claude auth status
claude auth whoami

Тіркелгі/жоспар ақпараты немесе аутентификациядан өткеніңіз туралы растау көрінуі тиіс.

Орта дайындаудың кезең-кезеңімен нұсқаулығы

Төменде екі кең таралған әзірлеуші стек үшін (TypeScript және Python) нақты қадамдар берілген, әрі бәрінің жұмыс істейтініне көз жеткізуге арналған жедел тексерулер ұсынылады.

H3 — A. TypeScript / Node орнату (ең жылдам жол)

  1. Жоба жасаңыз және 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
  1. server.ts жасаңыз. (Толық мысал “Қалай тез құруға болады…” бөлімінде берілген.)
  2. Жүргізіңіз:
npx -y tsx server.ts
  1. Жергілікті түрде MCP Inspector арқылы сынаңыз немесе Claude Code-қа қосыңыз:
npx @modelcontextprotocol/inspector
# or (for Claude Code)

claude mcp add --transport http my-server http://localhost:3000/mcp

(Inspector және Claude командалары discovery-ді тексеріп, құралдарды шақыруға мүмкіндік береді.)

Claude Code үшін MCP серверін қалай тез құруға болады?

жедел тізім

1.Серверіңізді іске қосыңыз (Streamable HTTP ұсынылады): node server.ts немесе uvicorn server:app.

  1. Өз әзірлеу машинаңыздан төмендегілердің бірін орындаңыз:
  • MCP Inspector арқылы тексеріңіз (npx @modelcontextprotocol/inspector) және tools/list пен resources/list расталғанына көз жеткізіңіз; немесе
  • Серверді Claude Code-қа қосыңыз: claude mcp add --transport http <name> http://<host>:<port>/mcp (немесе клиентіңіз қашықтағы MCP-ті қолдайтын болса, веб UI ағындарын ұстаныңыз).

Егер қашықтағы MCP үшін Anthropic-тің Messages API коннекторын пайдалануды жоспарласаңыз (бөлек клиентсіз), Claude құжаттарын оқыңыз — бета тақырып қажет болуы мүмкін (нақты тақырып пен ағымдағы қолдау күйін құжаттардан тексеріңіз).

Төменде Claude Code-қа (немесе MCP Inspector-ға) қосып, көшіріп, жүргізе алатын екі толық, бірақ ықшам сервер мысалы берілген. TypeScript мысалы Express + TypeScript SDK қолданады; Python мысалы FastAPI монтажын көрсетеді.

Ескерту: төмендегі код қоғамдық SDK мысалдарын ұстанады және анықтығы үшін әдейі минималды. Өндірістік орта үшін аутентификация, логинг, жылдамдық шектеу және SDK әдепкілерінен тыс енгізу валидациясын қосыңыз.

Мысал 1: TypeScript + Express (Streamable 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

Содан кейін Claude Code-қа қосыңыз (мысал):

# 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

Inspector арқылы қосылыңыз:

npx @modelcontextprotocol/inspector
# In Inspector select Streamable HTTP and enter http://localhost:8000/mcp

Python SDK мысалдары және FastMCP утилиталары LLM таба алатын және шақыра алатын @mcp.tool() және @mcp.resource() декораторлы функцияларды тіркеуді оңайлатады.

Claude Code сіздің құралдарыңызды нақты қалай шақырады?

LLM құралды қолдануды шешкенде, клиент MCP серверіне JSON-RPC шақыруын жібереді. Сервер сұралған құралды орындайды (мысалы, DB-ді сұратады, тесттерді жүргізеді немесе сыртқы API-ді шақырады) және құрылымдалған мазмұнды және көрсетілетін мазмұнды қайтарады. Клиент (Claude Code) содан кейін модельдің контекстіне құрылымдалған шығысты қосып, модельдің тек сервердің мәтіндік шығысына емес, сенімді деректерге сүйеніп пайымдауын жалғастыруына мүмкіндік береді. TypeScript SDK inputSchema және outputSchema (zod) тіркеуді қолдайды, сондықтан аргументтер мен нәтижелер валидацияланады және машина деңгейінде типтеледі.

Қандай тестілеу және жөндеу құралдарын қолдану керек?

MCP Inspector

MCP Inspector — MCP серверлерін тестілеуге арналған ресми визуалды әзірлеуші құралы. Ол серверге қосылуға (stdio, SSE немесе streamable-HTTP), құралдарды тізімдеуге, оларды қолмен шақыруға және JSON-RPC хабарламаларының өмірлік циклін инспекциялауға мүмкіндік береді — әзірлеу кезінде өте құнды. Оны npx @modelcontextprotocol/inspector арқылы іске қосыңыз.

Жергілікті және қашықтағы тестілеу

  • Жергілікті (stdio) — desktop қолданбалары және офлайн жөндеу үшін жедел итерация.
  • Streamable HTTP — Inspector арқылы тестілеп көріңіз немесе claude mcp add CLI көмегімен немесе Messages API-дегі MCP коннекторын пайдаланып Claude Code-қа қосыңыз. Серверіңіз талап ететін кез келген аутентификация тақырыптарын беруді ұмытпаңыз.

Қорытынды

MCP — қазіргі LLM-дер мен деректерді шынымен ұстайтын және әрекеттер орындайтын жүйелер арасындағы практикалық көпір. Кодтық жұмыс процестері үшін MCP серверімен Claude Code-ты интеграциялау модельге репозиторийлерге, CI-ға, ишью-трекерлерге және арнайы құралдарға құрылымдалған, аудитке жарамды қолжетімділік береді — нәтижесінде анағұрлым дәл автоматтандыру және қауіпсіз жанама әрекеттерге қол жеткізіледі. TypeScript және Python бойынша ресми SDK-лармен, қашықтан хостингке арналған Streamable HTTP-мен және MCP Inspector сияқты құралдармен сіз бірнеше минут ішінде минималды сервер құрып, өндірістік деплойға қарай итерация жасай аласыз.

Әзірлеушілер Claude Sonnet 4.5 API және Claude Opus 4.1 API т.б. CometAPI арқылы қол жеткізе алады, соңғы модель нұсқасы ресми сайтпен бірге әрдайым жаңартылып отырады. Бастау үшін, модель мүмкіндіктерін Playground ішінде зерттеңіз және егжей-тегжейлі нұсқаулар үшін API guide құжатын қараңыз. Қол жеткізбестен бұрын CometAPI-ге кіргеніңізге және API ключ алғаныңызға көз жеткізіңіз. CometAPI интеграциялауыңызға көмектесу үшін ресми бағадан әлдеқайда төмен баға ұсынады.

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

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

AI әзірлеу шығындарын 20%-ға қысқартуға дайынсыз ба?

Минуттар ішінде тегін бастаңыз. Тегін сынақ кредиттері қосылған. Банк картасы талап етілмейді.

Толығырақ оқу