Model Bağlam Protokolü (MCP), Anthropic'inki gibi modellerin açık bir standarttır. Claude ve geliştirici araçları gibi Claude Kodu Harici araçlara, veri kaynaklarına ve istemlere güvenli ve standart bir şekilde çağrı yapın.
Bu kılavuz, sıfırdan kendi MCP sunucunuzu oluşturmanıza yardımcı olacak ve Claude Code'un özel özelliklere erişmesini ve böylece işlevselliğini yerleşik özelliklerinin çok ötesine genişletmesini sağlayacaktır.
Model Bağlam Protokolü (MCP) nedir?
MCP (Model Bağlam Protokolü) bir açık şartname Dil modeli istemcilerinin (Claude, Claude Code veya diğer LLM ön uçları gibi) araç sunucularına ve veri kaynaklarına nasıl bağlanacağını standartlaştırmak için tasarlanmıştır. MCP'yi "LLM'ler için bir USB-C bağlantı noktası" olarak düşünün: bir taşıma/JSON-RPC şeması ve sunucuların üç tür yeteneği yayınlaması için ortak bir yol tanımlar:
- Kaynaklar — istemcinin okuyabileceği dosya benzeri veya belge verileri (örneğin, bir veritabanı satırı, bir metin dosyası, bir JSON yükü).
- Tools — modelin ana bilgisayardan (kullanıcı onayıyla) yürütmesini isteyebileceği çağrılabilir işlevler.
- istemleri — modelin/müşterinin çağırabileceği yeniden kullanılabilir istem şablonları veya iş akışları.
MCP, birden fazla aktarımı (stdio, HTTP, SSE) destekler ve şema, SDK'lar ve örnek sunucular sunar, böylece kablo formatını kendiniz icat etmenize gerek kalmaz. Protokol, herkese açık olarak (spec + SDK'lar) yönetilir ve benimsenmeyi hızlandırmak için eğitimler ve örnek sunuculardan oluşan bir galeri içerir.
MCP nasıl tasarlanıyor?
MCP'nin mimarisi özellikle basit ve modülerdir: temel parçalar MCP'dir sunucular, MCP istemciler, ve taşımaları Aralarında JSON-RPC çerçeveli mesajlar taşıyan. Claude Code (veya diğer MCP istemcileri) için bir sunucu oluştururken etkileşim kuracağınız temel bileşenler aşağıdadır.
Sunucu, istemci ve protokol
- MCP sunucusu — Bir hizmet yayınlar Araçlar, kaynaklar ve istemler. Araçlar yan etkiler gerçekleştirebilir veya veri getirebilir; kaynaklar salt okunur içerikleri yüzeye çıkarır; istemler, istemcinin modelden örnek almasını isteyebileceği yeniden kullanılabilir istem şablonlarıdır.
- MCP istemcisi (ana bilgisayar) — Genellikle LLM ana bilgisayarının bir parçasıdır (örneğin, Claude Code, VS Code eklentisi, bir tarayıcı istemcisi). Kullanılabilir sunucuları keşfeder, araç açıklamalarını modele sunar ve model tarafından başlatılan çağrıları sunuculara yönlendirir.
- Protokol — Mesajlar JSON-RPC olarak kodlanır; şartname, yaşam döngüsü olaylarını, araç keşfini, çağrıyı, tamamlamaları/örneklemeyi ve yapılandırılmış sonuçların istemciye ve modele nasıl geri taşınacağını tanımlar.
İletişim örüntüsü (bir araç kullanıldığında ne olur)
- İstemci kullanıcı mesajını modele gönderir.
- Model bağlamı analiz eder ve MCP tarafından açığa çıkarılan bir aracı (veya birden fazla aracı) çağırmaya karar verir.
- İstemci, araç çağrısını seçilen taşıma üzerinden MCP sunucusuna iletir.
- Sunucu aracı çalıştırır ve sonuçları döndürür.
- Model araç çıktısını alır ve kullanıcıya nihai cevabı oluşturur.
Uygulama ilkel öğeleri
- JSON-RPC mesajlar MCP şemasını takip eder.
- Araç tanımları Sunucunun keşif yanıtlarında yayınlanır, böylece istemciler bunları kullanıcı arayüzünde sunabilir.
- Kaynaklar tarafından referans alınmıştır
@source:pathistemcilere göre sözdizimi (örneğin,@postgres:...), büyük verileri komut istemine yerleştirmeden modellerin harici içeriğe başvurmasına izin verir.
Claude Code'u MCP sunucularına neden entegre etmeliyiz?
Claude Code, Anthropic'in kod ve geliştirici merkezli iş akışlarına (editör/IDE entegrasyonu, kod anlayışı vb.) odaklanan bir teklifidir. Dahili araçlarınızı (kaynak arama, CI çalıştırıcısı, bilet sistemi, özel kayıtlar) MCP sunucuları aracılığıyla açığa çıkarmak, Claude Code'un bunları şu şekilde adlandırmasını sağlar: birinci sınıf araçlar kodlama konuşmaları ve ajan akışlarının içinde.
Claude Code'un MCP sunucularıyla entegre edilmesi, bir kodlama aracısı için pratik, üretimle ilgili yeteneklerin kilidini açar:
1. Modelin hareket gerçek sistemlerde
Claude Code, bir MCP sunucusundan sorun izleyicileri sorgulamasını, veritabanı sorguları çalıştırmasını, büyük belgeleri okumasını veya GitHub PR'leri oluşturmasını isteyebilir; böylece kodlama oturumu içinden uçtan uca otomasyon sağlanır. Bu, Claude Code belgeleri tarafından açıkça desteklenir (örnekler: Postgres, Sentry sorgulama veya PR oluşturma).
2. Büyük verileri ve özel mantığı boşaltın
Her veri kaynağını komut istemine (token tüketen) yerleştirmek yerine, verileri ve araçları MCP aracılığıyla yayınlarsınız. Model aracı çağırır, yapılandırılmış bir yanıt alır ve bununla mantık yürütür; bu, token kullanımını azaltır ve sunucuların yoğun işleri (veritabanı sorguları, uzun dosya okumaları, kimlik doğrulama) yönetmesini sağlar.
3. Güvenlik ve yönetişim
MCP, erişim kontrolünü ve denetimi sunucu katmanında merkezileştirerek kuruluşların onaylı sunucuları beyaz listeye eklemesine, hangi araçların mevcut olduğunu kontrol etmesine ve çıktıları sınırlamasına olanak tanır. Claude Code ayrıca kurumsal MCP yapılandırmasını ve kapsam başına onayı da destekler.
4. Yeniden kullanılabilirlik ve ekosistem
MCP sunucuları, istemciler ve ekipler arasında yeniden kullanılabilir. Bir kez derlendiğinde, birçok Claude/LLM istemcisi aynı hizmetleri (veya takas uygulamalarını) kullanabilir.
Başlamadan önce neye ihtiyacınız var?
Minimum Gereksinimler
- Bir geliştirme makinesi piton 3.10+ (Örnekte Python kullanacağız). Alternatif olarak Node / diğer diller MCP SDK'ları tarafından desteklenmektedir.
uv(Astral'ın aracı) veya MCP stdio sunucularını çalıştırmak için eşdeğer çalıştırıcı (MCP eğitimi şunları kullanır:uv). Kurulum adımları aşağıda gösterilmiştir.- Sunucunuzu kaydetmek ve test etmek için Claude Code'u yükleyin veya Claude istemcisine (masaüstü veya CLI) erişin; veya herhangi bir MCP uyumlu istemci. Claude Code, HTTP, SSE ve yerel stdio sunucularını destekler.
- Güvenlik notu: Claude Code'a ekip veya kurumsal ortamlarda yalnızca güvenilir MCP sunucuları ekleyin — MCP, sunuculara hassas verilere erişim sağlar ve bir sunucu kötü amaçlı içerik döndürürse anında enjeksiyon riskleri ortaya çıkar.
Claude Code CLI nasıl kurulur ve doğrulanır
Bu Claude Code Kurulum ve Kullanım Kılavuzu.
1) Hızlı özet — önerilen kurulum yöntemleri
Kullan yerel yükleyici (önerilir) veya macOS/Linux'ta Homebrew. Node tabanlı bir kuruluma ihtiyacınız varsa NPM mevcuttur. Windows, PowerShell/CMD yükleyicilerini kullanır. Kaynak: resmi Claude Code belgeleri ve GitHub.
2) Önkoşullar
- macOS 10.15+, Ubuntu 20.04+/Debian 10+ veya Windows 10+ (Windows'ta WSL önerilir).
- Node.js 18+ sadece gerekli NPM kurulum yöntemi için.
3) Kurulum komutları (birini seçin)
Yerel (önerilir — Node bağımlılığı yok), 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
(Bunlar resmi yerel yükleyici betikleridir).
NPM (Node tabanlı global kurulum istiyorsanız):
# requires Node.js 18+
npm install -g @anthropic-ai/claude-code
Yapma kullanım sudo npm install -g — sudo global kurulumlarına karşı uyarı (izin/güvenlik sorunları). İzin hatalarıyla karşılaşırsanız, şunu kullanın: nvm veya sudo kullanmak yerine npm global önekinizi düzeltin.
4) İkilinin yüklendiğini doğrulayın (temel kontroller)
Kurulumdan hemen sonra bunları yerel olarak çalıştırın:
# is the command on PATH?
which claude
# version (or -v)
claude --version
# or
claude -v
# help (sanity check)
claude --help
Beklenen: which bir yol gösterir (örneğin /usr/local/bin/claude or ~/.nvm/.../bin/claude) Ve claude --version Semver benzeri bir dize yazdırır. Hem belgeler hem de README dosyası şunu gösterir: claude birincil CLI giriş noktası olarak.
5) Kurulum sağlığını ve yapılandırmasını doğrulayın (önerilen kontroller)
a) claude doctor,Koşmak:
claude doctor
Bu yerleşik tanılama, kurulum türünüzü, yaygın sorunları (npm izin sorunları gibi), bağımlılıkları kontrol eder. ripgrepve düzeltmeler önerir. Belgeler açıkça şunu çalıştırmayı önerir: claude doctor yükledikten sonra.
b) Bir duman testi çalıştırın (etkileşimli değil)
Proje dizininizden:
cd /path/to/your/project
claude -p "Explain this project in 3 sentences"
Bu kullanır baskı mod (-p) tek bir komut gönderip çıkmak; CI veya hızlı fonksiyonel kontroller için iyi.
c) Kimlik doğrulaması (CLI'nin Anthropic'e erişebildiğinden emin olun)
Claude Code, çeşitli kimlik doğrulama akışlarını (Konsol OAuth, API anahtarı, sağlayıcı entegrasyonları) destekler. Yaygın kontroller:
- Bir API anahtarı (CI / başsız / yerel ortam değişkeni) kullanılıyorsa:
export ANTHROPIC_API_KEY="sk-..."
# then
claude auth status
claude auth whoami # or `claude auth whoami` / `claude whoami` depending on version
Sen kullanabilirsiniz Kuyrukluyıldız API'siClaude Kodunu kullanmak için 'nin API anahtarını kullanın, CometAPI aracılığıyla Claude'nin API'sini kullanmak size %20 indirim kazandıracaktır.
- Konsol aracılığıyla OAuth kullandıysanız - koşmak:
claude auth status
claude auth whoami
Hesap/plan bilgilerini veya kimliğinizin doğrulandığına dair bir onayı görmelisiniz.
Adım adım ortam hazırlığı
Aşağıda, iki yaygın geliştirici yığınını (TypeScript ve Python) hazırlamak için somut adımlar ve ardından her şeyin çalıştığından emin olmak için hızlı kontroller yer almaktadır.
H3 — A. TypeScript / Node kurulumu (en hızlı yol)
- Projeyi oluşturun ve SDK'yı yükleyin:
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
- Oluştur
server.ts(Bunun tam bir örneğini “Hızlı Bir Şekilde Nasıl Oluşturulur…” bölümünde bulabilirsiniz.) - Koşmak:
npx -y tsx server.ts
- Yerel olarak test edin MCP Müfettişi veya Claude Koduna ekleyin:
npx @modelcontextprotocol/inspector
# or (for Claude Code)
claude mcp add --transport http my-server http://localhost:3000/mcp
(Inspector ve Claude komutları keşfi doğrulamanıza ve araçları çağırmanıza olanak tanır.)
Claude Code için hızlı bir şekilde MCP sunucusu nasıl oluşturulur?
hızlı kontrol listesi
1.Sunucunuzu başlatın (Streamable HTTP önerilir): node server.ts or uvicorn server:app.
- Geliştirme makinenizden:
- Kullanım MCP Müfettişi doğrulamak için (
npx @modelcontextprotocol/inspector) ve onaylayıntools/listveresources/listYa da - Sunucuyu Claude Koduna ekleyin:
claude mcp add --transport http <name> http://<host>:<port>/mcp(veya istemciniz uzak MCP'yi destekliyorsa web kullanıcı arayüzü akışlarını takip edin).
Uzak MCP için Anthropic'in Mesajlar API bağlayıcısını kullanmayı planlıyorsanız (ayrı bir istemci olmadan), Claude belgelerini okuyun; bir beta başlığı gerekebilir (tam başlık ve mevcut destek durumu için belgeleri kontrol edin).
Aşağıda, kopyalayıp çalıştırabileceğiniz ve Claude Code'a (veya MCP Inspector'a) bağlayabileceğiniz iki eksiksiz ancak kompakt sunucu örneği bulunmaktadır. TypeScript örneği Express + TypeScript SDK'sını kullanır; Python örneği ise FastAPI bağlamayı gösterir.
Not: Aşağıdaki kod, genel SDK örneklerini takip eder ve anlaşılırlık açısından özellikle minimaldir. Üretim için, SDK varsayılanlarının ötesinde kimlik doğrulama, günlük kaydı, hız sınırlama ve giriş doğrulaması ekleyin.
Örnek 1: TypeScript + Express (Akışlı HTTP)
Oluştur server.ts (tamamlamak):
// 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`));
Koşmak:
npm install
npx -y tsx server.ts
Daha sonra Claude Kodu'na bağlanın (örnek):
# Add the remote server to your Claude Code MCP list (local dev)
claude mcp add --transport http my-demo http://localhost:3000/mcp
Bu örnek, resmi TypeScript SDK Hızlı Başlangıç'tan uyarlanmıştır ve araçların ve kaynakların nasıl kaydedileceğini ve ardından bunların Streamable HTTP üzerinden nasıl kullanıma sunulacağını gösterir.
Örnek 2: Python + FastAPI (FastMCP + Streamable HTTP)
Oluştur server.py (tamamlamak):
# 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"}
Koşmak:
uvicorn server:app --reload --port 8000
Müfettişle iletişime geçin:
npx @modelcontextprotocol/inspector
# In Inspector select Streamable HTTP and enter http://localhost:8000/mcp
Python SDK örnekleri ve FastMCP yardımcı programları kaydolmayı kolaylaştırır @mcp.tool() ve @mcp.resource() LLM'nin keşfedebileceği ve çağırabileceği süslü işlevler.
Claude Code aletlerinizi nasıl adlandırıyor?
Bir LLM bir aracı kullanmaya karar verdiğinde, istemci MCP sunucusuna bir JSON-RPC çağrısı gönderir. Sunucu, istenen aracı çalıştırır (örneğin, bir veritabanını sorgular, testler çalıştırır veya harici bir API çağırır) ve döndürür. yapılandırılmış içerik ve sunulabilir içerikİstemci (Claude Code) daha sonra yapılandırılmış çıktıyı modelin bağlamına dahil edebilir, böylece model yalnızca sunucunun metinsel çıktısıyla değil, bu güvenilir verilerle de akıl yürütmeye devam edebilir. TypeScript SDK, kayıt işlemini destekler. inputSchema ve outputSchema (zod) böylece argümanlar ve çıktılar doğrulanır ve makine tarafından yazılır.
Hangi test ve hata ayıklama araçlarını kullanmalısınız?
MCP Müfettişi
The MCP Müfettişi MCP sunucularını test etmek için resmi görsel geliştirici aracıdır. Bir sunucuya (stdio, SSE veya streamable-HTTP) bağlanmanıza, araçları listelemenize, bunları manuel olarak çağırmanıza ve geliştirme sırasında paha biçilmez bir değer olan JSON-RPC mesajlarının yaşam döngüsünü incelemenize olanak tanır. npx @modelcontextprotocol/inspector.
Yerel ve Uzaktan test
- Yerel (stdio) — Masaüstü uygulamaları ve çevrimdışı hata ayıklama için hızlı yineleme döngüsü.
- Akışlı HTTP — Denetçi ile test edin veya Claude Koduna bağlanın
claude mcp addUzaktan testler için Mesajlar API'sindeki CLI veya MCP bağlayıcısını kullanın. Sunucunuz için gerekli tüm kimlik doğrulama başlıklarını sağladığınızdan emin olun.
Sonuç
MCP, modern LLM'ler ile verileri tutan ve eylemleri gerçekleştiren sistemler arasında pratik bir köprüdür. Kod iş akışları için, Claude Code'u bir MCP sunucusuyla entegre etmek, modele depolara, CI'ye, sorun izleyicilere ve özel araçlara yapılandırılmış ve denetlenebilir erişim sağlayarak daha hassas otomasyon ve daha güvenli yan etkiler sağlar. TypeScript ve Python'daki resmi SDK'lar, uzaktan barındırma için Streamable HTTP ve MCP Inspector gibi araçlarla, dakikalar içinde minimal bir sunucu oluşturabilir ve üretim dağıtımına doğru ilerleyebilirsiniz.
Geliştiriciler erişebilir Claude Sone 4.5 API ve Claude Opus 4.1 API vb. CometAPI aracılığıyla, en son model versiyonu Resmi web sitesi aracılığıyla sürekli güncellenmektedir. Başlamak için, modelin yeteneklerini keşfedin. Oyun Alanı ve danışın API kılavuzu Ayrıntılı talimatlar için. Erişimden önce, lütfen CometAPI'ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. Kuyrukluyıldız API'si Entegrasyonunuza yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat teklif ediyoruz.
Gitmeye hazır mısınız?→ Bugün CometAPI'ye kaydolun !
Yapay zeka hakkında daha fazla ipucu, kılavuz ve haber öğrenmek istiyorsanız bizi takip edin VK, X ve Katılın!