diff --git a/nuxt/content/changelog/2026/10/mcp-tool-permissions.md b/nuxt/content/changelog/2026/10/mcp-tool-permissions.md new file mode 100644 index 0000000000..354fc8e7a8 --- /dev/null +++ b/nuxt/content/changelog/2026/10/mcp-tool-permissions.md @@ -0,0 +1,42 @@ +--- +title: Tool Permissions for MCP Agents +description: AI agent access is now Read, Write or Destructive, set separately for platform and flow building tools, and different for each team. +date: 2026-10-08 12:00:00 +release: "3.2" +authors: ["andrea-palmieri"] +tags: + - changelog +issues: + - https://github.com/FlowFuse/flowfuse/issues/8741 +--- + +Until now, an AI agent that signed in to FlowFuse over OAuth got one choice: read-only or read and write. That choice applied to every team the agent could reach, and to everything it could do. + +You now choose from three levels instead: + +- **Read**: look at things, change nothing. +- **Write**: create and update things. Includes Read. +- **Destructive**: delete or overwrite data, or change what is running. Includes Write and Read. + +Platform tools and Flow Building tools are set separately. Platform tools manage instances, snapshots, pipelines and the rest of FlowFuse, while Flow Building tools edit flows in the Node-RED editor. An agent can, for example, create and update snapshots while only being able to read your flows. + + + +Permissions are now per team as well. Pick **All teams** or **Specific teams**, then select **Edit** next to a team to give it its own permissions. Your production team can stay read-only while the agent has full access in a sandbox team. + +A request for something the agent was not granted in that team is refused, so you stay in control even when the agent decides to try. + +To connect an agent with specific permissions: + +1. Add the FlowFuse MCP endpoint to your agent and sign in. +2. On the authorization page, tick the permissions for **Platform** and **Flow Building**. +3. Choose which teams the agent can reach, and edit individual teams if they need different permissions. +4. Set an expiry date and select **Allow**. + +You can see a summary of each connection's permissions in the token list under **User Settings > Security**. + +This applies to agents that connect over OAuth. Personal access tokens keep their existing Read Only option. + +This is available now on FlowFuse Cloud and will land in FlowFuse v3.2 for Self Hosted. + +See [what agents can do](/docs/user/mcp/) and how to [connect your own agent](/docs/user/expert/third-party-agents/). diff --git a/nuxt/public/changelog/2026/10/images/mcp-tool-permissions.webm b/nuxt/public/changelog/2026/10/images/mcp-tool-permissions.webm new file mode 100644 index 0000000000..7ced9f8593 Binary files /dev/null and b/nuxt/public/changelog/2026/10/images/mcp-tool-permissions.webm differ diff --git a/nuxt/redirects-node-red.ts b/nuxt/redirects-node-red.ts index 627a7fdf19..6dc0956085 100644 --- a/nuxt/redirects-node-red.ts +++ b/nuxt/redirects-node-red.ts @@ -83,6 +83,7 @@ const moved: Record = { '/node-red/flowfuse/edge/modbus/': '/docs/flowfuse-nodes/edge/modbus/', '/node-red/flowfuse/edge/opcua/': '/docs/flowfuse-nodes/edge/opcua/', '/node-red/flowfuse/edge/rtsp/': '/docs/flowfuse-nodes/edge/rtsp/', + '/node-red/flowfuse/edge/s7/': '/docs/flowfuse-nodes/edge/s7/', '/node-red/flowfuse/flowfuse-tables/': '/docs/flowfuse-nodes/flowfuse-tables/', '/node-red/flowfuse/flowfuse-tables/query/': '/docs/flowfuse-nodes/flowfuse-tables/query/', '/node-red/flowfuse/hub/': '/docs/flowfuse-nodes/hub/',