> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Monk with Claude Code

> Enable Monk MCP and make it available to Claude Code

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](/getting-started/installation) and writes the config Claude Code needs.

<Info>
  Want to use Monk without the IDE extension? Install the [Monk agent plugin](/getting-started/agent-plugin-installation) with `/plugin marketplace add monk-io/monk-plugin`.
</Info>

## Prerequisites

Make sure you have completed the [Monk setup](/getting-started/installation) and the MCP server step shows as running in the setup screen.

## Setup

<Steps>
  <Step title="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.

    <img src="https://mintcdn.com/monk-d20f97b6/1MBQcqAy6NTCaI3t/assets/Claude_cli_mcp_enablement.gif?s=855ebd1ba4c1104fdafbd34139dda747" alt="Claude Code MCP Enablement" height="200" className="rounded-lg" data-path="assets/Claude_cli_mcp_enablement.gif" />
  </Step>

  <Step title="Verify Monk is listed">
    Run `/mcp` inside Claude Code. Monk should appear in the server list for the current project.
  </Step>

  <Step title="Start using Monk">
    Ask Claude Code to use Monk for deployment, infrastructure, or runtime tasks.

    <img src="https://mintcdn.com/monk-d20f97b6/1MBQcqAy6NTCaI3t/assets/Claude_cli_communication_with_monk_cursor.gif?s=e65c1d4b08f3a2d992738b07b1432ef7" alt="Claude Code communicating with Monk" height="200" className="rounded-lg" data-path="assets/Claude_cli_communication_with_monk_cursor.gif" />
  </Step>
</Steps>

<Card title="Deploy your first app" icon="rocket" href="/getting-started/first-deployment" color="#3B82F6">
  Monk is connected — now deploy your project
</Card>

<Card title="Install the agent plugin" icon="plug-circle-plus" href="/getting-started/agent-plugin-installation">
  Direct Claude Code plugin setup and troubleshooting
</Card>

## 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.

<Card title="More troubleshooting" icon="wrench" href="/getting-started/troubleshooting-installation">
  Common issues and how to fix them
</Card>