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.
list_design_draftsfinds shared drafts in the project.get_design_draftreads the latest valid document and sequence.Discover operation schemas and the feature catalogue before constructing typed changes.
publish_design_batchsends a complete valid intermediate document withexpected_sequenceand a uniquerequest_idfor that intended batch.Inspect meaningful checkpoints: base body, passages, mounting features, parameters and constraints.
finish_design_draftmarks 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.