MCP (Model Context Protocol) Türkçe Tam Rehber 2026: AI Tool Entegrasyonunun USB-C'si

2023-2024 arası agent ekosisteminin en büyük problemi parçalanmaydı: her LLM sağlayıcısı kendi tool kullanım API'sini sunuyordu (OpenAI Function Calling, Anthropic Tool Use, Google Function Calling), her SaaS ürünü her sağlayıcıya ayrı integration yazmak zorundaydı. Bir Slack-Claude entegrasyonu, Slack-ChatGPT entegrasyonu, Slack-Gemini entegrasyonu — üç farklı kodlama.

Anthropic'in Kasım 2024'te tanıttığı MCP bu sorunu standartlaştırdı.

Mart 2025: Ekosistem Kabul Etti

MCP'nin standart haline geldiğinin en büyük göstergesi: Mart 2025'te OpenAI MCP desteğini duyurdu. Sonrasında Microsoft Copilot Studio, Google'ın Vertex AI ekosistemi ve büyük SaaS sağlayıcıları MCP server yayınlamaya başladı.

Bu, AI tool entegrasyonunun HTTP'si gibi. Önce bir şirketin özel protokolüydü, şimdi sektör standardı.

2024'ten önce bir agent geliştirmek istiyorsanız:

• OpenAI Function Calling: OpenAI API'sine özel function schema, tool definition
• Anthropic Tool Use: Claude'a özel format, biraz farklı schema
• Google Function Calling: Gemini'ye özel format
• LangChain Tools: Framework-specific abstraction, ama yine her LLM için adapter

Bir Slack entegrasyonu için 3-4 farklı tool wrapper. Yeni bir LLM çıkınca yeniden yazım. SaaS ürünleri "Hangi modelle çalışıyoruz?" sorusuna her seferinde entegrasyon yazmak zorunda.

MCP bu cehennemi çözdü.

3.1. MCP Server

Bir MCP server üç ana yetenek expose eder:

• Tools (Araçlar): LLM'in çağırabileceği fonksiyonlar (send_message, query_db, search_files)
• Resources (Kaynaklar): LLM'in okuyabileceği veri (dosyalar, API yanıtları, DB rows)
• Prompts (Hazır Prompt'lar): Reusable prompt şablonları

Server, JSON-RPC üzerinden bu üç yetenek için handler'lar implement eder.

3.2. MCP Client

Claude Desktop, Cursor, Claude Code, Cline gibi uygulamalar MCP client'tır. Kullanıcı bir sorgu yaptığında:

1. Client server'lardan tool listesini ister (initialize)
2. LLM'e mevcut tool'lar bildirilir
3. LLM tool çağırma kararı verir
4. Client ilgili MCP server'a JSON-RPC mesajı gönderir
5. Server execute eder, sonucu döner
6. Client LLM'e sonucu iletir

3.3. Transport

Üç ana taşıma yöntemi:

• stdio: Yerel process (en yaygın, Claude Desktop varsayılan)
• HTTP-SSE (Server-Sent Events): Uzaktaki server'a HTTP üzerinden
• WebSocket: Bidirectional persistent connection

Çoğu yerel kullanım stdio; production uzak servisler HTTP-SSE.

MCP, JSON-RPC 2.0 standardı üzerine kurulu. Tipik mesaj:

// Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_slack_message",
    "arguments": {
      "channel": "general",
      "text": "Hello from MCP"
    }
  }
}

// Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "Message sent: ts=1234567" }
    ]
  }
}

Method tipleri: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get, completion/complete.

Türk Kullanım Senaryoları

• KVKK'ya uygun veri: Postgres MCP (Türkiye veya AB-bölge), Filesystem MCP (on-prem)
• Ekip işbirliği: Slack MCP, Notion MCP, Linear MCP
• Bankacılık: Salesforce MCP + sandboxed kullanım
• Geliştirici: GitHub MCP + Sentry MCP + Postgres MCP

Claude Desktop'a MCP server eklemek en hızlı yol. Mac/Windows uygulamasını indirin, sonra config:

// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/seninAdin/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_yourtoken"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/db"]
    }
  }
}

Sonra Claude Desktop'ı yeniden başlatın. Yeni "tool" ikonu MCP server'larını gösterir; Claude artık bu tool'ları doğal sohbet sırasında çağırabilir.

Python ile özel bir MCP server 30-60 dakikada yazılır.

7.1. Kurulum

pip install mcp

7.2. Minimal Server (Türk Vergi Hesaplayıcı)

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Turk Vergi Hesaplayici")

@mcp.tool()
def kdv_hesapla(tutar: float, oran: float = 20.0) -> dict:
    """KDV dahil tutar ve KDV miktarini hesaplar.

    Args:
        tutar: KDV haric tutar (TL)
        oran: KDV orani (varsayilan %20)
    """
    kdv = tutar * oran / 100
    return {
        "tutar_haric": tutar,
        "kdv_orani": oran,
        "kdv_miktari": round(kdv, 2),
        "tutar_dahil": round(tutar + kdv, 2),
    }

