Troubleshooting and errors

When a command fails, the tool result reads Error (exit <code>): <message> and is marked as an error. The message says what went wrong; the assistant usually explains it and suggests the next step. This page lists the messages you are most likely to see and what to do.

Connecting and signing in

What you seeWhat it meansWhat to do
Your app can't connect or reach the serverThe URL is wrong, or the connector is briefly unavailableCheck the URL is exactly https://mcp.pathwd.app/mcp, then try again in a few minutes
A connector page asks whether to allow an app with an unverified nameYou are connecting from an app the connector can't verify (Claude Code, Codex and others)Check the app name and the address it returns to, then choose Allow. Choose Deny if you didn't start this
PATHwd's sign-in page rejects your email or passwordThe same sign-in as the PATHwd web appCheck you can sign in at pathwd.app; reset your password there if needed
ERROR [401]: UnauthorizedThe sign-in expired or was revokedReconnect PATHwd in your app's connector settings
"This service is paused for your connection. Try again later or contact PATH support."PATHwd support paused the connector for your user or accountContact support
"To sign out, disconnect this MCP server in the app you connected it from …"Signing out from inside a chat isn't possibleDisconnect PATHwd in your app's settings

Accounts

MessageWhat it meansWhat to do
ERROR: Missing --account <id>. …No account is chosen yetSay which account to use ("use account 1234"), or ask which accounts you can open
ERROR: Account … isn't one of your accounts. …A wrong account number, or one you don't belong toAsk the assistant to list your accounts
ERROR: You're deactivated in account … (…), so you can't use it.Your membership in that account is deactivatedAsk that account's admin

"can't … as in the web app"

<user> can't <action> — <why>, as in the web app. means the PATHwd web app wouldn't let you do it either. Nothing changed. The <why> names the rule, for example "they don't have Edit permission on Jobs", "only the note's author can edit or delete it", or "it hasn't been shared with them". Ask an admin of your roles, or the owner of the report or calendar, if you need the access. No other tool gets around it.

Names that match nothing

Names are matched whole, ignoring case. A name that matches nothing gets up to three close suggestions (Field "Departmnt" not found on Job — did you mean "Department"?); a name that matches several things lists them with their ids. Something created moments ago in the web app may need the assistant to refresh the connector's cached design (clear-cache).

Deletes waiting for confirmation

MessageWhat it means
NOT DELETED: this needs confirmation.The first step of a permanent delete: nothing was deleted. The message names what would be deleted and gives a code. The delete happens only when the same command is sent with that code, after you say yes
NOT DELETED: confirmation code … doesn't match this delete (or has expired).The code was for a different command, or is over 20 minutes old. Nothing was deleted; the command is run again without a code for a new one

See Safety and confirmations.

Files

MessageWhat it meansWhat to do
"…" hasn't been uploaded yet: the file arrives through the link or the curl command request_file_upload returned. Nothing ran.The command ran before the file arrivedUpload the file through the link (or let the assistant run the upload command), then repeat
"…" is no longer available (uploads are kept for 24 hours). Request a new upload.Uploads are removed after a day, or after a command used them successfullyUpload it again
… is outside the workspace. …A command named a file on your computer; the connector can only use files in its workspaceUpload the file first; the assistant will offer a link
"…" already exists in the workspace (… bytes); it is kept. …A small workspace file already exists at that pathAsk to replace it, or use another name
Content is … KB; write_workspace_file takes up to … KB …Too big for a small workspace fileThe assistant uses an upload instead
The upload from Claude's code sandbox fails with a 403Claude's code execution isn't allowed to reach mcp.pathwd.appUse the upload link, or ask your Claude admin to allow mcp.pathwd.app for code execution
"This file is no longer available (downloads are kept for 24 hours)."A download link is older than a dayAsk for the file again
"This file was produced for another PATHwd user."Download links work only for the user they were made forAsk the person who requested it, or request it yourself

Limits

MessageWhat to do
Too many commands: slow down (per-connection limit). / (per-user limit).Wait a minute, then continue. Nothing changed
Another command on this connection is still running. …Wait for the other command (maybe in another chat) to finish
The server is busy; try again in a moment.Try again in a few seconds
Too many uploads this hour.Wait, or combine files
ERROR: the command took longer than 120s and was stopped. …It may have partly run. Check the record before trying again
ERROR: the command produced more than 1000000 bytes of output …Ask for fewer records or fewer columns

All limits: Limits.

Requests the connector doesn't take

MessageWhat it means
"api" isn't available on PATHwd: only the PATH CLI's own commands run here …Raw API calls are not offered; the tools cover the supported operations
"…" is run by <tool>, not <other tool>.The assistant sent a command to the wrong tool; it retries with the right one
"…" is not available on PATHwd: …A command the connector doesn't offer (sign-in, sign-out, raw API, pathway tests)
--json isn't available here: …Results come back as compact text
--base-url is not available here: the PATH API host is fixed for this connection.Commands always go to PATHwd's own API

Pathway runs

  • NOT RUN: Pathway <id> "<name>" has a step that shows a screen in the web app. …: nothing ran. The pathway needs answers on its screens, so it is run screen by screen instead.
  • ✗ <why> after an answer: the answer was refused (for example "… needs a number, got "abc""), and the run is still on the same screen with nothing on it saved.
  • A failed step names the step and its message, and the run ends. Steps that ran before it stay done.

Server errors: ERROR [<status>]: …

StatusUsual causeWhat to do
400 / 409 / 422A value the server won't take: the wrong type, a missing required value, a duplicateRead the message; it names the value
401The sign-in expiredReconnect PATHwd
403PATHwd's own permission checkAs for "can't … as in the web app" above
404No such record (or other item) for you in this accountCheck the account and search for it again
5xxPATHwd failedTry once more; if it fails again, contact support with the message

Still stuck

Contact support with what you asked, the app you used, the time, and the exact error message.

Thank you! Your message was sent. We'll be in touch soon.
Something went wrong. Please refresh the page and try again, or reach out directly by email.

Privacy Contact

If you have any questions, concerns, or requests related to our privacy policy, please contact us.

  • privacy@pathwd.com