Troubleshooting
App won't open (macOS) — 'Sery cannot be opened'
Cause: macOS Gatekeeper blocking an unsigned/un-notarized build
Solution:
- 1. System Settings → Privacy & Security → Security
- 2. Click "Open Anyway" next to the Sery message
- 3. Click "Open" in the confirmation
Workspace key doesn't work on the second machine
Cause: Key was rotated, revoked, or pasted with extra whitespace
Solution:
- 1. Open app.sery.ai → Settings → Workspace Keys and confirm the key is still active
- 2. Copy the key again — extra whitespace at either end will cause a silent reject
- 3. If the key was revoked or deleted, create a new one and paste it into Sery Link's Connect dialog
Claude Desktop doesn't see Sery's MCP tools
Cause: Config not saved correctly, or client wasn't restarted
Solution:
- 1. Confirm the config snippet from Settings → MCP is in claude_desktop_config.json
- 2. Confirm the command path actually points at the installed Sery Link binary
- 3. Test manually: run the command + args from a terminal — you should see "MCP stdio mode" and the process should wait on stdin
- 4. Quit Claude Desktop fully, then re-open. The hammer icon should list Sery's tools.
Folder scan stuck at 0%
Cause: Very large folder, permission denied, or network drive
Solution:
- 1. Wait 1–2 minutes for folders with 10,000+ files
- 2. Check that Sery has read permission on the folder (macOS: System Settings → Privacy → Files)
- 3. For network drives, try a smaller local copy first to confirm the pipeline works
Ready to get started?
Download Sery Link, pick a folder, ask your first question. No account required.
Download Sery Link