Skip to main content

Requirements

Before you begin, you must have the following:

Install the Transform MCP server

You should be able to instruct Cline to install the Transform MCP server by asking Cline the following:
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.
  1. In Visual Studio Code, on the Activity Bar, click the Cline icon.
  2. At the top of the Cline pane, click the MCP Servers icon.
  3. Click the Installed tab, and then click Configure MCP Servers. Cline opens its cline_mcp_settings.json settings file in a new editor tab.
  4. Add the following entry to the mcpServers object, replacing <your-unstructured-api-key> with your Unstructured API key:
    Use the server URL exactly as shown. Do not add /mcp or /sse to the end of the URL.The "type": "streamableHttp" setting is required. Also, the Authorization value must start with Bearer before your API key.
  5. Save the cline_mcp_settings.json file.
  6. Back on the Installed tab, confirm that the unstructured-transform server shows a green status indicator and lists four tools: request_file_upload_url, transform_files, check_transform_status, and get_transform_results.
  7. 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.
  • 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 Cline about these limits. Because of this, Cline should notify you whenever it encounters a file that exceeds 50 MB in size. Also, Cline 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, in Visual Studio Code, open the folder that stores the files you want Transform to parse (from the main menu, click File > Open Folder).
  2. In the Cline pane, enter the following prompt:
    As needed, adapt the phrase in this project in the preceding prompt to indicate a more specific project folder. Also, as needed, guide Cline 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: Control how the Unstructured Transform MCP server instructs Transform to partition, enrich, chunk, and embed the data based on your files.
  • Control Transform generated sample 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?