Troubleshooting

Worktable does not open

Run:

worktable doctor

Check that the server is listening on the expected port and that packaged web assets are present.

My agent cannot connect

Confirm the MCP endpoint:

http://localhost:7480/mcp

If you set WORKTABLE_MCP_TOKEN, configure the same bearer token in the MCP client.

I cannot find my files

The default workspace folder is:

~/Worktable

If you selected a custom folder during setup, use worktable doctor to confirm the active workspace path.