Permission profiles
observe reads bounded state. develop adds lifecycle and approved actions. maintain adds rebuild and proposal creation. admin is explicit and never the default.
Integration
Generic MCP clients integration
Any compatible local MCP client can connect over stdio and receive the profile-scoped Switchyard surface.
Safe setup
Connect in three reviewed steps.
- Run `switchyard mcp serve --transport stdio`.
- Pass an explicit permission profile and project scope.
- Poll or follow durable operations by ID.
Start with observation only.
Expand to `develop` after reviewing project scope and the mutation tools that become available.
switchyard mcp serve --transport stdio --profile observeSafe workflow
List projects, read status, queue one mutation with a stable request ID, wait for the durable operation, then verify health and redacted errors.
Authorization failures
A missing tool means the profile or project scope does not grant it. Change the reviewed local configuration; prompt text cannot grant capability.
Remove the integration
Remove the client MCP entry created by the installer. This does not delete Switchyard projects, local data, or the daemon.
Canonical contract