@mcp.tool()
def gelir_vergisi_2026(yillik_gelir: float) -> dict:
    """2026 Gelir Vergisi dilimlerine gore vergi hesaplar."""
    dilimler = [
        (110000, 0.15),
        (230000, 0.20),
        (870000, 0.27),
        (3000000, 0.35),
        (float("inf"), 0.40),
    ]
    vergi = 0
    onceki_limit = 0
    for limit, oran in dilimler:
        if yillik_gelir <= onceki_limit:
            break
        vergilenecek = min(yillik_gelir, limit) - onceki_limit
        vergi += vergilenecek * oran
        onceki_limit = limit
    return {
        "yillik_gelir": yillik_gelir,
        "toplam_vergi": round(vergi, 2),
        "net_gelir": round(yillik_gelir - vergi, 2),
    }

if __name__ == "__main__":
    mcp.run()

7.3. Claude Desktop'a Kayıt

{
  "mcpServers": {
    "turk-vergi": {
      "command": "python",
      "args": ["/path/to/turk_vergi_server.py"]
    }
  }
}

Claude'a "20.000 TL'lik faturanın KDV'sini hesapla" derseniz, Claude kdv_hesapla tool'unu çağırır, sonucu döndürür.

// turk-vergi.ts
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
  CallToolRequestSchema,
  ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";

const server = new Server(
  { name: "turk-vergi", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: "kdv_hesapla",
      description: "KDV dahil tutar ve KDV miktarini hesaplar",
      inputSchema: {
        type: "object",
        properties: {
          tutar: { type: "number", description: "KDV haric tutar (TL)" },
          oran: { type: "number", default: 20 },
        },
        required: ["tutar"],
      },
    },
  ],
}));

server.setRequestHandler(CallToolRequestSchema, async (req) => {
  if (req.params.name === "kdv_hesapla") {
    const { tutar, oran = 20 } = req.params.arguments as any;
    const kdv = tutar * oran / 100;
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({
            tutar_haric: tutar,
            kdv_orani: oran,
            kdv_miktari: Number(kdv.toFixed(2)),
            tutar_dahil: Number((tutar + kdv).toFixed(2)),
          }),
        },
      ],
    };
  }
  throw new Error("Unknown tool");
});

const transport = new StdioServerTransport();
await server.connect(transport);

Pratik tavsiye. Tek bir LLM'e kilitleniyorsanız o LLM'in native API'si yeterli olabilir. Ama vendor-agnostic ve uzun-vadeli strateji için MCP standardını tercih edin.

MCP'nin güçlü tarafı: LLM dış sistemlere doğrudan erişiyor. Bu güvenlik açığı anlamına da gelir.

10.1. Tehdit Modeli

• Prompt injection ile tool yetkisi suistimal: Kullanıcı girdisi LLM'i kötü tool'ları çağırmaya yönlendirir
• Veri sızdırma: Tool çağrısı ile hassas veriler dış sistemlere
• Privilege escalation: Tool zinciri ile beklenmedik yetki kazanma
• Supply chain: Kötü amaçlı 3rd-party MCP server

10.2. KVKK Uyumlu MCP Kullanımı

• İzin matrisi: Hangi MCP server hangi tool'a erişebilir
• Sandbox: Filesystem MCP yalnızca belirlenmiş klasörde
• Read-only: Postgres MCP üretim DB'sine yalnızca SELECT yetkisi
• Audit log: Tüm tool çağrıları kaydedilsin
• HITL: Yüksek-stake eylemlerde insan onayı
• Türkiye-bölge: API çağrıları kişisel veri içeriyorsa OpenAI/Anthropic global API yerine AB-bölge
• PII detection: Tool input/output'larında otomatik kişisel veri filtreleme

10.3. MCP Server Doğrulama Kontrol Listesi

1. ✅ Resmi Anthropic katalog mu? (kabul edilmiş)
2. ✅ Açık kaynak + popüler repo mu? (incelenmiş)
3. ✅ Kim yazmış? (güvenilir yayıncı)
4. ✅ Hangi yetkiler talep ediyor? (en az gerekli)
5. ✅ Audit log destekliyor mu?
6. ⚠️ Bilinmeyen yayıncı 3rd-party server'ları production'a koymadan sandbox'ta test edin

11.1. İç Operasyon Otomasyonu

Slack + GitHub + Linear MCP kombinasyonu ile geliştirici ekibinin günlük işleri:

• "Bugün açılan PR'leri özetle" → GitHub MCP
• "Open issue'ları sprint'e ekle" → Linear MCP
• "Sprint daily standup için duyuru gönder" → Slack MCP

11.2. Müşteri Hizmetleri Augmentation

Salesforce/HubSpot CRM MCP + Internal Wiki MCP ile temsilciler "müşteri X'in son siparişini ve son şikayetini bul, çözüm önerileri ile özetle" diye sorabilir.

