Troubleshooting & FAQ¶
Common issues¶
| What you see | What's going on | Fix |
|---|---|---|
| "No active HireQuotient account for <email>" at sign-in | You logged in with a Google account that isn't an active EasySource user. | Sign out and use the work email that matches your EasySource login. |
| Claude can't connect / login won't open | The connector URL is wrong, or a network/VPN is blocking it. | Confirm the URL is exactly https://mcp.hirequotient.com/mcp. Try off-VPN. |
I don't see the prompts (/hq_help, etc.) |
The connector list hasn't refreshed. | Toggle the connector off and on once in Claude's settings. |
| A search or vetting run "stays pending" | The result is still being produced on EasySource's side. | Give it a bit and ask again - "is the search done yet?" This is timing, not an error. |
| "You need to add a few details first" | The search is missing a required filter (e.g. job title or location). | Add what Claude asks for, then say "run it." |
| Nothing is ranked yet | The project hasn't been vetted. | Run vetting first ("run vetting"), then "show top candidates." |
FAQ¶
Does Claude see all of EasySource? No - it acts as you, with exactly the access your EasySource user has. Same projects, same permissions.
Will it spend credits or change data without asking? No. Anything that spends credits (running a search) or changes a project (running vetting) asks you to confirm first. Listing, previewing, and viewing are read-only.
How are candidates ranked? Always by your project's star rating.
Can I use it outside claude.ai? Yes - it's a standard MCP server. It also works in Cursor and VS Code; see Getting started.
Where's my data? Everything lives in your existing EasySource account. The connector doesn't create a separate copy of your candidates or projects.
Still stuck?¶
If something looks like a real bug (a clear error, a tool that consistently fails), reach out to your HireQuotient contact with:
- what you typed,
- the project ID, and
- the exact message Claude returned.
That's enough to trace it quickly.