Model Context Protocol (MCP) Nedir? Kurulum ve Kullanım Rehberi (2026)

MCP Nedir? (What is Model Context Protocol?)

Model Context Protocol, kısaca MCP, Anthropic tarafından Kasım 2024'te açık kaynaklı olarak tanıtılan bir iletişim protokolüdür. Peki tam olarak ne işe yarıyor? En basit tanımıyla MCP, yapay zeka uygulamalarını dış veri kaynaklarına ve araçlara bağlamanın standart yoludur. Bunu şöyle düşünebilirsiniz: nasıl USB-C kablosu farklı cihazları tek bir standart üzerinden birbirine bağlıyorsa, MCP de AI modellerini farklı sistemlere aynı şekilde bağlıyor. Yani MCP, adeta "AI dünyasının USB-C'si" olarak nitelendiriliyor.

Alesta Web olarak bu teknolojiyi yakından takip ediyoruz çünkü MCP, AI entegrasyonlarının (AI integration) geleceğini şekillendiriyor. Geleneksel yöntemde her AI uygulaması için ayrı ayrı API bağlantıları kurmak gerekiyordu. Her platform, her araç, her veritabanı için farklı bir entegrasyon kodu yazmak zorundaydınız. MCP bu karmaşıklığı ortadan kaldırıyor ve tek bir protokol üzerinden tüm bu bağlantıları yönetmenizi sağlıyor.

Protokol, JSON-RPC 2.0 standardı üzerine inşa edilmiş durumda. Bu da demek oluyor ki endüstride zaten kabul görmüş, olgun bir mesajlaşma formatını kullanıyor. Geliştiriciler için tanıdık bir yapı, öğrenme eğrisi düşük ve mevcut altyapılarla uyumlu. ?

MCP Neden Gerekli? (Why Do We Need MCP?)

Şimdi gelelim asıl konuya: MCP olmadan önce durum nasıldı? Her AI model sağlayıcısının kendi API yapısı, kendi bağlantı yöntemi, kendi veri formatı vardı. Bir AI uygulamasını GitHub'a bağlamak istiyorsanız bir kod yazıyordunuz, aynı uygulamayı Slack'e bağlamak istediğinizde bambaşka bir kod yazmanız gerekiyordu. Bu durum, geliştirme sürecini hem yavaşlatıyor hem de bakım maliyetlerini artırıyordu.

Alesta Web ekibi olarak müşterilerimize AI çözümleri sunarken bu sorunu defalarca yaşadık. MCP ile birlikte artık tek bir standart üzerinden istediğiniz kadar servise bağlanabiliyorsunuz. Bir MCP sunucusu (MCP server) yazıyorsunuz ve bu sunucu, MCP destekleyen tüm AI uygulamalarıyla otomatik olarak uyumlu çalışıyor.

Aralık 2025'te önemli bir gelişme yaşandı: Anthropic, MCP'yi Linux Foundation bünyesindeki Agentic AI Foundation'a bağışladı. Bu adım, protokolün tek bir şirkete bağımlı olmadan, topluluk tarafından yönetilen gerçek bir açık standart haline gelmesini sağladı. Google, Microsoft, Amazon gibi devler de bu vakfın üyeleri arasında yer alıyor.

MCP Mimarisi (MCP Architecture)

MCP'nin mimarisi üç temel katmandan oluşuyor. Bu yapıyı anlamak, protokolü etkili kullanmanın anahtarıdır. Alesta Web olarak projelerimizde bu mimariyi uyguladığımızda ne kadar temiz ve ölçeklenebilir bir yapı ortaya çıktığını gördük.

1. MCP Host (Ana Uygulama)

MCP Host, kullanıcının doğrudan etkileşim kurduğu uygulamadır. Claude Desktop, VS Code, ChatGPT gibi uygulamalar birer MCP Host örneğidir. Host, bir veya birden fazla MCP Client barındırır ve bunlar aracılığıyla dış dünyayla iletişim kurar.

2. MCP Client (İstemci)

MCP Client, Host içinde çalışan ve MCP Server ile birebir bağlantı kuran bileşendir. Her client, tek bir server ile iletişim kurar. Client, protokolün JSON-RPC 2.0 mesajlaşma formatını yöneterek Host ile Server arasında köprü görevi görür.

