MCP Mode

Friday Dev supports Model Context Protocol (MCP) for seamless IDE integration.

What is MCP?

Model Context Protocol (MCP) is a standard for connecting AI models to development tools. It enables:

• IDE integration - Use Friday Dev from your editor
• Tool sharing - AI agents access the same tools
• Context passing - Share project context with AI

Starting MCP Mode

# Start Friday Dev as MCP server
friday-dev --mcp

# With specific transport
friday-dev --mcp --transport stdio

VS Code Integration

Install Extension

1. Open VS Code
2. Go to Extensions
3. Search "Friday Dev"
4. Install the extension

Configure Extension

Add to VS Code settings (settings.json):

{
  "friday-dev.enabled": true,
  "friday-dev.autoStart": true,
  "friday-dev.serverPath": "friday-dev",
  "friday-dev.mcpEnabled": true
}

Using Friday Dev in VS Code

1. Open Command Palette (Cmd/Ctrl + Shift + P)
2. Type "Friday Dev"
3. Select a command:
   • Create Task
   • Run Agent
   • View Tasks
   • Open Dashboard

Cursor Integration

Setup

1. Open Cursor settings
2. Go to "MCP Servers"
3. Add Friday Dev:

{
  "mcpServers": {
    "friday-dev": {
      "command": "friday-dev",
      "args": ["--mcp"]
    }
  }
}

Using with Cursor

Friday Dev tools are available in Cursor's AI chat:

@friday-dev create task "Add login page"
@friday-dev run agent gemini on task 123
@friday-dev list tasks

MCP Configuration

Server Configuration

{
  "mcp": {
    "enabled": true,
    "transport": "stdio",
    "capabilities": {
      "tools": true,
      "resources": true,
      "prompts": true
    }
  }
}

Transport Options

Transport	Description	Use Case
stdio	Standard I/O	IDE extensions
http	HTTP server	Web integrations
sse	Server-sent events	Real-time apps

Available Tools

When running in MCP mode, Friday Dev exposes these tools:

Task Management

Tool	Description
create_task	Create a new task
list_tasks	List tasks with filters
update_task	Update task properties
delete_task	Delete a task

Agent Execution

Tool	Description
run_agent	Run AI agent on task
stop_agent	Stop running agent
get_logs	Get agent execution logs

Project Management

Tool	Description
list_projects	List all projects
get_project	Get project details
create_project	Create new project

Tool Schemas

create_task

{
  "name": "create_task",
  "description": "Create a new task in Friday Dev",
  "parameters": {
    "type": "object",
    "properties": {
      "title": {
        "type": "string",
        "description": "Task title"
      },
      "description": {
        "type": "string",
        "description": "Task description"
      },
      "priority": {
        "type": "string",
        "enum": ["low", "medium", "high", "urgent"]
      },
      "labels": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["title"]
  }
}

run_agent

{
  "name": "run_agent",
  "description": "Run an AI agent on a task",
  "parameters": {
    "type": "object",
    "properties": {
      "task_id": {
        "type": "integer",
        "description": "Task ID to run agent on"
      },
      "agent": {
        "type": "string",
        "enum": ["friday", "claude", "gemini", "codex", "glm", "qwen"],
        "description": "Agent to use"
      },
      "autonomy": {
        "type": "string",
        "enum": ["workspace-write", "skip-permissions-unsafe"],
        "default": "workspace-write"
      }
    },
    "required": ["task_id", "agent"]
  }
}

Resources

MCP resources provide access to data:

task://

Access task information:

task://123           - Get task by ID
task://list          - List all tasks
task://search?q=auth - Search tasks

project://

Access project data:

project://my-project - Get project
project://list       - List projects

logs://

Access execution logs:

logs://task/123      - Logs for task
logs://agent/456     - Logs for agent run

Prompts

Pre-configured prompts for common operations:

create-feature

Creates a new feature implementation task with best practices

fix-bug

Creates a bug fix task with debugging context

review-code

Initiates a code review for recent changes

Custom MCP Servers

Add additional MCP servers to Friday Dev:

{
  "mcp": {
    "servers": [
      {
        "name": "filesystem",
        "command": "mcp-filesystem",
        "args": ["--root", "/workspace"]
      },
      {
        "name": "github",
        "command": "mcp-github",
        "env": {
          "GITHUB_TOKEN": "your-token"
        }
      }
    ]
  }
}

Debugging MCP

Enable Debug Logging

RUST_LOG=debug friday-dev --mcp

Test with MCP Inspector

npx @modelcontextprotocol/inspector friday-dev --mcp

Common Issues

Connection Failed

1. Check Friday Dev is running
2. Verify transport configuration
3. Check firewall settings

Tools Not Available

1. Verify MCP mode is enabled
2. Check capabilities configuration
3. Restart the MCP server

Permission Errors

1. Check autonomy settings
2. Verify file system permissions
3. Review security configuration

Next Steps

• CLI Commands - Full command reference
• AI Agents - Agent capabilities
• Configuration - Config options