Yapay zekâ araçlarıyla kullanım (MCP)

Open Play’in MCP (Model Context Protocol) sunucusu, yapay zekâ yardımcınızın (“misafir girişi nasıl yapılır”, “oyuncu verisi nasıl kaydedilir”, “eklenti nasıl çağrılır” gibi sorulara) tahmin yürütmek yerine bu sitedeki resmî belgelerden ve SDK API’sinden cevap vermesini sağlar. Sunucu yalnızca okur: Open Play sunucunuza, anahtarlarınıza dokunmaz; belgeler ve SDK dizini yalnızca herkese açık belge sitesinden okunur.

Kurulum

Barındırılan sunucu (önerilen)

Hiçbir şey kurmadan https://open-play.b4klabs.dev/mcp adresine bağlanın (Streamable HTTP, yalnız okur, kimlik doğrulama yok):

claude mcp add --transport http open-play https://open-play.b4klabs.dev/mcp

Cursor için .cursor/mcp.json, VS Code için .vscode/mcp.json (mcpServers yerine servers anahtarıyla) dosyasına şunu ekleyin:

{
  "mcpServers": {
    "open-play": {
      "url": "https://open-play.b4klabs.dev/mcp"
    }
  }
}

Sunucu belge ve SDK dizinini https://open-play.b4klabs.dev/docs/mcp/index.json adresinden alır; dizin belge sitesiyle birlikte yenilenir, yani yeni bir belge yayımlandığında sunucuyu güncellemeniz gerekmez.

Yerel paket

Ağ yerine yerel süreç istiyorsanız paket @ferdiunal/open-play-mcp GitHub Packages üzerinden yayımlanır (kaynak: ferdiunal/open-play-mcp). Kullanıcı .npmrc dosyanıza @ferdiunal:registry=https://npm.pkg.github.com satırını ve read:packages izinli bir GitHub belirtecini ekleyin (belirteci belgeye ya da depoya yazmayın), sonra:

claude mcp add open-play -- npx -y @ferdiunal/open-play-mcp

Cursor ve VS Code için "command": "npx" ve "args": ["-y", "@ferdiunal/open-play-mcp"] kullanın. Yerel paket de aynı dizini canlı adresten alır; ağ yoksa son önbelleği, o da yoksa pakete gömülü anlık görüntüyü kullanır.

Araçlar

Araç adları ve açıklamaları İngilizcedir; belge içeriğini Türkçe istemek için lang: "tr" verin (varsayılan en).

Araç	Ne yapar	Örnek girdi
`search_docs`	Belgelerde arar; başlık, ara başlık ve gövde sırasıyla puanlanır; sonuç sayfa kimliği, açıklama ve genel adres verir	`{"query": "guest sign in"}`
`read_doc`	Bir sayfanın tam markdown metnini verir (en çok 40 000 karakter)	`{"page": "auth/guest"}`
`list_docs`	Sayfa kimliklerini ve başlıklarını listeler; `section` ile tek bölüm	`{"section": "auth"}`
`search_sdk`	TypeScript ve Unity SDK’larında tür, işlev ve üye adı arar	`{"query": "signInGuest", "sdk": "typescript"}`
`get_sdk_symbol`	Bir türün imzasını, özetini ve üyelerini verir; `Tür.Üye` biçimi desteklenir	`{"name": "PlayerSession", "sdk": "unity"}`

Her belge sayfası ayrıca open-play-docs://<dil>/<sayfa> adresli bir kaynaktır (ör. open-play-docs://en/auth/guest) ve integrate_open_play adlı bir istem (platform: web, unity ya da server) entegrasyon adımlarını ve doğru sayfa bağlantılarını verir.

Sınır: Unity API dizini C# kaynağından hafif bir ayrıştırıcıyla çıkarılır; kalıtım ve genel tür parametreleri gibi ayrıntılar eksik olabilir. Kesin başvuru için Unity SDK sayfasındaki üretilmiş başvuruya bakın. SDK özetleri şimdilik Türkçedir, çünkü kaynak koddaki Türkçe yorumlardan gelir.

llms.txt ve llms-full.txt

MCP kullanamayan araçlar (ya da bir sohbete belge yapıştırmak istediğinizde) için belgeler llmstxt.org biçiminde düz metin olarak da yayımlanır:

Dosya	İçerik
`https://open-play.b4klabs.dev/llms.txt`	İngilizce dizin: her sayfanın başlığı, bir satırlık açıklaması ve `.md` kopyasının adresi
`https://open-play.b4klabs.dev/llms-full.txt`	İngilizce belgelerin tamamı tek dosyada
`https://open-play.b4klabs.dev/docs/tr/llms.txt`	Türkçe dizin
`https://open-play.b4klabs.dev/docs/tr/llms-full.txt`	Türkçe belgelerin tamamı tek dosyada

İngilizce dosyalar https://open-play.b4klabs.dev/docs/llms.txt ve https://open-play.b4klabs.dev/docs/llms-full.txt adreslerinde de durur. Her sayfanın markdown kopyası, HTML adresinin .html yerine .md ile bittiği adrestedir (ör. https://open-play.b4klabs.dev/docs/en/auth/guest.md). Dosyalar belge sitesiyle birlikte yenilenir.

Örnek sorular

“Bir oyuncuyu misafir olarak nasıl girdiririm?” → search_docs + read_doc (auth/guest).
“Oyuncu verisini nasıl kaydederim?” → guides/player-data.
“Bir eklentiyi nasıl çağırırım?” → plugins/calling-plugins.
“Unity’de PlayerSession hangi yöntemlere sahip?” → get_sdk_symbol.

İlk bakış için Hızlı başlangıç sayfasından başlayın. Ajanınızın oyununuzda Open Play’i doğru kullanması için deponuza koyacağınız hazır kural dosyası: Oyununuz için AGENTS.md.

Keyboard shortcuts