MCP bağlantısı

https://docs.sarraf.net/mcp Streamable HTTP adresidir. search_docs ve get_api_operation herkese açıktır. read_api_operation her çağrıda x-api-key başlığı ister ve yalnız ilan edilmiş GET işlemlerini yürütür.

Postman koleksiyonunu içe aktarın

Postman koleksiyonunu indir

1. JSON dosyasını indirin. Postman’da Import → Files ile dosyayı seçin veya aşağıdaki adresi Import alanına yapıştırın:

   https://docs.sarraf.net/examples/sarraf-mcp.postman_collection.json

2. Sarraf MCP · Streamable HTTP örnekleri adlı koleksiyonu içe aktarın.

3. 01 · Bağlantıyı başlat isteğini gönderin. Sunucunun kabul ettiği protokol sürümü protocol_version değişkenine yazılır.

4. Başlatma bildirimi, Araçları listele, Dokümanlarda ara ve API işlem sözleşmesi isteklerini sırayla deneyin. Bildirim için 202 ve boş yanıt normaldir.

5. Yetkili kategori okuması için kendi mağazanızın yetkili anahtarını yalnız yerel api_key değişkenine girin. Örnekte anahtar boştur; anahtarı paylaşılan dosyaya kaydetmeyin.

Koleksiyon, normal HTTP istekleriyle altı JSON-RPC örneği içerir. Eski /examples/sarraf-mcp.json indirme adresi de aynı import edilebilir koleksiyonu sunar.

Postman’ın MCP istemcisiyle bağlanın

New → MCP → HTTP seçip adres alanına doğrudan https://docs.sarraf.net/mcp yazın. Load Capabilities ile araçları yükleyin.

search_docs ve get_api_operation anahtarsız kullanılabilir. read_api_operation için Authorization → API Key ayarında anahtar adını x-api-key, konumunu Header seçin. Değeri kendi yerel/gizli değişkeninizden alın.

Diğer MCP istemcileri

Aşağıdaki ayarı istemcinizin MCP yapılandırmasına ekleyin. Bu bir sunucu bağlantı ayarıdır; Postman’ın Import → Files adımı için yukarıdaki koleksiyonu kullanın.

{
  "mcpServers": {
    "sarraf": {
      "url": "https://docs.sarraf.net/mcp"
    }
  }
}

Başlık destekleyen istemcide yetkili okumalar için x-api-key gizli başlığını ayarlayın. API anahtarı araç argümanı değildir. OAuth giriş akışı yoktur.

Protokol ve yanıtlar

• Transport: Streamable HTTP.
• Başlıklar: Content-Type: application/json, Accept: application/json, text/event-stream.
• MCP-Protocol-Version, initialize yanıtındaki sürümle eşleşmelidir.
• Sunucu stateless çalışır; Mcp-Session-Id saklamak gerekmez.
• Araç sonuçları result.content alanındadır. isError: true, araç çağrısının başarısız olduğunu belirtir.

Önce get_api_operation ile işlem kimliğini ve parametreleri alın, ardından read_api_operation çağırın. Yazma, SQL ve keyfi URL çalıştırma yoktur. Son koleksiyon isteği gerçek mağaza verisini okuyabilir; diğer örnekler public doküman ve sözleşme bilgisidir.

/mcp makine bağlantı adresi, /mcp-guide/ ise bu rehberdir. Postman MCP belgesi.