XPlanner

Docs

MCP Bridge

MCP bridge için resource seçimi, idempotency ve açık onay header'ları.


MCP

Resource seçimini bridge'e taşı

MCP Worker, kullanıcının seçtiği çalışma alanı ve hesapları internal bridge'e header olarak gönderir; bridge bu seçimleri synthetic identity içinde uygular.

x-mcp-workspace-ids virgülle ayrılmış workspace id listesi taşır.

x-mcp-account-ids virgülle ayrılmış account id listesi taşır.

Geçersiz veya boş seçim header'ları fail-closed reddedilir; seçili kaynak erişimi dışındaki kayıtlar reddedilir.

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ıyla hizalıdır; 501 dönen public API eşdeğer tool kalmamalıdır.