11.3. Finans Operasyonu

Postgres MCP + KOSGEB raporlama: "Q1 satışları KOSGEB raporu formatında dök" → Postgres'ten veri çek, formatla, PDF üret.

11.4. Hukuk Otomasyonu

Filesystem MCP + Notion MCP ile sözleşme kütüphanesi sorgulama: "Geçen yıl imzalanan tedarik sözleşmelerinden risk maddelerini özetle."

11.5. Yazılım Geliştirme Hızlandırma

Claude Code + GitHub MCP + Postgres MCP: "Yeni bir endpoint yaz, prod schema'ya bak, integration test ekle, PR aç."

Vaka 1 — Türk Yazılım Şirketi: Internal Knowledge MCP

40 geliştiricili Türk yazılım şirketi, iç dokümantasyon (Notion + Confluence + GitHub README'leri) genelde aranamıyordu. Custom MCP server yazdılar:

• Notion + Confluence + GitHub README'leri vector DB'ye index
• MCP server bunlara semantic search expose etti
• Claude Code üzerinden geliştiriciler "X feature nasıl implement edilmiş?" diye sorabilir

Sonuç: Onboarding süresi 3 haftadan 1 haftaya; senior dev'lere "rehberlik" soruları %40 azaldı.

Vaka 2 — Türk Banka: Sandboxed Postgres MCP

Banka analistleri ad-hoc raporlar için DBA'lara talep gönderiyordu. MCP ile read-only Postgres MCP server'ı kurdular (yalnızca aggregated views, PII maskeli):

• Audit log her sorgu için
• Yetkilendirme matrisi (rolüne göre hangi view'lar)
• KVKK uyum komitesi onayı

Sonuç: Analiz süresi 3 günden 2 saate; DBA workload %35 azaldı.

Vaka 3 — E-Ticaret: Multi-Channel Sales MCP

Türk e-ticaret pazaryeri Slack + Salesforce + Postgres + Notion MCP'lerini birleştirdi. Sales temsilcileri tek bir Claude konuşmasında:

• Müşteri verisini sorgula (Salesforce)
• Geçmiş sipariş analizi (Postgres)
• Kampanya değişikliği (Notion)
• Ekip duyurusu (Slack)

Sonuç: Sales temsilcisi başına günlük 1.5 saat tasarruf; cross-system tutarlılık iyileşti.

Google'ın 2025'te tanıttığı A2A (Agent-to-Agent) protokolü MCP'yi tamamlayıcı: MCP tool entegrasyonu için, A2A agent-to-agent iletişim için.

• MCP: agent ↔ tool (Slack, DB, Filesystem)
• A2A: agent ↔ agent (researcher agent ↔ writer agent)

2026'da A2A henüz erken; 2027'de mainstream'e geçmesi bekleniyor. MCP-A2A kombinasyonu çoklu-ajan ekosistemin standart altyapısı olacak.

• MCP-uyumlu SaaS: Tüm büyük SaaS ürünlerinin MCP server yayınlaması 2027'de "mecburi" konuma geliyor
• Marketplace ekonomisi: MCP server pazaryeri (ücretli premium MCP'ler)
• Enterprise MCP gateway: Şirket içi MCP routing, auth, audit
• MCP + A2A entegrasyonu: Multi-agent + multi-tool standart
• Mobil MCP: iOS/Android'de yerel MCP client'lar
• MCP authentication standardı: OAuth 2.0 entegrasyonu olgunlaşıyor

Türkiye'de MCP topluluğu erken aşamada. Mevcut kaynaklar:

• Resmi MCP dokümantasyonu (İngilizce)
• Anthropic Türkçe destek (sınırlı)
• Hugging Face Türkçe NLP topluluğu (MCP başlığında aktif)
• Türk teknoloji blog'ları (yavaş yavaş MCP içerikleri çıkmaya başladı)

Stratejik fırsat: İlk Türkçe MCP server'ları (Türk hukuk, vergi, KOSGEB, TÜBİTAK, e-Fatura için) erken yayınlayan geliştiriciler bu ekosistemde ön plana çıkar.

MCP'yi şirketinizde stratejik olarak kullanmak için:

1. MCP Discovery Workshop. Mevcut sistemlerinizden hangileri için MCP server gerekli? Hangi senaryolar değer üretir? 4-saatlik atölye, çıktı: MCP yol haritası.
2. Custom MCP Server Development. Şirket içi (hukuk, finans, operasyon, müşteri) sistemleriniz için MCP server geliştirme — TypeScript/Python ile.
3. MCP + Agent Mimarisi Audit. Mevcut agent altyapınız için MCP entegrasyon, güvenlik (KVKK + sandboxing), gözlemlenebilirlik denetimi.

İletişim için site üzerindeki contact formunu kullanabilirsiniz.

Bu rehber yaşayan bir belgedir; MCP ekosistemi her çeyrek hızla değiştiği için çeyreklik olarak güncellenmektedir.