docs: define streaming mcp architecture

This commit is contained in:
a.tolmachev
2026-04-06 01:45:48 +03:00
parent d7e5ae95d6
commit 04ed704e94
12 changed files with 834 additions and 29 deletions
+17 -3
View File
@@ -130,6 +130,7 @@ Crank - платформа для публикации внешних API в в
- `Workspace` как tenant boundary.
- Операции `REST`, `GraphQL`, `unary gRPC`.
- Controlled streaming operations поверх `Streamable HTTP`, REST SSE и gRPC server-streaming.
- `Agent` и привязка операций к агенту.
- Agent-scoped MCP endpoints.
- Platform API keys.
@@ -141,7 +142,8 @@ Crank - платформа для публикации внешних API в в
### Не входит
- gRPC streaming.
- GraphQL `subscription`.
- gRPC client-streaming и bidirectional streaming.
- SOAP.
- Оркестрация workflow.
- Биллинг.
@@ -201,10 +203,20 @@ GraphQL в MCP публикуется как фиксированная опер
### gRPC
- только unary RPC;
- unary RPC;
- bounded server-streaming через `window`, `session` и `async_job` execution modes;
- `.proto` и `descriptor set`;
- JSON-oriented schema model поверх protobuf;
- без streaming.
- без client-streaming и bidi.
### Streaming
Платформа поддерживает controlled streaming model:
- downstream transport: `Streamable HTTP` с optional SSE;
- upstream streaming: REST SSE и gRPC server-streaming;
- execution modes: `unary`, `window`, `session`, `async_job`;
- никакого raw infinite stream passthrough в MCP client.
## 8. Работа с файлами и автогенерация черновика
@@ -234,6 +246,8 @@ GraphQL в MCP публикуется как фиксированная опер
- `Agent`
- `AgentVersion`
- `AgentOperationBinding`
- `StreamSession`
- `AsyncJobHandle`
- `AuthProfile`
- `PlatformApiKey`
- `UserSession`