Skip to main content
1

Install Muse Code

2

Ask Muse to add the server

Start muse and ask:
Muse writes the config and names the server, usually spiral.
3

Sign in

In your terminal, run:
Use the name Muse chose if it differs. Your browser opens: sign in to Spiral, pick the organization and click Authorize. No API key. The running session picks up the sign-in without a restart.
4

Check it

It shows Spiral and its sign-in status. Inside a session, /mcp lists the connected servers and their tools.
5

Try a starter prompt

Put this in ~/.config/muse/settings.json, then run muse mcp login spiral. The file must include "schema_version": 1. If it already has a server block (mcp_servers or mcpServers), add Spiral to that block instead of adding a second one:
"mode": "optional" lets Muse start without Spiral when it cannot reach it.
Create a key in the console under API keys, keep it in SPIRAL_API_KEY, and add the header to the Spiral entry. Muse reads the key from your environment:
If something does not work, see Troubleshooting.