3. MCP Server (Sunucu)

MCP Server, dış dünyaya açılan kapıdır. Veritabanları, API'ler, dosya sistemleri, web servisleri — ne ile bağlantı kurmak istiyorsanız bunun için bir MCP server yazarsınız veya hazır olanlardan birini kullanırsınız. Her server, belirli yetenekleri (capabilities) açığa çıkarır ve bunları standart MCP protokolü üzerinden sunar.

MCP Host (Claude Desktop, VS Code, vb.)
  │
  ├── MCP Client 1 ──── MCP Server A (GitHub)
  │                        └── JSON-RPC 2.0
  ├── MCP Client 2 ──── MCP Server B (PostgreSQL)
  │                        └── JSON-RPC 2.0
  └── MCP Client 3 ──── MCP Server C (Slack)
                           └── JSON-RPC 2.0

Taşınım Modları (Transport Modes)

MCP iki farklı taşınım (transport) modu destekliyor:

stdio (Standard Input/Output): Yerel çalışan sunucular için idealdir. MCP host, sunucuyu bir alt süreç (subprocess) olarak başlatır ve stdin/stdout üzerinden iletişim kurar. Geliştirme aşamasında ve yerel araçlar için en yaygın tercih budur.

SSE (Server-Sent Events): Uzak sunucular için kullanılır. HTTP tabanlı bu mod, sunucunun farklı bir makinede veya bulutta çalışmasına olanak tanır. Kurumsal ortamlarda ve paylaşılan MCP sunucuları için SSE modu önerilir.

6 Temel MCP Özelliği (Core MCP Features)

MCP protokolü altı temel özellik (primitive) sunuyor. Her biri farklı bir ihtiyacı karşılamak üzere tasarlanmış. Alesta Web olarak deneyimlerimize göre bu özellikleri iyi anlamak, MCP'den maksimum verim almanın temelidir.

1. Tools (Araçlar) ?

Tools, MCP'nin en temel ve en çok kullanılan özelliğidir. Sunucunun dış dünyada eylem gerçekleştirmesini sağlar. Bir API çağrısı yapmak, veritabanına sorgu göndermek, dosya oluşturmak — bunların hepsi Tools üzerinden yapılır. AI modeli, mevcut araçları keşfeder ve gerektiğinde bunları çağırır.

2. Resources (Kaynaklar) ?

Resources, sunucunun yapılandırılmış veri sağlamasını mümkün kılar. Dosya içerikleri, veritabanı kayıtları, API yanıtları gibi verileri AI modeline sunmanın standart yoludur. Resources salt okunur yapıdadır ve herhangi bir yan etki (side effect) oluşturmaz.

3. Prompts (İstemler) ?

Prompts, sunucunun önceden tanımlanmış prompt şablonları sunmasını sağlar. Belirli görevler için optimize edilmiş, yeniden kullanılabilir prompt yapıları oluşturabilirsiniz. Örneğin bir kod inceleme (code review) promptu veya bir hata analiz promptu tanımlayabilirsiniz.

4. Sampling (Örnekleme) ?

Sampling, sunucunun AI modelinden tamamlama (completion) talep etmesine olanak tanır. Bu özellik sayesinde sunucu, kendi mantığı içinde AI modelini kullanabilir. Agentic (otonom) iş akışlarında kritik bir rol oynar.

5. Roots (Kökler) ?

Roots, istemcinin sunucuya hangi kaynaklar üzerinde çalışması gerektiğini bildirmesini sağlar. Örneğin bir dosya sistemi sunucusuna sadece belirli dizinlere erişim yetkisi vermek için Roots kullanılır.

6. Elicitation (Bilgi Çıkarma) ?

Elicitation, sunucunun kullanıcıdan ek bilgi talep etmesini mümkün kılar. İşlem sırasında eksik bir parametre varsa veya onay gerekiyorsa, sunucu bu özellik aracılığıyla kullanıcıyla etkileşime geçebilir.

TypeScript ile MCP Kurulumu (TypeScript MCP Setup)

Şimdi gelelim pratiğe! TypeScript ile bir MCP sunucusu kurmak oldukça basit. Alesta Web ekibi olarak TypeScript'i MCP geliştirmelerinde sıklıkla tercih ediyoruz çünkü tip güvenliği (type safety) ve geniş ekosistem büyük avantaj sağlıyor.

