Skip to main content
Compatibility

Claude Code

Set up Mouse with Claude Code: MCP configuration for both the UI and CLI

Prerequisites

  • VS Code 1.85 or later
  • Claude Code (latest version recommended)
  • Node.js 20.x or later

Installing Mouse

  1. Open the Extensions panel in VS Code (Ctrl+Shift+X / Cmd+Shift+X)
  2. Search for Mouse by HIC AI, Inc.
  3. Click Install
  4. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run Mouse: Initialize Workspace

This creates a .hic directory in your project and generates the MCP configuration file at .mcp.json.

Configuration

The workspace initialization creates the following configuration automatically. If you need to configure it manually, create .mcp.json at your project root with:

{
  "mcpServers": {
    "hic_local": {
      "command": "node",
      "args": ["${workspaceFolder}/.hic/mcp/src/core/server.js"],
      "env": {
        "HIC_AGENT_ADAPTER": "claude",
        "HIC_ALLOWED_DIRECTORIES": "${workspaceFolder}"
      }
    }
  }
}

NOTE

Claude Code and Claude Code CLI use the same MCP configuration. Claude Code is a UI wrapper around the CLI, so there is no difference in setup or usage between the two.

Verifying the Connection

Ask your AI assistant:

"Use Mouse's get_file_metadata tool to check the metadata of any file in this workspace."

If the assistant successfully calls the tool and returns file metadata, Mouse is working correctly. Check the status bar; it should show Mouse: Trial or Mouse: Licensed.