Get Started

Integrating the Pieces MCP with ChatGPT Developer Mode brings your workflow context directly into ChatGPT in your browser. ChatGPT Developer Mode requires a remote HTTPS URL—localhost will not work. You must expose PiecesOS via ngrok or another HTTPS proxy first.

**Remote HTTPS required:** ChatGPT Developer Mode cannot use localhost. You must expose PiecesOS via ngrok or another HTTPS tunnel before adding the connector. **Plans required:** ChatGPT Developer Mode is available on Pro, Plus, Business, Enterprise, and Education plans. Status: Beta.

Prerequisites

There are three prerequisites for integrating Pieces with ChatGPT Developer Mode:

Ensure you have a Pro, Plus, Business, Enterprise, or Education ChatGPT plan. PiecesOS must be running locally. This is *required* for the MCP server to provide your workflow data. Expose PiecesOS via an ngrok tunnel to get a public HTTPS URL. The tunnel must be active when you add the connector and when you use ChatGPT. See [ngrok Setup](/products/mcp/ngrok-setup) for detailed instructions.

Installing PiecesOS & Configuring Permissions

Follow the instructions below for a detailed guide on setting up and configuring PiecesOS to correctly pass captured workflow context to the Pieces MCP server.

Setting Up ChatGPT Developer Mode

ChatGPT uses a Connectors UI to add MCP servers. You cannot add localhost URLs—only remote HTTPS endpoints.

Setup Steps

Open [chatgpt.com](https://chatgpt.com) in your browser. Click your **profile icon** → **Settings**. Go to **Connectors** in the sidebar. Scroll to the bottom and click `Advanced Settings`. Toggle `Developer Mode (beta)` ON. Return to **Connectors** and click `Create` (appears after enabling Developer Mode). * **Connector name:** `Pieces LTM` * **MCP Server URL:** `https://YOUR_NGROK_URL.ngrok-free.app/model_context_protocol/2025-03-26/mcp` * **Description:** (optional) `Search and retrieve from Pieces Long-Term Memory` Click `Create` to save the connector. The URL must point to the `/mcp` endpoint path. Subdirectory paths like `/functions/v1/mcp` do not work.

Using Pieces MCP Server in ChatGPT

Once integrated, you can utilize Pieces LTM directly in ChatGPT.

Start a new conversation in ChatGPT. Look for the **tools indicator** in the chat. Ask: *"What tools do you have from Pieces?"* Try: *"What did I work on yesterday?"* ChatGPT will use the `ask_pieces_ltm` tool to query your Long-Term Memory. Check out this [MCP-specific prompting guide](/products/mcp/prompting) if you want to effectively utilize the Long-Term Memory Engine (LTM-2.7) with your new Pieces MCP server.

Updating

To update the ngrok URL after a tunnel restart:

  1. Go to Settings > Connectors
  2. Find "Pieces LTM" and click Edit
  3. Update the MCP Server URL
  4. Save

Troubleshooting

If you're experiencing issues integrating Pieces MCP with ChatGPT Developer Mode:

  1. Cannot Use localhost: ChatGPT requires public HTTPS. Use ngrok or another HTTPS proxy.

  2. Connector Not Connecting: Ensure the ngrok tunnel is running and the URL is accessible in a browser.

  3. Authentication Required: Use no-auth mode; Pieces does not need OAuth.

  4. Tools Not Appearing: Refresh the page after adding the connector.

  5. Developer Mode Not Visible: Ensure you are on a supported plan (Pro/Plus/Business/Enterprise/Education).

  6. Write Actions Need Confirmation: By default, writes require manual approval in ChatGPT.

You're now set to enhance your ChatGPT workflow with powerful context retrieval through Pieces MCP. Happy coding!