User guide / Agent access to workspace context

Setting it up

Development reference · View source

1. Configure the agent to launch your Runyte binary with arguments ["mcp", "--identity", "agent"].
2. In each workspace to share, run :mcp agent using that same identity.
3. Choose permissions and select Apply permissions with Tab then Enter.

You may grant permissions before or after starting the agent. The built-in server always offers the same tools; each call checks the workspace grant. After changing permissions, have the agent run find_resources again to get fresh handles. Restart the agent once when changing its MCP configuration or upgrading from the Python bridge; permission changes do not require a restart.