XPlanner

Docs

MCP Bridge

Resource selection, idempotency and explicit confirmation headers for MCP bridge.


MCP

Bağlamı araçlarla keşfet

MCP istemcisi önce çalışma alanı, Sosyal Set ve platform yetenek araçlarını çağırır; ardından dönen kimliklerle Public API sözleşmesine uygun işlem yapar.

xplanner_list_workspaces çalışma alanı bağlamını döndürür.

xplanner_list_social_sets X, LinkedIn ve Threads yayın hedeflerini döndürür.

xplanner_get_platform_capabilities metin ve medya sınırlarını canlı sözleşmeden okur.

API anahtarının workspace/account allowlist sınırları bridge içinde yeniden uygulanır.

Mutating çağrılar idempotent olur

MCP mutating route'ları API key FK'si kullanmadığı için ayrı MCP idempotency kaydıyla korunur.

Idempotency fingerprint method, path, query ve raw body üzerinden hesaplanır.

Aynı key farklı endpoint veya body ile tekrar kullanılırsa conflict döner.

MCP güvenlik header'ları

x-mcp-idempotency-key: mcp-run-001x-mcp-action-confirmed: true

Publish ve delete açık onay ister

MCP bridge, publish ve delete gibi riskli aksiyonları x-mcp-action-confirmed: true olmadan 428 confirmation_required ile reddeder.

posts:publish eski posts:write alias'ıyla verilmez.

delete scope'ları eski write alias'larıyla verilmez.

MCP tool şemaları backend route'ları ve OpenAPI ile doğrulanır; yeni ürün kabiliyeti API etkisi taşıyorsa bu yüzeyler aynı değişiklikte güncellenir.