> ## Documentation Index
> Fetch the complete documentation index at: https://docs.factory.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Model Context Protocol (MCP)

> Connect your own tools with Model Context Protocol

Model Context Protocol (MCP) servers extend droid's capabilities by providing additional tools and context. Droid offers two ways to manage them: an interactive UI for easy browsing and setup, or CLI commands for scripting and automation.

## Quick Start: Add from Registry

The easiest way to get started is using the built-in registry. Type `/mcp` in droid and select **"Add from Registry"** to browse 40+ pre-configured servers:

| Server     | Description                               |
| :--------- | :---------------------------------------- |
| figma      | Design exploration and implementation     |
| linear     | Issue tracking and project management     |
| sentry     | Error tracking and performance monitoring |
| notion     | Notes, docs, and project management       |
| supabase   | Create and manage Supabase projects       |
| stripe     | Payment processing APIs                   |
| vercel     | Manage projects and deployments           |
| playwright | End-to-end browser testing                |
| hubspot    | CRM data management                       |
| mongodb    | Database management                       |
| ...        | and many more                             |

Select a server from the list, authenticate if required (most HTTP servers support OAuth—just follow the browser prompt), and the server is ready to use.

<Tip>
  The registry is the fastest way to get started. For custom servers or automation, use the CLI commands below.
</Tip>

## Interactive Manager (`/mcp`)

Type `/mcp` within droid to open the interactive MCP manager. From here you can:

* **Browse servers** - See all configured servers and their connection status
* **View tools** - Inspect what tools each connected server provides
* **Enable/disable** - Temporarily disable servers without removing them
* **Authenticate** - Connect to OAuth-enabled servers via browser
* **Clear auth** - Remove stored credentials for a server
* **Add from registry** - One-click setup for popular MCP servers
* **Remove servers** - Delete user-configured servers

## Adding Servers via CLI

For scripting and automation, use `droid mcp add`. 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:**

```bash theme={null}
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

```bash theme={null}
droid mcp add sentry https://mcp.sentry.dev/mcp --type http
```

**Hugging Face** - Access Hugging Face Hub and Gradio AI applications

```bash theme={null}
droid mcp add hugging-face https://huggingface.co/mcp --type http
```

**Socket** - Security analysis for dependencies

```bash theme={null}
droid mcp add socket https://mcp.socket.dev/ --type http
```

#### Project Management & Documentation

**Notion** - Read docs, update pages, manage tasks

```bash theme={null}
droid mcp add notion https://mcp.notion.com/mcp --type http
```

**Linear** - Issue tracking and project management

```bash theme={null}
droid mcp add linear https://mcp.linear.app/mcp --type http
```

**Intercom** - Access customer conversations and tickets

```bash theme={null}
droid mcp add intercom https://mcp.intercom.com/mcp --type http
```

**Monday** - Manage monday.com boards and items

```bash theme={null}
droid mcp add monday https://mcp.monday.com/mcp --type http
```

#### Payments & Commerce

**Stripe** - Payment processing and subscriptions

```bash theme={null}
droid mcp add stripe https://mcp.stripe.com --type http
```

**PayPal** - PayPal commerce and payment processing

```bash theme={null}
droid mcp add paypal https://mcp.paypal.com/mcp --type http
```

#### Design & Media

**Figma** - Generate code with Figma context

```bash theme={null}
droid mcp add figma https://mcp.figma.com/mcp --type http
```

**Canva** - Browse, summarize, and generate Canva designs

```bash theme={null}
droid mcp add canva https://mcp.canva.com/mcp --type http
```

**TwelveLabs** - Video analysis, search, and AI-powered insights

```bash theme={null}
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

```bash theme={null}
droid mcp add netlify https://netlify-mcp.netlify.app/mcp --type http
```

**Vercel** - Manage projects, deployments, and logs

```bash theme={null}
droid mcp add vercel https://mcp.vercel.com/ --type http
```

**Stytch** - Configure authentication services

```bash theme={null}
droid mcp add stytch http://mcp.stytch.dev/mcp --type http
```

<Tip>
  Many HTTP servers require OAuth authentication. After adding, use the
  interactive `/mcp` UI to complete the authentication flow.
</Tip>

### Adding Stdio Servers

Stdio servers run as local processes on your machine - ideal for tools that need direct system access.

**Syntax:**

```bash theme={null}
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

```bash theme={null}
droid mcp add airtable "npx -y airtable-mcp-server" \
  --env AIRTABLE_API_KEY=your_key
```

**ClickUp** - Task management and project tracking

```bash theme={null}
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

```bash theme={null}
droid mcp add hubspot "npx -y @hubspot/mcp-server" \
  --env HUBSPOT_ACCESS_TOKEN=your_token
```

## Removing Servers

Remove a server from your configuration:

```bash theme={null}
droid mcp remove <name>
```

**Example:**

```bash theme={null}
droid mcp remove notion
```

## 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:

| Level       | Location              | Purpose                                          |
| :---------- | :-------------------- | :----------------------------------------------- |
| **User**    | `~/.factory/mcp.json` | Your personal servers, available in all projects |
| **Project** | `.factory/mcp.json`   | Shared team servers, committed to the repo       |

### How Layering Works

User config takes priority over project config. When both levels define the same server, the user-level settings win.

**Key behaviors:**

* When you **enable/disable** a project-defined server, a copy is saved to your user config with the new state. The original project config remains unchanged, so your teammates aren't affected.
* **Project servers cannot be removed** via CLI or the `/mcp` UI. To remove them, edit `.factory/mcp.json` directly.
* Servers you add via `droid mcp add` or the registry always go to your **user config**.

### OAuth Tokens

OAuth tokens are stored globally in your system keyring (or fallback file), **not per-project**. If you authenticate with a server in one project, you're authenticated everywhere that server is configured.

To clear authentication for a server, use the `/mcp` interactive manager and select "Clear Auth".

### Configuration Schema

Each server entry includes:

| Field           | Type                | Description                                       |
| :-------------- | :------------------ | :------------------------------------------------ |
| `type`          | `"stdio" \| "http"` | Server type                                       |
| `disabled`      | `boolean`           | Temporarily disable the server (default: `false`) |
| `disabledTools` | `string[]`          | List of tool names to disable for this MCP server |

For **stdio** servers:

* **command**: Executable to run
* **args**: Command-line arguments (array)
* **env**: Environment variables (object)

For **http** servers:

* **url**: HTTP/HTTPS endpoint URL
* **headers**: HTTP headers for authentication (object)

**Example `mcp.json`:**

```json theme={null}
{
  "mcpServers": {
    "linear": {
      "type": "http",
      "url": "https://mcp.linear.app/mcp",
      "disabled": false
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"],
      "disabled": false
    }
  }
}
```

Droid automatically reloads when the configuration file changes, so servers are immediately available after adding them.