Shared authoring with agents

Use a shared authoring draft when an external MCP agent should develop a model visibly inside Studio. Start an External agent draft in the project, then let the agent discover that draft through the central API/MCP service.

  1. list_design_drafts finds shared drafts in the project.

  2. get_design_draft reads the latest valid document and sequence.

  3. Discover operation schemas and the feature catalogue before constructing typed changes.

  4. publish_design_batch sends a complete valid intermediate document with expected_sequence and a unique request_id for that intended batch.

  5. Inspect meaningful checkpoints: base body, passages, mounting features, parameters and constraints.

  6. finish_design_draft marks the work ready or cancelled at the current sequence.

Batch validation is atomic: a failed batch preserves the last valid model. Reuse the same unchanged request ID after network uncertainty; re-read and reconcile sequence conflicts. get_design_checkpoint retrieves earlier immutable checkpoints.

Ready work enters Studio’s normal proposal/revision review. Finishing the draft does not bypass engineer acceptance. A standalone call_design_operation response is only a candidate document and does not update the shared draft by itself.

For the handoff, summarize the change, checks performed, unresolved engineering assumptions and physical output names. Retain source identities and units throughout. See the MCP catalogue for complete arguments.