Özet
Model Bağlam Protokolü (MCP), yapay zeka asistanlarını harici veri kaynaklarına ve API'lere bağlamak için bir standarttır. Claude Desktop, Cursor ve diğer yapay zeka araçlarının API'nize güvenli bir şekilde erişmesini sağlar. Modern PetstoreAPI, yapay zeka asistanlarının doğal dil aracılığıyla evcil hayvan arayabilmesi, sipariş verebilmesi ve envanteri yönetebilmesi için MCP'yi uygular.
Giriş
Claude Desktop'a soruyorsunuz: "Bana 300 doların altındaki mevcut kedileri göster." Claude yanıtlıyor: "Evcil hayvan mağazası verilerine erişimim yok." İş akışınızı bozarak API'nizden kopyala/yapıştır yapmanız gerekiyor.
MCP (Model Bağlam Protokolü) ile Claude, API'nize doğrudan erişebilir. Aynı soruyu sorduğunuzda, Claude PetstoreAPI'yi sorgular, sonuçları filtreler ve size 300 doların altındaki mevcut kedileri gösterir.
Modern PetstoreAPI, yapay zeka asistanlarının evcil hayvan mağazasıyla doğal dil aracılığıyla etkileşim kurmasını sağlayan MCP'yi uygular.
Yapay zeka entegrasyonu için API'ler oluşturuyorsanız, Apidog MCP uygulamalarını test etmenize ve yapay zeka asistanı etkileşimlerini doğrulamanıza yardımcı olur.
MCP Nedir?
MCP, Anthropic tarafından yapay zeka asistanlarını harici kaynaklara bağlamak için oluşturulmuş bir protokoldür.
MCP'nin Çözdüğü Sorun
Yapay zeka asistanları güçlüdür ancak izoledir. Şunları yapamazlar:
- Şirketinizin dahili API'lerine erişmek
- Veritabanınızı sorgulamak
- Dosya sisteminizden dosya okumak
- Harici hizmetlerle etkileşim kurmak
MCP, yapay zeka asistanlarının bu kaynaklara güvenli bir şekilde bağlanması için standart bir yol sağlar.
MCP Bileşenleri
1. MCP Sunucusu - Kaynakları ve araçları yapay zeka asistanlarına sunar
2. MCP İstemcisi - Yapay zeka asistanı (Claude Desktop, Cursor vb.)
3. Kaynaklar - Yapay zekanın okuyabileceği veriler (dosyalar, veritabanı kayıtları, API yanıtları)
4. Araçlar - Yapay zekanın gerçekleştirebileceği eylemler (sipariş oluşturma, evcil hayvan güncelleme, envanter arama)
MCP Mimarisi
Yapay Zeka Asistanı (Claude Desktop)
↓ MCP Protokolü
MCP Sunucusu (PetstoreAPI MCP Sunucusu)
↓ Dahili API'ler
PetstoreAPI Arka Ucu
↓
Veritabanı
MCP Nasıl Çalışır
1. Sunucu Kaydı
Claude Desktop'ı MCP sunucusuna bağlanacak şekilde yapılandırın:
{
"mcpServers": {
"petstore": {
"command": "node",
"args": ["/path/to/petstore-mcp-server.js"],
"env": {
"PETSTORE_API_KEY": "your-api-key"
}
}
}
}
2. Araç Keşfi
Yapay zeka asistanı sorar: "Hangi araçlar mevcut?"
MCP sunucusu yanıtlar:
{
"tools": [
{
"name": "search_pets",
"description": "Evcil hayvanları türüne, durumuna ve fiyatına göre arayın",
"inputSchema": {
"type": "object",
"properties": {
"species": {"type": "string", "enum": ["CAT", "DOG"]},
"maxPrice": {"type": "number"},
"status": {"type": "string", "enum": ["AVAILABLE", "ADOPTED"]}
}
}
},
{
"name": "create_order",
"description": "Evcil hayvan için sipariş verin",
"inputSchema": {
"type": "object",
"properties": {
"petId": {"type": "string"},
"userId": {"type": "string"}
},
"required": ["petId", "userId"]
}
}
]
}
3. Araç Yürütme
Kullanıcı sorar: "Bana 300 doların altındaki mevcut kedileri göster"
Yapay zeka asistanı çağırır:
{
"tool": "search_pets",
"arguments": {
"species": "CAT",
"status": "AVAILABLE",
"maxPrice": 300
}
}
MCP sunucusu yürütür:
async function search_pets({ species, status, maxPrice }) {
const response = await fetch(
`https://petstoreapi.com/v1/pets?species=${species}&status=${status}&maxPrice=${maxPrice}`
);
return await response.json();
}
Yapay zekaya sonuçları döndürür, yapay zeka bunları kullanıcı için biçimlendirir.
MCP vs Geleneksel API'ler
| Özellik | Geleneksel API | MCP |
|---|---|---|
| Erişim | Doğrudan HTTP | Yapay zeka asistanı aracılığıyla |
| Arayüz | REST/GraphQL | Doğal dil |
| Kimlik Doğrulama | API anahtarları, OAuth | MCP sunucusu kimlik doğrulamayı yönetir |
| Keşif | OpenAPI belgeleri | Araç şemaları |
| Kullanım | Kod/curl | Konuşmaya dayalı |
| Hata Yönetimi | HTTP durum kodları | Yapay zeka hataları yorumlar |
Örnek Karşılaştırma
Geleneksel API:
curl -H "Authorization: Bearer token" \
"https://petstoreapi.com/v1/pets?species=CAT&maxPrice=300"
MCP:
Kullanıcı: "Bana 300 doların altındaki mevcut kedileri göster"
Yapay zeka: [search_pets aracını çağırır, sonuçları biçimlendirir]
"İşte 300 doların altında mevcut 5 kedi:
1. Fluffy - 250 $
2. Whiskers - 280 $
..."
Modern PetstoreAPI MCP'yi Nasıl Uygular
Modern PetstoreAPI bir MCP sunucusu sağlar.
Mevcut Araçlar
1. search_pets - Kriterlere göre evcil hayvan arayın 2. get_pet - Evcil hayvan detaylarını alın 3. create_order - Sipariş verin 4. get_inventory - Envanteri kontrol edin 5. update_pet_status - Evcil hayvanın durumunu güncelleyin
Örnek: Arama ve Sipariş
Kullanıcı: "Bana 500 doların altında bir köpek bul ve sipariş ver"
Yapay zeka iş akışı:
1. search_pets({species: "DOG", maxPrice: 500}) çağrısı yapın
2. Sonuçları kullanıcıya gösterin
3. Kullanıcı onaylar: "Labrador'u sipariş et"
4. create_order({petId: "019b4132", userId: "user-456"}) çağrısı yapın
5. Siparişin verildiğini onaylayın
MCP Sunucu Kodu
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
const server = new Server({
name: 'petstore-mcp',
version: '1.0.0'
}, {
capabilities: {
tools: {}
}
});
server.setRequestHandler('tools/list', async () => ({
tools: [
{
name: 'search_pets',
description: 'Evcil hayvanları arayın',
inputSchema: {
type: 'object',
properties: {
species: { type: 'string' },
maxPrice: { type: 'number' }
}
}
}
]
}));
server.setRequestHandler('tools/call', async (request) => {
const { name, arguments: args } = request.params;
if (name === 'search_pets') {
const response = await fetch(
`https://petstoreapi.com/v1/pets?${new URLSearchParams(args)}`
);
return { content: [{ type: 'text', text: JSON.stringify(await response.json()) }] };
}
});
const transport = new StdioServerTransport();
await server.connect(transport);
Apidog ile MCP Test Etme
Apidog MCP uygulamalarını test etmeye yardımcı olur:
- Temel API'lerin doğru çalıştığını test edin
- Araç şemalarının API sözleşmeleriyle eşleştiğini doğrulayın
- Hata yönetimini test edin
- Kimlik doğrulama akışlarını doğrulayın
MCP Neden Önemli?
1. Yapay Zeka Yerel API'leri
API'ler doğal dil aracılığıyla erişilebilir hale gelir. Teknik olmayan kullanıcılar, yapay zeka asistanları aracılığıyla API'nizle etkileşim kurabilir.
2. Standardizasyon
MCP, yapay zeka-API entegrasyonu için standart haline geliyor. Bir kez destekleyin, tüm MCP istemcileriyle çalışın.
3. Güvenlik
MCP sunucuları kimlik doğrulamayı yönetir. Yapay zeka asistanlarının doğrudan API erişimine ihtiyacı yoktur.
4. Birleştirilebilirlik
Yapay zeka asistanları, birden fazla MCP sunucusunu birleştirerek hizmetler arasında iş akışları oluşturabilir.
Sonuç
MCP, yapay zeka asistanları ve API'ler arasında köprü kurar. Modern PetstoreAPI, Claude Desktop ve diğer yapay zeka araçlarının evcil hayvan mağazasıyla doğal dil aracılığıyla etkileşim kurmasını sağlayan MCP'yi uygular.
Ana çıkarımlar:
- MCP, yapay zeka asistanlarını API'lere bağlar
- Araçlar, yapay zekanın ne yapabileceğini tanımlar
- Doğal dil, API çağrılarının yerini alır
- Modern PetstoreAPI, MCP uygulamasını gösterir
SSS
Hangi yapay zeka asistanları MCP'yi destekliyor?
Claude Desktop, Cursor ve Anthropic tarafından desteklenen diğer araçlar. Destek büyümeye devam ediyor.
MCP güvenli mi?
Evet. MCP sunucuları kimlik doğrulamayı yönetir. Yapay zeka asistanları API anahtarlarını görmez.
Mevcut API'lerle MCP kullanabilir miyim?
Evet. Mevcut API'nizi saran bir MCP sunucusu oluşturun.
MCP, REST API'lerinin yerini mi alıyor?
Hayır. MCP, yapay zeka asistanı erişimi içindir. REST API'leri doğrudan programatik erişim için kalır.
MCP araçlarını nasıl test ederim?
Temel API'leri test etmek için Apidog'u kullanın, ardından MCP araçlarını Claude Desktop ile test edin.