MCP servers
Give your bots more tools from an MCP server, or let another AI app work with your Murage team.
Add your own MCP server
Give your bots tools from an MCP server you trust.
Step 1
Open MCP servers
Open Connected apps from the sidebar and switch to MCP servers.
You're done when: you see the MCP servers tab.
Step 2
Add the server
Press Add server and paste a link, a command or a config snippet. Murage works out the type. If the server needs a sign-in, you get a Sign in to… button. If you were given a token instead of a sign-in, see Add an MCP server with a token instead of a sign-in.
You're done when: Murage has the server listed.
Step 3
Save, test and turn it on
- Choose Save. A new server is saved switched off.
- Choose Test to start it briefly and see the tools it offers.
- Choose Turn on.
You're done when: the server is on.
The server's tools become available to bots whose engine supports MCP servers, such as Claude Code, Codex and the ACP engines, from their next task. No restart is needed.
Use Murage from another AI app
The desktop app includes its own MCP server, so another MCP app on your computer can work with your Murage team while Murage is running. It can:
- list your bots and channels and what they're doing;
- read and search conversations;
- create bots, channels and tasks;
- send work to a bot or channel and wait for the result;
- switch an idle bot to another available model.
Connect it
To connect it on a Mac, add this to your MCP app's settings:
{
"mcpServers": {
"murage": {
"command": "/Applications/Murage.app/Contents/MacOS/Murage",
"args": ["/Applications/Murage.app/Contents/Resources/server/mcp-server.js"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}
On Windows, use the installed Murage.exe as the command and the resources\server\mcp-server.js file next to it as the argument, usually under %LOCALAPPDATA%\Programs\Murage. On Ubuntu .deb installs, use /opt/Murage/murage and /opt/Murage/resources/server/mcp-server.js. Keep the same ELECTRON_RUN_AS_NODE setting. To give another app or script access to just one bot, add a token and port as shown in Use Murage from Claude Code, Codex and other AI apps.