Geliştiriciler için

Bir istemcinin sunucu hakkında bilmesi gerekenler ve sunucunun, arada bir asistan olmadan nasıl çağrılacağı.

Sunduğumuz biçimiyle protokol

  • https://api.publicwww.com/mcp adresinde Streamable HTTP: her POST için bir JSON-RPC mesajı (toplu gönderim de kabul edilir), yanıtlar düz application/json. Server-sent events yok, oturum yok: her istek kendi token'ını taşır. GET isteği 405 döndürür.
  • Protokolün iki kuşağı da aynı URL'de sunulur: initialize el sıkışmasını kullanan sürümler (2024-11-05 ile 2025-11-25 arası) ve server/discover kullanan 2026-07-28. Bu sonuncusunda sürüm ve istemci yetenekleri her isteğin params._meta alanında taşınır, Mcp-Method / Mcp-Name başlıkları da gövdeyle eşleşmelidir.
  • Token yoksa ya da silinmiş bir token gönderilirse her istek 401 döndürür; yanıttaki WWW-Authenticate başlığı korunan kaynak meta verilerini (RFC 9728) gösterir, OAuth istemcisi yetkilendirme sunucusunu buradan bulur. Akış Uygulamalar için OAuth 2.1 bölümünde.
  • Araçlar: search ve account, Araçlar sayfasında açıklanıyor. Kaynak (resources) ve istem şablonu (prompts) yok; liste çağrılar arasında değişmez.
  • Token olmadan da sunucu kartı sunucuyu tanımlar: ad, adres, protokol sürümleri ve bağlantılar. Kart https://publicwww.com/.well-known/ai-catalog.json içinde listelenir. Araç listesi kartta yer almaz; istemci bir token edindikten sonra tools/list ile alınır.

curl ile çağırma

Sunucu çağrılar arasında durum tutmaz, bu yüzden bir araç el sıkışma olmadan doğrudan çağrılabilir: 

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
          "params":{"name":"search","arguments":{"query":"\"angular.min.js\"","rows":3}}}'

Araç listesi ve girdi şemaları: 

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Bu çağrılar ve bir hesap kontrolü tek bir betikte: mcp-curl.sh.

Yalnızca arama sonuçlarına ihtiyaç duyan bir betik için REST API daha basit bir yoldur: aynı arama ve aynı token, CSV, NDJSON ve diğer biçimlerle.

Sonraki Diller