İlk Araç Çağrısı

NEXUS'un yerel MCP sunucusu nexus-mcp, stdio üzerinden yeni-satırla ayrılmış JSON-RPC 2.0 konuşur: satır başına bir mesaj, gömülü yeni satır yok. Bu sayfadaki örnekler okunabilirlik için birden çok satıra yayılmıştır — kablo üzerinde her biri tam olarak tek bir satırdır. Sözleşmenin bir parçası olmaktan çok örnek niteliğindeki alan değerleri (önbellek ömürleri, sürüm dizeleri) bu şekilde işaretlenmiştir; alan adları ve hata kodları gerçek sözleşmedir.

nexus-mcp iki protokol sürümünü destekler: 2026-07-28 (güncel) ve 2025-06-18 (eski). Bir istemcinin hangisini kullandığı, bir initialize el sıkışmasına ihtiyaç duyup duymadığını belirler.

Modern istemciler (2026-07-28)

Bu sürümde bir initialize el sıkışması yoktur. Bunun yerine her istek, protokol sürümünü ve normalde çağıran istemcinin kimliğini ve yeteneklerini adlandıran bir _meta bloğu taşır:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "server/discover",
  "params": {},
  "_meta": {
    "io.modelcontextprotocol/protocolVersion": "2026-07-28",
    "io.modelcontextprotocol/clientInfo": {
      "name": "example-cli",
      "version": "1.0.0"
    },
    "io.modelcontextprotocol/clientCapabilities": {}
  }
}

server/discover, 2026-07-28 oturumu için zorunludur — bir istemcinin başka herhangi bir şeyi çağırmadan önce bu sunucunun neler sunduğunu öğrenmesinin yoludur:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "supportedVersions": ["2026-07-28", "2025-06-18"],
    "capabilities": {
      "toolNamespaces": ["canvas", "agent"]
    },
    "resultType": "server/discover",
    "ttlMs": 60000,
    "cacheScope": "session",
    "_meta": {
      "io.modelcontextprotocol/serverInfo": {
        "name": "nexus-mcp"
      }
    }
  }
}

Bu sunucudaki her sonuç resultType taşır; liste döndüren sonuçlar — bunun gibi — ayrıca çağırana sonucu ne kadar süre güncel sayabileceğini ve ne kadar geniş kullanabileceğini söyleyen ttlMs ve cacheScope da taşır. Yukarıdaki ttlMs ve cacheScope'un tam değerlerini bu sayıları varsaymak yerine örnek niteliğinde değerlendirin — bunları kendi yanıtınızdan okuyun. toolNamespaces içindeki araç adları burada değil, MCP araçları referansında (EN) sayılır.

Sürüm desteklenmiyorsa

_meta'sı supportedVersions dışında bir sürüm adlandıran bir istek, params'ın geri kalanına dokunmadan hemen reddedilir:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "server/discover",
  "params": {},
  "_meta": {
    "io.modelcontextprotocol/protocolVersion": "2024-01-01"
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "error": {
    "code": -32022,
    "message": "Unsupported protocol version",
    "data": {
      "supported": ["2026-07-28", "2025-06-18"],
      "requested": "2024-01-01"
    }
  }
}

data.supported ve data.requested bu hatada her zaman mevcuttur, böylece bir istemci kendisinin de konuştuğu daha eski bir sürümde yeniden denemek isteyip istemediğine karar verebilir.

Eski istemciler (2025-06-18)

Klasik MCP el sıkışmasına karşı inşa edilmiş bir istemcinin yukarıdakilerin hiçbirine ihtiyacı yoktur — standart initialize yöntemi değişmeden çalışmaya devam eder:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "example-cli",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": {
      "tools": {}
    },
    "serverInfo": {
      "name": "nexus-mcp"
    }
  }
}

Bir 2025-06-18 oturumu, server/discover sonuç zarfını (resultType, ttlMs, cacheScope) kazanmaz — bu alanlar güncel sürüme aittir. Bir istemcinin klasik el sıkışma ve tools/call hakkında zaten bildiği her şey değişmeden geçerlidir.

Sırada

Her iki dönem de buradan aynı iki araç ad alanına ulaşır. Gerçek bir oturum içinde ilk araç çağrınızı yapmak için Draw a diagram from an agent (EN) sayfasına devam edin, veya tam sözleşme için MCP protocol reference (EN) sayfasını okuyun.

Bu aynı zamanda Getting Started yolunun son sayfasıdır — bu dokümantasyonun kapsadığı her şeyin bir haritası için Sırada ne var sayfasına bakın.