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

# Unstructured Transform MCP server installation for Devin Desktop (formerly the Windsurf IDE)

> Learn how to install the Unstructured Transform MCP server into Devin Desktop (formerly the Windsurf IDE). You can then point to your files and have Transform start producing partitioned, enriched, chunked, and embedded data based on your files in minutes.

## Requirements

Before you begin, you must have the following:

* A Devin account. To see if you have a plan, [log in to your Devin account](https://app.devin.ai/auth/login). [Sign up for Devin](https://app.devin.ai/auth/signup).
* Devin Desktop installed on your local development machine. [Install Devin Desktop](https://devin.ai/download).

## Install the Transform MCP server

<Tip>
  You should be able to instruct Devin Desktop to install the Transform MCP server by asking Devin Desktop the following:

  ```text theme={null}
  Install the Unstructured Transform MCP server by using these instructions: 
  https://docs.unstructured.io/transform/install/devin-desktop.md
  ```

  If this does not work, to install the Transform MCP server manually, complete the following steps.

  If you are able to successfully connect, skip ahead to [parse your source files](#parse-your-source-files).
</Tip>

1. Start Devin Desktop.

2. On the menu bar, click **Devin > Settings > Devin Settings**.

3. On the **Devin Settings** sidebar, under **Devin Local**, click **Configuration**.

4. Next to **MCP servers**, click **Open Devin MCP marketplace**.

5. On the **Devin MCP Marketplace** editor tab, next to **Devin MCP Marketplace**, click **Add custom MCP**.

   Devin Desktop opens its `config.json` settings file in a new editor tab. This file is typically located at:

   * For macOS and Linux: `~/.config/devin/config.json`
   * For Windows: `%APPDATA%\devin\config.json`

6. Add the following entry to the `mcpServers` object:

   ```json theme={null}
   {
     "mcpServers": {
       "transform": {
         "serverUrl": "https://mcp.transform.unstructured.io",
         "transport": "http"
       }
     }
   }
   ```

7. Save and close the `config.json` file.

8. Back in the **Devin MCP Marketplace** editor tab, in the **Installed** area, next to **transform**, click **Connect**.

9. A web browser tab will appear, prompting you to authenticate with Transform. Follow the on-screen directions to finish authenticating.

10. After you authenticate, the Transform MCP server is ready for you to start using.

## Parse your source files

Parsing requests have the following limits:

* Each file must be of a [supported file type](/transform/supported-file-types).
* Each file must be 50 MB or less in size.
* Each request must have 10 files or fewer.
* Only 5 requests can be running at a time.

The Transform MCP server is designed to notify Devin Desktop about these limits. Because of this, Devin Desktop should notify you whenever it encounters a file that exceeds 50 MB in size. Also, Devin Desktop should formulate strategies to send requests that are 10 files or fewer and not cause more than 5 requests to be running at a time.

1. After you install the Transform MCP server, open the folder that stores the files you want Transform to parse (from the main menu, click **File > Open Folder**).

2. In the **Agent** sidebar (from the main menu, click **View > Appearance > Agent Sidebar**), click **New Session**.

3. Next to the prompt box, in the agent picker, select **Devin Local**, if it is not already selected. (Additional choices can include **Cascade** and **Devin Cloud**).

   <img src="https://mintcdn.com/unstructured-53/6_ATPDAxldrFwJfS/img/transform/devin-agent-picker.png?fit=max&auto=format&n=6_ATPDAxldrFwJfS&q=85&s=688254970a0365c46b04227639b3655e" alt="Choosing the agent source from Devin Desktop" width="1560" height="496" data-path="img/transform/devin-agent-picker.png" />

   <Note>
     If **Devin Local** does not appear in the agent picker, do the following to show it:

     1. In Devin Desktop, open the Command Palette (from the main menu, click **View > Command Palette**).
     2. In the Command Palette, enter `>Open Devin User Settings` (remember to begin this command with `>`).
     3. In the **Devin Settings** editor tab, on the sidebar, click **Agents**.
     4. In the **Agents** section, turn on the switch labelled **Enable ACP**, if it is not already turned on.
     5. If **Devin Local** does not show as **Enabled**, click the **Enable** button.
     6. Go back to the agent picker. **Devin Local** should now appear.
   </Note>

4. In the prompt box, enter the following prompt:

   ```text theme={null}
   Use the Unstructured Transform MCP server to parse the files in this project.

   Provide the results as JSON files, one JSON file per source file.
   ```

   As needed, adapt the phrase `in this project` in the preceding prompt to indicate a more specific project folder. Also, as needed, guide Devin Desktop as to where to write Transform's output into the project.

   Transform parses your input files and delivers its results to you as a set of output files, one output file per input file.

## Next steps

* [Control Transform file parsing output](/transform/output): Control how the Unstructured Transform MCP server instructs Transform to partition, enrich, chunk, and embed the data based on your files.
* [Control Transform structured data extraction](/transform/sde): Control how the Unstructured Transform MCP server extracts and formats structured data from your files.
* [Control Transform generated sample code](/transform/code): Control how the Unstructured Transform MCP server generates sample curl or Python code that demonstrates how to use Transform to partition, enrich, chunk, and embed the data based on your files.

## Questions? Need help?

* For technical support, [request support](/support/request).