VSCode + Cline Setup

VSCode + Cline MCP Setup

Configure Forge as an MCP server for the Cline extension in VSCode.

Prerequisites

Install Cline Extension

Open VSCode
Go to Extensions (Cmd/Ctrl + Shift + X)
Search for “Cline”
Install the Cline extension

Install Forge

npm install -g @automagik/forge

Get Project ID

npx automagik-forge

Copy UUID from browser URL:

http://localhost:3000/projects/a1b2c3d4-e5f6-7890-abcd-ef1234567890/tasks
                                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Configuration

Option 1: Via Cline Settings UI

Open Cline Settings

Press Cmd/Ctrl + Shift + P
Type “Cline: Settings”
Select and open

Add MCP Server

In the MCP Servers section, add:Name: automagik-forge Command: npx Args: automagik-forge --mcp Project ID: your-project-uuid-here

Save and Restart

Save settings and reload VSCode window

Option 2: Via JSON Configuration

Open Settings JSON

Cmd/Ctrl + Shift + P
“Preferences: Open Settings (JSON)”

Add Configuration

{
  "cline.mcpServers": [
    {
      "name": "automagik-forge",
      "command": "npx",
      "args": ["automagik-forge", "--mcp"],
      "env": {
        "PROJECT_ID": "your-project-uuid-here"
      }
    }
  ]
}

Reload VSCode

Cmd/Ctrl + Shift + P → “Developer: Reload Window”

Advanced Mode

For power users:

{
  "cline.mcpServers": [
    {
      "name": "automagik-forge",
      "command": "npx",
      "args": ["automagik-forge", "--mcp-advanced"],
      "env": {
        "PROJECT_ID": "your-project-uuid-here"
      }
    }
  ]
}

Usage with Cline

Task Management

You: "Create a task to implement Redis caching"

Cline: [Uses MCP to create task in Forge]

Cline: "Task #47 created. Should I start implementing it?"

Planning

You: "Help me plan an e-commerce checkout flow"

Cline: [Creates multiple tasks via MCP]

Cline: "Created 6 tasks:
       - Cart management
       - Payment integration
       - Order processing
       - Email notifications
       - Receipt generation
       - Error handling"

Troubleshooting

Cline can't find MCP server

Check Forge is installed: npm list -g @automagik/forge
Verify JSON syntax in settings
Reload VSCode window
Check Cline output panel for errors

Project ID invalid

Open Forge: npx automagik-forge
Verify project exists
Copy correct UUID
Update settings
Reload VSCode

Tools not working

Ask Cline: “What MCP tools do you have?”If automagik-forge doesn’t appear, check configuration.

Getting Started

Learn

Configuration

Reference

Troubleshooting

VSCode + Cline MCP Setup

Prerequisites

Configuration

Option 1: Via Cline Settings UI

Option 2: Via JSON Configuration

Advanced Mode

Usage with Cline

Task Management

Planning

Troubleshooting

Next Steps

MCP Overview

MCP Tools

​VSCode + Cline MCP Setup

​Prerequisites

​Configuration

​Option 1: Via Cline Settings UI

​Option 2: Via JSON Configuration

​Advanced Mode

​Usage with Cline

​Task Management

​Planning

​Troubleshooting

​Next Steps

MCP Overview

MCP Tools

VSCode + Cline MCP Setup

Prerequisites

Configuration

Option 1: Via Cline Settings UI

Option 2: Via JSON Configuration

Advanced Mode

Usage with Cline

Task Management

Planning

Troubleshooting

Next Steps