# MCP TypeScript SDK'yı yükleyin
npm install @modelcontextprotocol/sdk

# Veya yarn ile
yarn add @modelcontextprotocol/sdk

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

// Yeni bir MCP server oluştur
const server = new McpServer({
  name: "alesta-mcp-server",
  version: "1.0.0",
  description: "Alesta Web MCP Sunucusu"
});

// Bir tool (araç) tanımla
server.tool(
  "merhaba-de",
  "Kullanıcıya merhaba der",
  { isim: z.string().describe("Kullanıcının adı") },
  async ({ isim }) => ({
    content: [{ type: "text", text: `Merhaba ${isim}! ?` }]
  })
);

// Resource (kaynak) tanımla
server.resource(
  "bilgi",
  "alesta://bilgi",
  async (uri) => ({
    contents: [{
      uri: uri.href,
      mimeType: "text/plain",
      text: "Alesta Web MCP Sunucusu aktif!"
    }]
  })
);

// Sunucuyu başlat
const transport = new StdioServerTransport();
await server.connect(transport);

Python ile MCP Kurulumu (Python MCP Setup)

Python geliştiricileri için MCP kurulumu da son derece kolay. Python SDK, FastMCP adlı üst düzey (high-level) bir API sunuyor ve birkaç satır kodla tam işlevsel bir MCP sunucusu oluşturabiliyorsunuz.

# MCP ve Anthropic SDK'larını yükleyin
pip install mcp anthropic

# Veya uv ile (önerilen)
uv add mcp anthropic

from mcp.server.fastmcp import FastMCP

# MCP sunucusu oluştur
mcp = FastMCP("alesta-python-server")

# Tool tanımla
@mcp.tool()
def hava_durumu(sehir: str) -> str:
    """Belirtilen şehrin hava durumunu getirir."""
    # Gerçek uygulamada bir API çağrısı yapılır
    return f"{sehir} için hava durumu: 22°C, güneşli ☀️"

# Resource tanımla
@mcp.resource("alesta://durum")
def sunucu_durumu() -> str:
    """Sunucu durum bilgisini döner."""
    return "Alesta Web MCP Sunucusu çalışıyor!"

# Prompt tanımla
@mcp.prompt()
def analiz_promptu(konu: str) -> str:
    """Analiz için hazır prompt şablonu."""
    return f"Lütfen şu konuyu detaylı analiz et: {konu}"

# Sunucuyu başlat
if __name__ == "__main__":
    mcp.run(transport="stdio")

MCP Destekleyen Platformlar (Platforms Supporting MCP)

MCP'nin en güçlü yanlarından biri geniş platform desteğidir. 2026 itibarıyla sektörün en büyük AI platformları MCP'yi destekliyor. Bu, yazdığınız herhangi bir MCP sunucusunun tüm bu platformlarda çalışabileceği anlamına geliyor — gerçekten güçlü bir durum! ?

İşte MCP protocol desteği sunan başlıca platformlar:

• Claude Desktop: Anthropic'in masaüstü uygulaması, MCP'nin doğal evidir. En kapsamlı MCP desteğini sunar.
• Claude Code: Anthropic'in CLI aracı, geliştirme ortamında MCP sunucularını doğrudan kullanır.
• ChatGPT: OpenAI de MCP desteğini entegre etti, bu da protokolün evrenselliğini kanıtlıyor.
• VS Code: Microsoft'un popüler editörü, Copilot ile birlikte MCP sunucularını destekliyor.
• Cursor: AI-native kod editörü, MCP'yi derinden entegre etmiş durumda.
• Windsurf: Codeium'un AI editörü, tam MCP desteği sunuyor.
• Google Gemini: Google'ın AI platformu da MCP'ye katıldı.

Önemli MCP Sunucuları (Popular MCP Servers)

MCP ekosisteminde binlerce hazır sunucu bulunuyor. Bunları sıfırdan yazmak yerine hemen kullanmaya başlayabilirsiniz. Deneyimlerimize göre en çok kullanılan ve en işlevsel MCP sunucuları şunlar:

