Protocol method · collab
collab.claim
Claim entities, components, documents or files for your turn, with an expiry. Advisory only; never blocks edits.
- Scope:
edit:scene - Service:
collab - MCP:
ara_sessionwith"action": "claim"
Params
| Param | Required | Description |
|---|---|---|
session | yes | Session handle from session.begin. |
subjects | yes | What to claim: entity IDs or addresses (e_door01), name:Gate Door, a component or field of one (e_door01.Light), a document path (levels/outpost.scene), or another project file (@scripts/Gate.cs). |
doc | Document the entities are in; default: the one document holding them. | |
why | Why, shown to everyone (tuning the gate). | |
ttlMs | Lifetime without heartbeats in ms (default 60000; presence updates and collab.heartbeat extend it). |