Skip to content
Docs/SUPPORT

Troubleshooting

Start with the situation that matches what you see.

Cannot connect to MCP

  1. Check that FolderNode is running and Settings → MCP is enabled.
  2. Choose STDIO as the connection type.
  3. Arguments should contain just one path, without JSON braces or surrounding quotes.
  4. Check that the environment variable key is FOLDERNODE_MCP_SOCKET.
  5. If you moved the app, copy fresh connection settings from FolderNode.
  6. Fully quit and reopen the AI app.

Return to the field-value helper →

“node not found” or “ENOENT”

First check that the configured app path exists. If Node.js is missing, install the macOS LTS version from the official website.

If it is installed but cannot be found, open Terminal on your Mac and enter:

which node

Paste the returned path in place of node in Launch command. If no path appears, check your Node.js installation.

No saved workflows appear

An untouched blank canvas is not a saved workflow. Add nodes and configure the input, output and action in FolderNode. After the edits save, ask for the list again.

The preview is no longer valid

Previews expire after five minutes and can be run once. Changes to the workflow or to the detected files/destinations may also require a new preview.

Preview the workflow again using its current state.

Cannot run, or want to stop processing

MCP cannot start new work while watching, processing or the guided tour is active. Stop watching, close the tour, or wait for the current run. On the free plan, reduce the input if it exceeds 10 files.

Cancel from FolderNode’s run dialog. If the AI started the run, you can also ask the AI to cancel it. Outputs already created remain.

An accepted run continues if MCP is disabled or the AI disconnects. After a timeout, check Settings → History before running again.