• Filesystem Server: Yerel dosya sistemi ile etkileşim. Dosya okuma, yazma, dizin listeleme gibi işlemler.
• GitHub Server: Repository yönetimi, issue takibi, pull request işlemleri, kod arama.
• PostgreSQL Server: Veritabanı sorguları, şema keşfi, tablo yönetimi.
• Slack Server: Mesaj gönderme, kanal yönetimi, arama yapma.
• Brave Search Server: Web araması yapma, güncel bilgilere erişme.
• Puppeteer Server: Web sayfalarını otomatize etme, ekran görüntüsü alma, scraping.
• Notion Server: Notion sayfaları ve veritabanları ile etkileşim.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home/kullanici/belgeler"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/veritabani"
      ]
    }
  }
}

Güvenlik ve En İyi Uygulamalar (Security Best Practices)

MCP güçlü bir protokol ama güç, sorumluluk gerektirir. Alesta Web olarak güvenlik konusunda taviz vermiyoruz ve müşterilerimize de aynı hassasiyeti öneriyoruz. İşte MCP kullanırken dikkat etmeniz gereken güvenlik noktaları:

Yetkilendirme ve Erişim Kontrolü (Authorization & Access Control)

Her MCP sunucusuna minimum yetki (least privilege) prensibiyle erişim verin. Dosya sistemi sunucusunu tüm diske değil, sadece ihtiyaç duyulan dizinlere açın. Veritabanı sunucusu için salt okunur (read-only) kullanıcılar tercih edin.

Gizli Bilgi Yönetimi (Secret Management)

API anahtarlarını ve şifreleri asla yapılandırma dosyalarına düz metin olarak yazmayın. Ortam değişkenlerini (environment variables) kullanın ve bunları güvenli bir vault sisteminde saklayın.

İnsan Onay Döngüsü (Human-in-the-Loop)

Kritik işlemler için mutlaka kullanıcı onayı (human approval) mekanizması kurun. MCP destekleyen platformların çoğu, araç çağrıları için onay isteme özelliğine sahiptir.

2026 Yol Haritası ve Gelecek (2026 Roadmap & Future)

MCP protokolü hızla gelişmeye devam ediyor. Linux Foundation bünyesindeki Agentic AI Foundation yönetiminde, 2026 için heyecan verici planlar var. Alesta Web olarak bu gelişmeleri yakından izliyoruz:

MCP Registry ?

2026'nın en beklenen özelliği MCP Registry'dir. npm veya PyPI gibi merkezi bir kayıt sistemi (registry) oluşturulacak. Geliştiriciler MCP sunucularını bu registriye yayınlayabilecek, kullanıcılar ise arama yapıp kolayca kurabilecek. Bu, ekosistemin büyümesini inanılmaz hızlandıracak.

Güvenlik İyileştirmeleri (Security Improvements) ?

OAuth 2.1 entegrasyonu, sunucu kimlik doğrulama (server authentication) mekanizmaları ve daha granüler yetkilendirme kontrolleri geliyor. Kurumsal kullanıcılar için bu iyileştirmeler kritik önem taşıyor.

Streamable HTTP Transport

SSE modunun yerini alacak yeni Streamable HTTP taşınım modu, daha verimli ve esnek uzak bağlantılar sunacak. İki yönlü (bidirectional) iletişim desteğiyle daha zengin etkileşimler mümkün olacak.

Daha Zengin Primitifler

Mevcut altı temel özelliğe ek olarak yeni primitifler gelecek. Özellikle çoklu ajan (multi-agent) senaryoları için yeni iletişim kalıpları üzerinde çalışılıyor.

Kaynaklar ve Referanslar (References)

MCP hakkında daha fazla bilgi edinmek ve güncel kalmak için aşağıdaki kaynakları takip etmenizi öneriyoruz:

• Resmi Dokümantasyon: modelcontextprotocol.io — MCP'nin resmi web sitesi, spesifikasyon, kılavuzlar ve SDK dokümantasyonu burada.
• Anthropic: anthropic.com — MCP'yi geliştiren şirketin resmi sitesi. Blog yazıları ve duyurular için takip edin.
• GitHub: github.com/modelcontextprotocol — Açık kaynak SDK'lar, resmi sunucular ve spesifikasyon deposu.
• Agentic AI Foundation: Linux Foundation bünyesinde MCP'yi yöneten vakıf.
• Alesta Web Blog: alestaweb.com — Türkçe MCP rehberleri, uygulama örnekleri ve güncel haberler.