MCP nedir?

Model Context Protocol (MCP), yapay zeka istemcilerinin (Claude, ChatGPT vb.) dış veri kaynaklarına ve araçlara standart bir arayüzle bağlanmasını sağlayan açık bir protokoldür. Kolay Bahçe, Akdeniz iklimine uygun bitki ve peyzaj veritabanını bu protokol üzerinden araç (tool) ve kaynak (resource) olarak yayınlar. Böylece bir AI asistanı, HTML sayfalarını tarayıp ayıklamak yerine yapılandırılmış veriyi doğrudan, güvenilir biçimde alır.

Özet

Sunucu salt-okunurdur, kimlik doğrulama gerektirmez ve ücretsizdir. Veriler Antalya ve Akdeniz peyzajına odaklı, sponsorsuz ve Türkçedir.

Bağlantı bilgileri

POST https://kolay-bahce.com/mcp

Taşıma: Streamable HTTP — JSON-RPC 2.0 over HTTP (durumsuz / stateless)
İçerik tipi: Content-Type: application/json
Protokol sürümü: 2025-06-18
Kimlik doğrulama: Gerekmez (herkese açık, salt-okunur)

Claude Desktop'a ekleme

Claude Desktop yapılandırma dosyanıza (claude_desktop_config.json) aşağıdaki girdiyi ekleyin. Uzak HTTP sunucusuna köprü için mcp-remote kullanılır:

json

{
  "mcpServers": {
    "kolay-bahce": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://kolay-bahce.com/mcp"]
    }
  }
}

Kaydedip Claude Desktop'ı yeniden başlattığınızda kolay-bahce sunucusu araç listesinde görünür. HTTP tabanlı uzak MCP sunucularını doğrudan destekleyen istemcilerde ise yalnızca yukarıdaki adresi eklemeniz yeterlidir.

Sunulan araçlar (tools)

Araç	Açıklama	Parametreler
bitki_ara	Ada, Latince adına, etikete veya açıklamaya göre peyzaj bitkisi arar.	`query` (zorunlu)
bitki_listele	Kataloğu tür ve/veya iklim kökeni eksenine göre listeler/filtreler.	`kategori`, `kaynak` (isteğe bağlı)
bitki_detay	Tek bir bitkinin tam profilini (güneş/su ihtiyacı, dikim, bakım, kaynaklar, SSS) döndürür.	`slug` (zorunlu)
blog_listele	Yayınlanmış tüm blog yazılarını listeler.	—
blog_oku	Tek bir blog yazısının tam içeriğini döndürür.	`slug` (zorunlu)

İki eksenli sınıflandırma

kategori (tür): agac · cali · yer-ortucu · sukulent · cicek · tirmanici · aromatik | kaynak (iklim kökeni): akdeniz · kuraksal · subtropik · yerli · tropik

Sunulan kaynaklar (resources)

Her bitki ve blog yazısı, kanonik URL'siyle bir application/json kaynağı olarak listelenir. resources/list ile tüm kaynakları, resources/read ile bir kaynağın tam içeriğini alabilirsiniz.

Örnek: araç çağrısı (curl)

El sıkışmadan sonra bir araç çağırma örneği:

bash

curl -s https://kolay-bahce.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "bitki_ara",
      "arguments": { "query": "kuraklığa dayanıklı" }
    }
  }'

Örnek: tam akış (JSON-RPC)

Bir MCP oturumu şu sırayla ilerler:

json-rpc

// 1) El sıkışma
→ {"jsonrpc":"2.0","id":1,"method":"initialize",
   "params":{"protocolVersion":"2025-06-18","capabilities":{}}}

// 2) Araçları keşfet
→ {"jsonrpc":"2.0","id":2,"method":"tools/list"}

// 3) Detay al
→ {"jsonrpc":"2.0","id":3,"method":"tools/call",
   "params":{"name":"bitki_detay",
             "arguments":{"slug":"zeytin-agaci"}}}

Sorularınız veya geri bildirimleriniz için bize ulaşın. Sunucu, sitedeki içerikle birlikte otomatik güncellenir; yeni bir bitki veya yazı eklendiğinde MCP araçlarında anında erişilebilir olur.

MCPRehberi