Setup takes under a minute. Grab your API key, paste it into your client’s config, and start asking your assistant to run workflows.
1. Get your API key
Open app.magica.com, then Settings → API Keys → Manage to create or copy a key. This is the same Bearer token used for the REST API.
Step-by-step API key walkthrough
See the full Authentication page for click-by-click screenshots, rate limits,
key rotation, and revocation.
Treat the key like a password — store it in your password manager or a .env
file, never in committed code.
2. Connect your client
Pick your assistant below. Replace YOUR_API_KEY with the key from step 1.
Claude Code
Claude Desktop
Codex
Cursor
Add the MCP server via CLI
Run this in your terminal: Verify the server is registered
You should see magica in the output. Start using tools
Open a new Claude Code session and ask it to list your workflows or start a run.
Open Claude settings
Launch the app or open claude.ai and go to Settings → Connectors. Add a custom connector
Click Add custom connector, name it Magica, and paste the URL: Connect and sign in
Click Add → Connect, then authenticate with your Magica Auth. You’re all set — ask Claude to list or run a workflow.
Edit your claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop and the Magica tools will appear in the tool picker. Add the MCP server via CLI
Run this in your terminal: Authenticate
On first use, Codex will prompt you to provide your Magica API key. Paste the gx_… token from app.magica.com. Start using tools
Open a new Codex session and ask it to list your workflows or start a run.
Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):Restart Cursor — the Magica tools appear in the chat tool picker. If you’re using Claude Code or Codex, prefer the CLI install — it’s
faster and avoids hand-editing JSON.
Your AI assistant now has access to the Magica MCP tools. Try one of these prompts:
- “List my workflows.”
- “Build a workflow that takes a prompt and generates an image with Flux 2 Pro.”
- “Run the Nano Banana Pro model on this image and add a dog to the scene.”
See Available Tools for the full list. 
