Start
Connect your agent
HiringOrchestrator is one MCP server. Add it to the agent you already use and it gains the full hiring workflow. The fastest path is the one-click installers on /install; the steps below are the same thing, explained.
The server URL
Every client connects to the same endpoint:
https://www.hiringorchestrator.com/api/mcpAuthentication is handled for you. Agent clients run OAuth on first use (no API key to paste); backends use a scoped API key. See Authentication.
Claude (web and desktop)
- Open claude.ai/settings/connectors.
- Click Add custom connector and paste the server URL.
- Sign in with your HiringTest account when Claude asks. The connection uses OAuth.
- Say “set up my hiring workspace” to begin.
Claude Code
One command in your terminal. Claude Code walks the OAuth sign-in on first use.
claude mcp add --transport http hiring-orchestrator https://www.hiringorchestrator.com/api/mcpPair it with the hiring-orchestrator skill for the triage, weekly-review, and req-to-offer playbooks.
ChatGPT
- Open Settings, then Connectors and enable Developer mode (Plus, Pro, Business, or Enterprise).
- Choose Add custom connector and paste the server URL.
- Authenticate with OAuth when prompted.
Cursor and VS Code
One-click installs are on /install. Both editors accept the server URL directly under their MCP settings: name it hiring-orchestrator, type http, URL the server above.
First prompts
Once connected, a few words get you moving. The agent reads first, then proposes:
- “Set me up” runs the workspace intake: departments, locations, and culture.
- “Import my ATS” starts the migration wedge (you confirm before anything writes).
- “Open a senior backend role” drafts a job from a short interview and your culture profile.
- “Show me the pipeline” returns a read-only summary across open roles.
Reads are free and instant. Consequential actions return an undo handle, and destructive ones ask for confirmation. The agent never advances or rejects a candidate on its own. See Concepts for the safety model.