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
Claude Code integration
Claude Code receives the same bounded tools, permission profiles, and audited operation contracts as other MCP clients.
Safe setup
Connect in three reviewed steps.
- Run `switchyard agent install claude`.
- Review the generated local MCP configuration.
- Start a scoped project session or connect from Claude Code.
Start with observation only.
Expand to `develop` after reviewing project scope and the mutation tools that become available.
switchyard agent install claude --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