Yapay Zekâ ve MCP

MCP sunucusu

Yapay zekân bu dokümanı ve 6.500+ API ucunun kataloğunu kendi okusun — kopyala-yapıştır yok.

Blesyum, Model Context Protocol (MCP) sunucusu yayınlar. Bağlanan bir yapay zekâ asistanı bu dokümanı arar, uç kataloğunu okur ve yazdığı entegrasyon kodunu gerçek uçlara dayandırır.

text
https://apidocs.blesyum.com/mcp

Taşıma: Streamable HTTP. Kimlik gerekmez — araçların hepsi salt okunurdur ve doküman zaten herkese açıktır.

Bağlanma

Claude Code

bash
claude mcp add --transport http blesyum https://apidocs.blesyum.com/mcp

Ardından /mcp ile bağlantıyı doğrula.

Claude (masaüstü / web)

Ayarlar → Connectors → Add custom connector → URL alanına https://apidocs.blesyum.com/mcp

Cursor, VS Code ve diğerleri

json
{
  "mcpServers": {
    "blesyum": { "url": "https://apidocs.blesyum.com/mcp" }
  }
}

Araçlar

AraçNe yapar
search_docsRehberlerde ve 6.500+ uçta arama. GET /contacts ve crm:webhook kısayolları çalışır.
get_guideBir rehber sayfasının tam metnini döndürür
list_guidesTüm rehber sayfaları
list_modulesSekiz modül, taban yolları, adres şablonları, uç sayıları
list_endpointsBir modülün kaynak aileleri ya da bir ailenin tüm uçları
get_endpointTek ucun tam künyesi + çalışan cURL örneği
list_scopesAPI anahtarı kapsamları
list_webhook_eventsAbone olunabilecek olaylar

Neden işe yarıyor

Bir dil modeline "Blesyum'a kişi ekleyen kod yaz" dediğinde, MCP olmadan model uydurur: makul görünen ama var olmayan bir uç yolu, yanlış bir kimlik başlığı, olmayan bir alan adı. Kod derlenir, çalışmaz ve neden çalışmadığı belli olmaz.

MCP ile model önce search_docs çağırır, sonra get_endpoint ile künyeyi doğrular. Yazdığı yol gerçektir çünkü kaynaktan türetilmiştir.

Asistanına şunu söylemek işi hızlandırır: "Blesyum MCP sunucusunu kullan. Uç yolu ya da kapsam adı uydurma; önce search_docs ve get_endpoint ile doğrula."

Araçların sınırı

Bugün tüm araçlar salt okunurdur. Bu bilinçli bir karardır: kimliksiz bir yazma aracı, sunucuyu herkesin adına iş yapan bir vekile çevirirdi. Bir gün yazma araçları eklenirse, o araçlar kullanıcının kendi API anahtarını isteyecek.

Keşif

Bazı istemciler sunucuyu adresinden değil künye dosyasından tanır:

text
https://apidocs.blesyum.com/.well-known/mcp.json

Doğrulama

Bağlantının çalıştığını elle sınamak istersen:

bash
curl -X POST https://apidocs.blesyum.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Yanıtta sekiz aracı görmelisin.