Connected Systems
Each "system" is a SaaS application, on-prem system, or REST API with a connection (URL, auth, retries) and a catalog of commands the platform can run against it.
Object Types & Commands
Commands are the verbs (Get user, Create incident, Add to group). Object types group commands by the resource they operate on (User, Group, Ticket).
OAuth & Delegation
Configure OAuth presets, scopes, PKCE, and token enrichment. Delegation lets a workflow act on behalf of an end-user with a constrained scope.
MCP Tools
Expose commands as MCP tools so AI agents can call them in a typed, audited way. Tag with annotations, AI hints, and constrained delegation.
Schema Mapper & Fulfillment
Map a system's native schema to canonical objects (Person, Account, Group). Fulfillment defines which command fulfills each operation (create, update, delete, link).
OpenAPI Import
Bootstrap a system from an OpenAPI spec — paste a URL, upload a file, or drop the JSON in. Preview the inferred commands, then apply.
AI Assist NEW
Describe a connector in plain English and the System Definition Assistant drafts the YAML for you to review. Streaming chat, tool cards, validation built in, scoped chat history per system.
| Path | Screen |
|---|---|
| /systems | Connected Systems list — grid / table / tree / mind-map view of every registered system |
| /system-editor/new | Create a new system — opens the 11-tab editor in create mode (System Details, Connection, OAuth, Automation, Delegation, Designer, YAML Editor, MCP Tools, Fulfillment, API Docs, AI Assist) |
| /system-editor/<name> | Edit existing system — opens the 11-tab editor for that system |
Access is gated by a fine-grained set of resources under the
system-editor PDP application: system-editor:system, :type, :command, :schema, :fulfillment, plus yaml-editor, api-import, and bulk-operations. Each supports actions like view, create, edit, delete, test, override. A read-only operator can browse and test; only authorised authors can save changes.
Creating Your First System START HERE
Brand-new to System Editor? Register a connector end-to-end — name and type, base URL and auth, test the connection, add a command, and prove it returns real data — in about ten minutes.
Systems List
Open /systems, read the stats cards, switch grid / table / tree / mind-map, search and filter, paginate, and open or create a system.
System Details & YAML Editor
Editor shell, System | Type toggle, command palette, set name / version / tags, OpenAPI import wizard, YAML toolbar, save with concurrency conflict, and shortcuts.
Connection & Authentication
Connection tab (URL, auth, TLS, rate limit, retries, Test Connection), OAuth tab (presets, scopes, PKCE), Delegation broker, and Automation (webhook / poller).
Commands & Designer
Designer tab anatomy, add object types, add commands (with templates and parameter badges), MCP config inside commands, Schema Mapper, MCP Tools tab, Fulfillment tab.
Testing & API Docs
Open the Test System modal, configure parameters and run a command, read the response and error tabs, Quick Test from rows, and browse the auto-generated API Docs tab.
AI Assist — Generate & edit with AI NEW
Use the new AI Assist tab — describe a connector in plain English and the System Definition Assistant drafts the full YAML. Live tool cards, system-card preview, scoped chat history, auto-apply to the YAML editor.