Claude Code Integration

Here's how to connect Hackle MCP in Claude Code, Anthropic's official CLI.

1

Register the MCP server

claude mcp add --transport http hackle-mcp https://mcp.hackle.io/mcp

By default, it is registered only locally for the current project. To use it across all projects:

claude mcp add --transport http --scope user hackle-mcp https://mcp.hackle.io/mcp

2

Authenticate

Inside a Claude Code session:

/mcp

You'll see an indicator next to hackle-mcp showing that authentication is required. When you select the item, a browser opens and displays the Hackle authentication screen. Paste your Hackle API key into the API key field and proceed.

3

Verify the connection

/mcp

Once the hackle-mcp status shows as connected, you're all set. You can use the tools in a new prompt.

Migrating from a Local Server

If you were previously using a local MCP server (in the form of an npm package) registered with Claude Code, you can follow the steps below to move to the remote server.

1. Remove the existing local server

claude mcp list                          # Check the registered name
claude mcp remove hackle-mcp             # Change it accordingly if the name is different

2. Register the remote server

Register by following Method A or Method B above. You can use the same API key value you were using before.

3. Clean up the local server package (optional)

If you have a globally installed npm package, remove it.

npm uninstall -g @hackle-io/hackle-mcp