Files
penpot/mcp/docs/multi-user-mode.md
Dominik Jain 880b9b61c4 🎉 Integrate mcp repository
Original repository: https://github.com/penpot/penpot-mcp
Imported commit: fcfa67e908fc54e23a3a3543dee432472dc90c5d
2026-02-04 12:22:36 +01:00

1.5 KiB

Multi-User Mode

Warning

Multi-user mode is under development and not yet fully integrated. This information is provided for testing purposes only.

The Penpot MCP server supports a multi-user mode, allowing multiple Penpot users to connect to the same MCP server instance simultaneously. This supports remote deployments of the MCP server, without requiring each user to run their own server instance.

Limitations

Multi-user mode has the limitation that tools which read from or write to the local file system are not supported, as the server cannot access the client's file system. This affects the import and export tools.

Running Components in Multi-User Mode

To run the MCP server and the Penpot MCP plugin in multi-user mode (for testing), you can use the following command:

npm run bootstrap:multi-user

This will:

  • launch the MCP server in multi-user mode (adding the --multi-user flag),
  • build and launch the Penpot MCP plugin server in multi-user mode.

See the package.json scripts for both mcp-server and penpot-plugin for details.

In multi-user mode, users are required to be authenticated via a token.

  • This token is provided in the URL used to connect to the MCP server, e.g. http://localhost:4401/mcp?userToken=USER_TOKEN.
  • The same token must be provided when connecting the Penpot MCP plugin to the MCP server.
    In the future, the token will, most likely be generated by Penpot and provided to the plugin automatically. ⚠️ For now, it is hard-coded in the plugin's source code for testing purposes.