Career Compass

Connect Claude to Career Compass

Career Compass exposes a Model Context Protocol (MCP) endpoint so Claude Desktop, Claude Code, and Claude Cowork can analyze jobs, generate cover letters, and coach your career without leaving your AI client. Connection uses OAuth 2.1 with PKCE: one-click authorize, no tokens to copy.

1. Connect from Claude

The exact path depends on your Claude client. In every case you only need the endpoint URL:

https://careercompass.pl/api/mcp

Claude Desktop

  1. Open Settings → Connectors → Add connector.
  2. Paste the URL above and continue.
  3. A browser tab opens with the Career Compass consent screen. Sign in if you aren’t already, review the requested scopes, and click Approve.
  4. The tab closes automatically and Claude Desktop shows Career Compass as connected.

Claude Code

  1. Run claude mcp add career-compass https://careercompass.pl/api/mcp (or the equivalent from the /mcp slash command).
  2. Claude Code opens your browser for the consent flow.
  3. Approve and return to the terminal.

Claude Cowork

  1. Open the connectors menu, choose Add custom connector, and paste the URL.
  2. Approve the consent screen that opens in your browser.

2. What Claude can do

Read-only tools (no credit cost)

  • get_profile - lightweight profile snapshot: current role, years of experience, summary, top skills, industries, job-search preferences. Contact / identity info is deliberately not exposed.
  • get_profile_full - full resume context: structured work experience, education, certifications, achievements, tools, methodologies, languages with proficiency. Use before cover letters or interview prep.
  • get_profile_score - resume score and three-pillar breakdown.
  • get_token_balance - current credit balance.
  • get_match_history - up to 50 most recent job matches.
  • get_match_details - full pillar scores, insights, and parsed job data for one match.
  • get_market_insights - top skills, tools, certs, salary ranges for your target roles.
  • get_linkedin_headlines - your current 4 LinkedIn headline suggestions (2 Role Oriented + 2 Goal Oriented). Regenerating overwrites in place.

Generation tools (1 credit each)

  • analyze_job_url - score a pracuj.pl / nofluffjobs.pl / justjoin.it / inhire.io posting against your profile.
  • generate_cover_letter - tone and length options, generic or job-specific.
  • generate_interview_prep - behavioral, technical, and situational questions for a specific match.
  • generate_elevator_pitch - 60 to 90 word pitch, generic or job-specific.

Free tools

  • generate_linkedin_headline- four LinkedIn headline suggestions grouped into two strategies (two Role Oriented, two Goal Oriented), each within LinkedIn's 220-character limit. Pass strategy (roleAndCerts or goalsOriented) to regenerate only that pair. No credit cost.

Ambient resources

Claude can load these automatically for context without an explicit tool call:

  • career-compass://profile
  • career-compass://matches (last 20)
  • career-compass://market-insights

Ready-made prompts

  • career-coaching - optional focus: job-search, skill-development, or interview-prep.
  • job-analysis - pass a url (new job) or match_id (existing match).

3. Managing connected applications

Every application you approve appears in Settings → Connections with:

  • A verified-publisher badge when the application is on the Career Compass allowlist (Claude Desktop, Claude Code, Claude Cowork, MCP Inspector).
  • The scopes you granted.
  • Connected date and last-used time.
  • A Disconnect button that instantly revokes every token for that application.

After disconnecting, the application will be asked to authorize again the next time it tries to call Career Compass.

4. Security and privacy

  • Each grant can make up to 60 requests per minute. Across all your connected applications combined, 1,000 requests per day.
  • Every tool call is logged to an audit trail (timestamp, tool name, latency, status). Tool arguments are stored as a SHA-256 hash, never plaintext.
  • Access tokens expire every hour; refresh tokens rotate on every use and expire after 30 days of inactivity. A stolen-then-replayed refresh token is detected and the entire grant is revoked automatically.
  • When you use generation tools, your profile data is sent to Anthropic’s Claude API as a sub-processor. You consent to this the first time you approve an MCP connection. See the Privacy Policy for details.

5. Support

Questions or something you didn’t expect to see in your Connections list? Email support@careercompass.pl.