Connect CVersum to your AI agent
The assistant signs in to your CVersum account with OAuth and can only see your CVs. MCP is on every plan, including free. Tailoring a CV to a job costs 1 AI credit, the same as on the website. Import uses the daily AI quota.
Server URL
https://cversum.pl/api/mcp
The same server is also available at https://cversum.pl/mcp (an alias, without a redirect).
Sign-in
After you paste the URL, the client opens the normal CVersum sign-in (the same one as the website) and a consent screen. You approve read and write access to your CVs. You do not type your password into the chat.
How to connect
Claude (claude.ai and Claude Desktop)
From the Claude help center: Customize → Connectors → Add → Custom → Web (or “Add custom connector”). Name: CVersum. URL: https://cversum.pl/api/mcp. Authentication: Sign in now or Sign in when needed. OAuth client: “Use Claude’s published identity” or “Register automatically”. Then sign in to CVersum and approve access.
On Team and Enterprise plans an organization owner adds the connector first (Organization settings → Connectors). Members connect afterwards from Customize → Connectors. Claude Desktop uses the same connector: Anthropic connects from its cloud, not from a local JSON file.
Open Claude’s add-connector dialog with the name and URL filled in.
ChatGPT
From OpenAI’s docs: on chatgpt.com open Plugins, choose the plus button, then Add custom MCP server. Name: CVersum. URL: https://cversum.pl/api/mcp. Authentication: OAuth. Acknowledge the warning and create the plugin. ChatGPT opens CVersum sign-in.
On Business, Enterprise and Edu, an admin decides who can add custom MCP servers (OpenAI Help). An older admin screen may still call this Developer mode. If you do not see “Add custom MCP server”, that plan or workspace does not offer custom MCP connectors.
Gemini
The Gemini website and mobile app do not document adding your own remote MCP server. Remote MCP is in Gemini CLI, which discovers OAuth and opens a browser:
gemini mcp add --transport http cversum https://cversum.pl/api/mcpOr set httpUrl to that address in ~/.gemini/settings.json. After a 401 the CLI runs CVersum sign-in.
Grok
From the Grok connectors docs: grok.com/connectors → New Connector → Custom. Paste https://cversum.pl/api/mcp and finish CVersum sign-in. The server must be public.
In the Grok CLI, from the MCP docs, OAuth also goes through the browser:
grok mcp add --transport http cversum https://cversum.pl/api/mcpIn the Grok API you can send a personal token in the Authorization header instead of OAuth (Remote MCP Tools).
Cursor and other clients
In Cursor: Settings → MCP → add a remote server, HTTP transport, URL https://cversum.pl/api/mcp. When a browser opens, sign in to CVersum. Any other client with Streamable HTTP and OAuth 2.1 (PKCE) uses the same URL. Discovery is at /.well-known/oauth-protected-resource.
Tools
list_cvs— List CVs: id, name, language, updated time and an edit link.import_cv— Import a CV from PDF, DOCX, TXT, PNG or JPG (base64 or an https URL).tailor_cv— New CV for a job: position, company, base CV, boldness 1–5 (wording only), job text up to 15,000 characters. facts_only defaults to true. idempotency_key retries without a second CV or credit. Cost: 1 credit.export_cv_pdf— Export to PDF, the only export format. Returns a short download link.rename_cv— Rename a CV.set_cv_photo— CV photo from the account photo, an https URL, or base64. Exactly one source.set_position_logo— Company logo from the shared library. A missing logo is added from a URL or domain, without a second file for the same name.list_templates— Templates: Klasyczny, Nowoczesny, Elegancki, Minimalistyczny, Kreatywny. Layouts: two-column and single-column.set_cv_template_layout— Sets the CV template and layout, including single-column.
There is no delete tool.
Example prompts
- Show my CVs in CVersum.
- Import a CV from this URL: https://example.com/my-cv.pdf
- Tailor my CV for an Analyst role at Example, boldness 3. Here is the job text: …
- Download the PDF of that CV.
- Rename that CV to Analyst — Example.
- Use my account photo on that CV.
- Add the Samsung logo to the job on that CV.
- Set the Kreatywny template and the single-column layout.
Revoke access
Account settings → Połączenia. Disconnect the app or revoke the token. It takes effect immediately. Połączenia.
Personal token
For scripts and the REST API, create a token under Połączenia. It is shown once. Header: Authorization: Bearer cvsk_… Request reference: API reference.