Skip to main content

​
VSCode + Cline MCP Setup

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

​
Prerequisites

1

Install Cline Extension

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

Install Forge

npm install -g @automagik/forge
3

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

1

Open Cline Settings

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

Add MCP Server

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

Save and Restart

Save settings and reload VSCode window

​
Option 2: Via JSON Configuration

1

Open Settings JSON

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

Add Configuration

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

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

  1. Check Forge is installed: npm list -g @automagik/forge
  2. Verify JSON syntax in settings
  3. Reload VSCode window
  4. Check Cline output panel for errors
  1. Open Forge: npx automagik-forge
  2. Verify project exists
  3. Copy correct UUID
  4. Update settings
  5. Reload VSCode
Ask Cline: “What MCP tools do you have?”If automagik-forge doesn’t appear, check configuration.

​
Next Steps

MCP Overview

Learn about MCP

MCP Tools

Available tools