Career OS MCP connectors

MCP URL

/api/mcp

Important: Use the full MCP URL above (including /api/mcp or /mcp). A bare site origin such as https://resume.kinetixsolutions.dev with no path is not the MCP endpoint — clients that only register the origin will see an empty tool list.

That URL must be public HTTPS. Cloud agents call it from their servers, not from your laptop. Leave OAuth client ID and secret empty — Career OS registers the client automatically (DCR / CIMD). Full reference: Remote MCP docs.

Claude

1. Open claude.ai and sign in.
2. Go to Customize → Connectors (org owners: Organization settings → Connectors).
3. Click Add custom connector. If asked for type, choose Web.
4. Paste the MCP URL. Leave OAuth Client ID/Secret empty.
5. Click Add, then Connect, and sign in to Career OS.
6. In a chat, open + → Connectors and enable Career OS.

ChatGPT

1. Turn on developer mode / custom connectors if your plan requires it.
2. Create a connector and paste the MCP URL.
3. Connect, then sign in to Career OS on the consent screen. Do not paste a static bearer token.

Cursor

Settings → Tools & MCP → add a new HTTP server, or put this in MCP config:

{
  "mcpServers": {
    "career-os": {
      "url": "MCP_URL"
    }
  }
}

Cursor will open OAuth in the browser. Approve Career OS, then return to the chat.

VS Code / GitHub Copilot

In .vscode/mcp.json or user MCP settings:

{
  "servers": {
    "career-os": {
      "type": "http",
      "url": "MCP_URL"
    }
  }
}

Start the server from the MCP view and complete the browser sign-in when VS Code prompts.

Google Antigravity

1. In mcp_config.json, add Career OS with serverUrl set to the MCP URL above.
2. Open Customizations → Authenticate for Career OS and complete sign-in in the browser.
3. Antigravity uses redirect https://antigravity.google/oauth-callback; Career OS allowlists it automatically via DCR.

Troubleshooting “Authentication required”

• Career OS web sign-in ≠ MCP OAuth. You must click Authenticate / Connect in Antigravity, Cursor, or Claude so the client stores an MCP access token.
• Use https://app.kinetixsolutions.dev/api/mcp as serverUrl (or the same host’s /mcp alias).
• If OAuth succeeded before a deploy, disconnect and authenticate again so the client exchanges a fresh token.
• The JSON error with mcp_endpoint and no Bearer token means the client never attached OAuth credentials to MCP requests.

Other hosts

• Claude Desktop, Cursor stdio, Gemini CLI, Amazon Q, Zed, OpenCode: you can also run local stdio — see Local MCP.
• Windsurf, Cline, and other stdio-only clients: proxy with npx -y mcp-remote MCP_URL if the host cannot speak Streamable HTTP OAuth itself.

What the tools can do

• Read and overwrite the cloud resume (same row the editor uses)
• Generate a LaTeX PDF of the cloud resume

Sign in · Resume editor · Tool list