Install in Claude Code

This guide walks you through installing Mistflow in Claude Code, Anthropic’s CLI for Claude.

Automatic install (recommended)

1. Run the installer

   npx @mistflow/installer

   The installer detects Claude Code and adds Mistflow’s MCP config automatically.

2. Log in

   Your browser will open to app.mistflow.dev. Sign in (or create an account), and the installer will store your API key locally.

3. Verify

   Open Claude Code in any project directory:

   claude

   Then ask:

   What Mistflow tools are available?

   Claude should list the tools: plan-app, init-project, deploy, etc. You’re all set.

Manual install

If you prefer to configure things yourself:

1. Get your API key

   Log in to app.mistflow.dev, go to Settings, and copy your API key.

2. Add to Claude Code config

   Edit your Claude Code MCP config (usually ~/.claude/mcp.json):

   {
     "mcpServers": {
       "mistflow": {
         "command": "npx",
         "args": ["-y", "@mistflow/mcp"],
         "env": {
           "MISTFLOW_API_KEY": "mist_your_key_here"
         }
       }
     }
   }

3. Restart Claude Code

   Close and reopen Claude Code. The MCP server will start automatically.

Caution

Never commit your API key to version control. The installer stores it in your local environment, not in project files.

Updating

To update to the latest version of the MCP server:

npx @mistflow/installer --update

Or manually update the npx call — npx -y @mistflow/mcp always pulls the latest published version.

Troubleshooting

Problem	Solution
”No MCP tools found”	Restart Claude Code. Check that ~/.claude/mcp.json has the mistflow entry.
”Authentication failed”	Re-run npx @mistflow/installer to refresh your API key.
”Command not found: npx”	Install Node.js 20+ from nodejs.org.

For more help, see Troubleshooting.