Model Context Protocol (MCP) servers extend droid’s capabilities by providing additional tools and context. Droid offers two ways to manage them: CLI commands for quick setup and scripting, or an interactive UI for browsing and management.
Use CLI commands like droid mcp add for quick server setup and automation,
or use /mcp within droid for an interactive visual interface.
Adding Servers
The droid mcp add command adds MCP servers to your configuration. Droid supports two types of servers: http (remote endpoints) and stdio (local processes).
Adding HTTP Servers
HTTP servers are remote MCP endpoints - the recommended way to connect to cloud services and APIs.
Syntax:
droid mcp add <name> <url> --type http [--header "KEY: VALUE"...]
Arguments:
name - Unique server identifier
url - HTTP/HTTPS URL of the MCP server
--type http - Required flag to specify HTTP transport
--header "KEY: VALUE" - HTTP headers for authentication (can be used multiple times)
Popular HTTP MCP Servers
Development & Testing
Sentry - Monitor errors, debug production issues
droid mcp add sentry https://mcp.sentry.dev/mcp --type http
Hugging Face - Access Hugging Face Hub and Gradio AI applications
droid mcp add hugging-face https://huggingface.co/mcp --type http
Socket - Security analysis for dependencies
droid mcp add socket https://mcp.socket.dev/ --type http
Project Management & Documentation
Notion - Read docs, update pages, manage tasks
droid mcp add notion https://mcp.notion.com/mcp --type http
Linear - Issue tracking and project management
droid mcp add linear https://mcp.linear.app/mcp --type http
Intercom - Access customer conversations and tickets
droid mcp add intercom https://mcp.intercom.com/mcp --type http
Monday - Manage monday.com boards and items
droid mcp add monday https://mcp.monday.com/mcp --type http
Payments & Commerce
Stripe - Payment processing and subscriptions
droid mcp add stripe https://mcp.stripe.com --type http
PayPal - PayPal commerce and payment processing
droid mcp add paypal https://mcp.paypal.com/mcp --type http
Figma - Generate code with Figma context
droid mcp add figma https://mcp.figma.com/mcp --type http
Canva - Browse, summarize, and generate Canva designs
droid mcp add canva https://mcp.canva.com/mcp --type http
TwelveLabs - Video analysis, search, and AI-powered insights
droid mcp add twelvelabs-mcp https://mcp.twelvelabs.io --type http \
--header "x-api-key: YOUR_TWELVELABS_API_KEY"
Infrastructure & DevOps
Netlify - Create, deploy, and manage websites
droid mcp add netlify https://netlify-mcp.netlify.app/mcp --type http
Vercel - Manage projects, deployments, and logs
droid mcp add vercel https://mcp.vercel.com/ --type http
Stytch - Configure authentication services
droid mcp add stytch http://mcp.stytch.dev/mcp --type http
Many HTTP servers require OAuth authentication. After adding, use the
interactive /mcp UI to complete the authentication flow.
Adding Stdio Servers
Stdio servers run as local processes on your machine - ideal for tools that need direct system access.
Syntax:
droid mcp add <name> "<command>" [--env KEY=VALUE...]
Arguments:
name - Unique server identifier
command - Command to start the server (quote if it contains spaces)
--env KEY=VALUE - Environment variables (can be used multiple times)
Popular Stdio MCP Servers
Airtable - Read/write records, manage bases and tables
droid mcp add airtable "npx -y airtable-mcp-server" \
--env AIRTABLE_API_KEY=your_key
ClickUp - Task management and project tracking
droid mcp add clickup "npx -y @hauptsache.net/clickup-mcp" \
--env CLICKUP_API_KEY=your_key \
--env CLICKUP_TEAM_ID=your_team_id
HubSpot - Access and manage CRM data
droid mcp add hubspot "npx -y @hubspot/mcp-server" \
--env HUBSPOT_ACCESS_TOKEN=your_token
Removing Servers
Remove a server from your configuration:
Example:
Managing Servers
Type /mcp within droid to open an interactive UI for managing MCP servers.
- See all configured servers with status
- View all tools provided by each server
- Authenticate remote servers that require OAuth authentication
- Add/remove and enable/disable servers
Configuration
MCP server configurations can be stored at two levels:
- User-level:
~/.factory/mcp.json - applies to all projects
- Project-level:
.factory/mcp.json - applies only to the current project
Project-level configurations are merged with user-level configurations, allowing you to define project-specific MCP servers that are automatically available when working in that project.
The configuration includes:
- Name: Unique identifier for the server
- Type: Server type (
stdio or http)
- Stdio settings:
command, args, env (environment variables)
- HTTP settings:
url, headers (for authentication)
- Disabled: Boolean flag to temporarily disable a server
Droid automatically reloads when the configuration file changes, so servers are immediately available after adding them.