CareerVector MCP Connectors

CareerVector exposes a remote MCP endpoint for chatbot and agent hosts that support HTTP MCP connectors.

Endpoint

Use this server URL:

https://mcp.careervector.corbet.ch/mcp

Transport:

  • Remote MCP over Streamable HTTP.
  • JSON-RPC requests are sent with HTTP POST.
  • Server-initiated SSE streams are not offered yet. A GET request with Accept: text/event-stream returns 405, which is expected for this server.

Identity Model

Workspace identity stays in the CareerVector workspace ID. There is no parallel account or connector workspace system.

Every meaningful tool call takes wsId. The chatbot prompt should include the workspace ID or URL, for example:

Use CareerVector workspace jSAJ7Ebg71-7DwrQ. Add this job:
https://www.linkedin.com/jobs/collections/recommended/?currentJobId=4407972179
Then inspect the CV and tell me what should change.

Providing a workspace ID grants edit access, exactly like sharing the browser workspace link.

ChatGPT

In ChatGPT developer mode or connector setup, add CareerVector as a remote MCP server using the endpoint above. If the setup UI asks for authentication, choose no authentication. CareerVector currently relies on wsId in tool arguments rather than OAuth.

Claude

In Claude custom connector setup, add a remote MCP connector using the same endpoint. Keep the workspace ID in the conversation or initial project instructions so Claude can pass it on every tool call.

CVL Editing Workflow

For CVL edits, agents should avoid guessing paths.

  1. Call get_cvl_tree with wsId and branch_path.
  2. Use the exact node_path returned by get_cvl_tree.
  3. For text edits, call patch_node_data with a narrow dataPatch, for example { "text": "..." }.
  4. For list edits, read the existing node data first and pass the full updated items array in dataPatch.
  5. For variant choice changes, call set_selection on the parent node instead of deleting inactive alternatives.

Common branches:

  • cv_profile.en for the base English CV.
  • cl_profile.en for the base English cover letter.

Useful Prompts

Use workspace <wsId>. Add job URL <url>, then list the jobs and inspect the CVL
tree for cv_profile.en. Tell me which CV sections seem weak for this role.
Use workspace <wsId>. Inspect cv_profile.en with get_cvl_tree. Find the summary
node, rewrite only its text for this job, and patch it with patch_node_data.
Use workspace <wsId>. Read the current CV Typst source and compile the CV PDF if
the compile tool is available.
Source: wiki/content/architecture/MCP-CONNECTORS.md