Skip to main content
Claude Code runs in a separate terminal, so you keep Monk open in your IDE and launch Claude Code in the same project directory. The Monk MCP server is enabled automatically during setup and writes the config Claude Code needs.
Coming soon: Headless mode — plug Monk directly into Claude Code without running a separate IDE window. Upvote it on our roadmap.

​
Prerequisites

Make sure you have completed the Monk setup and the MCP server step shows as running in the setup screen.

​
Setup

1

Open Claude Code in the same directory

Launch Claude Code from the terminal in the same project root. It picks up the Monk entry from ~/.claude.json automatically.Claude Code MCP Enablement
2

Verify Monk is listed

Run /mcp inside Claude Code. Monk should appear in the server list for the current project.
3

Start using Monk

Ask Claude Code to use Monk for deployment, infrastructure, or runtime tasks.Claude Code communicating with Monk

Deploy your first app

Monk is connected — now deploy your project

​
Troubleshooting

If Monk does not appear in /mcp, confirm that the IDE with Monk is still running with the same project open and that MCP is enabled for this workspace. Restarting Claude Code in the project directory usually resolves config detection issues.

More troubleshooting

Common issues and how to fix them