Chosen speaks MCP, the protocol AI assistants use to work in other apps. Add Chosen as a connector in Claude, ChatGPT or Claude Code, sign in with your Chosen account, and the assistant can do what you can do in Chosen — read, search, and (after asking you) act. This page is how to connect, what it can do, and how to cut it off.
Connect your assistant
- Copy the server URL. In the hiring app it's in Settings → Developers. In the recruit portal it's in Settings → Connect AI. It's the same address either way.
- Add it to your assistant. In Claude (claude.ai or the desktop app): Settings → Connectors → Add custom connector, and paste the URL. In ChatGPT: Settings → Apps & Connectors → Advanced, turn on developer mode, then create a connector with the URL. Claude Code and other command-line tools connect with an API key instead of signing in:
claude mcp add --transport http chosen <the URL> --header "Authorization: Bearer <your key>". - Sign in to Chosen when Claude or ChatGPT asks. It's your normal Chosen login, Google included. (Command-line tools skip this step: the API key is the sign-in.)
- Ask it something. "What's on my desk?" or "Which candidates are waiting for my review?" is a good first test.
The connection acts as you. It can't see anything you can't, and your role in each workspace still decides what it may change.
Which workspace it works in
If you belong to more than one workspace, the assistant has to know which one you mean.
- Marketplace tools find the right workspace on their own. Recruiter tools work in your recruiter workspace; hiring-side tools work in your company. If you're in several companies, the assistant asks which one — or you can name it.
- Everything else (candidates, jobs, scheduling) works in your default workspace. Ask the assistant to list your organizations and it shows each one's id and type, then it can switch.
What recruiters can do
From the recruit portal's side of the marketplace, an assistant can:
- Read My Desk: every role you work, each candidate and where they stand, and what needs you.
- Browse roles, read a role's full brief and the client's intake call, and apply to work a role.
- Add a candidate to a role, which sends them to Chosen for review — with your take and the notes you choose. New candidates can come from pasted resume text.
- Edit your take and write-up, share notes, re-run the AI match report, withdraw or reopen a packet.
- Send and resend consent requests, message the client, check your earnings, update your profile, and send the note-taker to a screening call.
Money is always your side of it: your rate and what you'd earn, exactly as the portal shows it.
What hiring teams can do
From a company workspace, an assistant can:
- List your marketplace roles and the recruiters working them, and see the candidates recruiters sent.
- Accept a candidate (they land in your pipeline), decline with a reason and a note the recruiter reads, or undo an accept made by mistake.
- Put a job on the marketplace (as a draft, or published), edit its terms, pause or close it, and message recruiters.
Candidates only appear once Chosen has reviewed them — same as in the app.
It asks before it acts
Assistants are built to ask before they change something, and Chosen tells them to: adding a candidate to a role, a consent email, a message, a decision. Read what it proposes before you say yes. Your answers are the brakes.
Chosen's own rules still apply underneath. A recruiter workspace on an outdated agreement has to sign the new one in the portal before the marketplace tools work again. Every packet still goes through Chosen's review before a client sees it.
Use an API key instead
Command-line clients like Claude Code, and anything else that can't sign in through a browser, use an API key as a bearer token instead. Owners and Admins create keys; if your role can't, ask one of them. A key is narrower than signing in: it works only in the workspace it was created in, with the role you gave it, and it never carries Chosen admin access. A key-based tool doesn't appear under connected apps; revoke the key to cut it off.
Disconnect an assistant
Settings → Developers (hiring app) or Settings → Connect AI (recruit portal) lists the apps signed in. Disconnect one and it loses access right away, everywhere. For an API key, revoke the key.
What it can't do
It can't upload files — paste resume text instead of attaching a PDF. It can't sign the recruiter agreement for you; a signature is yours to give. And it can't see another recruiter's candidates, which, given what assistants will cheerfully attempt, is a feature.