Connect Scope to Claude

Two ways to put your candidates in front of Claude. The handoff is free on every plan and needs zero setup. The MCP connection (Pro and Elite) gives Claude a live, optionally two-way link to your pipeline. Both run in your own Claude account.

1. Open in Claude Free, every plan

Best for: a quick, no-setup way for anyone (hiring admins, recruiters, sourcers) to act on candidates with AI. It runs in your own Claude account, so it works on every plan with nothing to connect.

Inside Scope you will find:

The handoff copies a prompt to your clipboard and opens Claude. Paste it with Ctrl or Cmd + V. The chat happens in your Claude account.

2. Connect Scope to Claude (MCP) Pro / Elite

Best for: a live connection so Claude can read your projects, candidates, and AI scores directly, and (when you allow it) make changes. For Claude Code and Claude Desktop, first create an API key in Developer Settings. The claude.ai web app uses a one-click sign-in instead.

Run this in your terminal, replacing YOUR_API_KEY with a key from Developer Settings: 

claude mcp add --transport http scope https://db.usescope.co/functions/v1/scope-mcp --header "Authorization: Bearer YOUR_API_KEY"

Add this to claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config), then restart Claude Desktop. Replace YOUR_API_KEY with a key from Developer Settings: 

{
  "mcpServers": {
    "scope": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://db.usescope.co/functions/v1/scope-mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop reaches the remote server through the mcp-remote bridge, installed automatically by npx.

No API key or config file needed. In claude.ai:

  1. Open Settings → Connectors → Add custom connector.
  2. Paste the MCP URL: https://db.usescope.co/functions/v1/scope-mcp
  3. Claude sends you to a Scope sign-in and consent screen. The connection covers every Pro or Elite workspace you manage, so one approval is enough even if you run several organizations.
  4. To let Claude make changes (not just read), tick Allow changes on that screen. Leave it off for read-only access.
  5. Approve. Claude is now connected to your Scope workspace.

Custom connectors require a Claude paid plan (Pro, Max, Team, or Enterprise). You can revoke the connection any time by removing the connector in Claude.

What Claude can do

Once connected, Claude has these tools. Read tools are always available. Write tools change your data, so each one asks for your approval in Claude before it runs.

Tool Type What it does
list_projects Read List your open roles.
get_organization_status Read Check credit balance, plan, and free-grant remaining for each workspace. Claude checks this before sourcing.
list_candidates Read List candidates in a project, with AI fit scores.
get_candidate Read Full profile, latest AI analysis, and hiring-team feedback.
search_candidates Read Find candidates by name, title, or company.
update_candidate_status Write Set status: new, reviewed, approved, rejected, contacted, archived.
set_candidate_stage Write Move on the hiring board: submitted, screening, interviewing, offer, rejected.
add_candidate_feedback Write Record interested, not_interested, or follow_up, with an optional note.
save_outreach_draft Write Save a drafted outreach sequence for you to review and send from Scope.
create_project Write Create a new sourcing project (open role), with optional structured requirements.
trigger_sourcing Write Start AI sourcing for a project. Spends credits and asks for confirmation.

Permissions. API keys (Claude Code and Desktop) have full access. claude.ai web connections are read-only unless you grant "Allow changes" on the consent screen. Marking a hire and deleting candidates are intentionally not available to Claude: confirm hires in Scope, where they trigger billing and the placement flow. Every Scope organization on the connection must be on a Pro or Elite plan.

Sourcing from your own machine instead? Scope Desktop ships a local MCP server (scope-desktop-mcp) that drives free LinkedIn sourcing through the browser on your computer, no credits needed. See the Agent Skills Hub (Scope Desktop tab) for setup.