# MCP support — Pieces

Connect Pieces MCP to Cursor, VS Code, and other AI tools.

[← All support](/support)

## MCP Help & Learning

Connect your AI tools to Pieces memory, verify PiecesOS, and troubleshoot local or remote MCP access.

Learn the requirements, local endpoint, and supported clients.
Add Pieces MCP to Cursor and verify the available tools.
Configure Pieces MCP for VS Code and GitHub Copilot.
Connect a remote client through the supported tunnel workflow.

## Quick fixes

### MCP tools are not available or returning errors

MCP clients require PiecesOS to be running and Long-Term Memory to be enabled before tools like `ask_pieces_ltm` will work.

1. Confirm PiecesOS is running. Look for the Pieces icon in your system tray or menu bar.
2. Open the **PiecesOS Quick Menu** and verify **LTM-2 Engine** is enabled.
3. Restart your MCP client (Cursor, VS Code, Claude Desktop, etc.) after PiecesOS starts.
4. If issues persist, restart PiecesOS and the client together.

MCP overview

### Client cannot find or connect to PiecesOS

Most MCP clients connect to PiecesOS at `http://localhost:1000`. Firewalls, VPNs, or incorrect config paths can block the connection.

1. Verify PiecesOS is running and check for update prompts.
2. Check your client's MCP config file. The server command should point to the Pieces MCP executable or use the one-click connection in Desktop.
3. Temporarily disable firewalls or VPNs to rule out network blocks.
4. On macOS/Linux, confirm the config path uses the correct home directory expansion.

[Cursor setup guide](https://docs.pieces.app/products/mcp/cursor)

### Setting up MCP for a remote or cloud client

Remote clients like cloud IDEs or hosted agents need a tunnel to reach PiecesOS on your local machine.

1. Install and configure `ngrok` or another tunnel service.
2. Start a tunnel to `localhost:1000` and note the public URL.
3. Update your remote client's MCP config to point to the tunnel URL instead of localhost.
4. Keep the tunnel running while using the remote client.

[ngrok setup guide](https://docs.pieces.app/products/mcp/ngrok-setup)

## Browse MCP clients

Open the setup guide for the tool you want to connect.

## Still need help?

Include your MCP client, operating system, and the connection error you see.

Ask the team and community about client configuration.
Report a reproducible MCP integration bug with your config and logs.
Send client and connection details directly to support.
Use a call when setup guides and support channels have not resolved the issue.