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

# Connect Reap MCP To VS Code

> Add Reap to VS Code as an HTTP MCP server, sign in with OAuth, and use Reap tools from Copilot agent mode to clip, caption, reframe, dub, and publish.

> **For AI agents:** a documentation index is at [/llms.txt](/llms.txt). Every page is also available as markdown, just append `.md` to the URL.

## Overview

VS Code reads MCP servers from an `mcp.json` file and exposes their tools in **agent mode**. You add Reap as an HTTP server, sign in through OAuth, and pick the workspace VS Code is allowed to use.

<Note>
  VS Code uses a different JSON shape than Cursor: the top-level key is `servers` (not `mcpServers`), and remote servers need `"type": "http"`.
</Note>

## Before You Start

* Your Reap workspace must be on a paid plan with API access enabled.
* Use a recent version of VS Code with GitHub Copilot enabled, and switch the Chat view to **Agent** mode.
* You need access to the Reap workspace you want to connect.

## Reap MCP Server URL

```text theme={"system"}
https://mcp.reap.video/mcp
```

## Add Reap To VS Code

<Steps>
  <Step title="Choose workspace or global">
    For a single project, create `.vscode/mcp.json` in the project root. To make Reap available everywhere, open the Command Palette and run **MCP: Open User Configuration**, which opens the `mcp.json` in your user profile.
  </Step>

  <Step title="Add the Reap server">
    ```json theme={"system"}
    {
      "servers": {
        "reap": {
          "type": "http",
          "url": "https://mcp.reap.video/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Start the server">
    Save the file. VS Code shows a **Start** action above the server entry. Click it, or run **MCP: List Servers** from the Command Palette and start **reap**.
  </Step>

  <Step title="Sign in to Reap">
    VS Code prompts you to allow the server to sign in. Accept, then sign in to Reap, select the workspace VS Code is allowed to use, and click **Authorize**. Close the tab when you see **Authentication successful**.
  </Step>

  <Step title="Enable the tools in agent mode">
    Open the Chat view, switch to **Agent** mode, and click the tools icon to confirm the Reap tools are selected.
  </Step>
</Steps>

<Tip>
  You can also add the server from the terminal with `code --add-mcp`, or just ask Copilot in agent mode to add `https://mcp.reap.video/mcp` for you.
</Tip>

## Confirm The Connection Works

Run **MCP: List Servers** from the Command Palette. **reap** should be running. Then ask in agent mode:

```text theme={"system"}
What Reap tools do you have access to?
```

## Use Reap From VS Code

```text theme={"system"}
Clip the best moments from this video and keep them under 60 seconds: <url>
```

```text theme={"system"}
Reframe my last upload to vertical 9:16 with the speaker centered.
```

## Troubleshooting

* **Server does not start?** Check the JSON shape. VS Code needs `servers` with `"type": "http"`. The `mcpServers` key is Cursor's format and will not work here.
* **No tools in chat?** Reap tools only appear in **Agent** mode. Switch modes, then check the tools picker.
* **Stuck unauthenticated?** Run **MCP: List Servers**, stop and restart **reap**, and accept the sign-in prompt.
* **Wrong workspace?** Restart the server, re-authorize, and pick the correct workspace on the Reap authorization screen.

## Learn More

* [Connect Reap MCP Server](/help-center/connect-reap-mcp-server)
* [Connect Reap MCP To Cursor](/help-center/connect-reap-mcp-to-cursor)
* [Reap MCP Guide](/help-center/reap-mcp-guide)
* [MCP API Reference](/api-reference/mcp)
* [Reap Dashboard](https://app.reap.video)
