Appearance
Getting started
- Install and launch Sumeru. The funnel starts automatically and keeps running in the tray when you close the window.
- macOS (Apple Silicon and Intel): download
sumeru_<version>_universal.dmgfrom the latest release, open it, and drag Sumeru to Applications. It's a native menu-bar app: the Sumeru icon in the menu bar shows status, copies the endpoint, and opens the main window. Sumeru isn't notarized yet, so macOS blocks the first launch: open System Settings → Privacy & Security and click Open Anyway. If it still won't open, runxattr -dr com.apple.quarantine /Applications/Sumeru.appin Terminal. On first launch and after updates, macOS may ask to let sumeru use its keychain item; enter your password and click Always Allow (the endpoint starts once you answer). - Linux: AppImage,
.debor.rpmfrom the same release. - npm:
npm i -g sumeru-mcp && sumeru gui(CLI).
- macOS (Apple Silicon and Intel): download
- Open Configure. The endpoint URL and the Default API key are there; add more keys to scope agents to specific MCPs (Scoped API keys).

- Add MCPs via Marketplace (curated DCR HTTP MCPs) or Configure → Add MCP (stdio commands or HTTP MCP URLs — remote URLs need HTTPS; plain HTTP is loopback-only — see OAuth). The MCP list groups them by app — expand a row to see that app's accounts.

- Connect your agent from Configure → Connect an agent (Claude Code, Codex, Cursor, VS Code, Gemini CLI, Windsurf) — see Connect your agent.
Tray and pause
- Close the window → UI hides; endpoint keeps serving
- Tray → Open to show the UI again
- Tray → Quit to stop the endpoint
- Header Pause / Resume toggles the local funnel without quitting
Autostart
Enable Run at system startup on the Configure tab so Sumeru launches hidden in the tray after login. Prefer enabling this from an installed/release build so the OS entry points at a stable binary path.