Skip to content
Docs/SUPPORT

Troubleshooting

Start with the situation that matches what you see.

Find your purchase and license key

After purchase, your Lemon Squeezy receipt provides access to your download and license key. Check spam if the receipt is missing, or open My Orders using your purchase email address.

Install the app, open Settings → License, enter your key and a device name, then choose Activate this Mac. An internet connection is required. Activation is complete when Pro appears.

Changing Macs and working offline

Activate up to two Macs used by you. Before changing Macs, deactivate the old Mac in Settings → License, then use the same key on the new Mac. If the old Mac is unavailable, contact us below with your order number.

Pro works offline for 30 days after the last successful verification. Reconnect and choose Verify license after that period. See the license details.

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.

Still need help or want to request a refund?

Start with the FAQ and the steps above. For bug reports, improvements and other suggestions, use Settings → Feedback in the app. Feedback submission is being prepared ahead of the app release.

Use email only for unresolved purchase or activation issues, refund requests, or critical problems such as being unable to launch the app and submit feedback: [email protected].

For purchase questions, include your order number and purchase email address. For bugs, include your macOS and app versions, steps to reproduce, and the error message. Do not send your full license key or files containing personal information.

Feedback helps us improve FolderNode, but individual replies and timelines for fixes or features are not guaranteed. Instant email replies and one-to-one training are not offered.