← All information

Connect Claude Code to CVizza

Connect Claude Code to CVizza with browser sign-in, choose what it can access, and let it work with your CVs, profile and applications.

Updated

Claude Code can connect to your CVizza account directly. You sign in through your browser, choose what Claude Code may access, and then ask it in plain language to review your CV drafts, candidate profile and applications. You do not create or copy a token. This guide shows how to set up the connection, what to try first, and how to disconnect.

What Claude Code can do with CVizza

Claude Code works only with your own CVizza data and only within the permissions you approve:

  • CV drafts: list and read your CVs, create a CV from your candidate profile, edit or copy a draft, choose a template, and export a draft as PDF or DOCX.
  • Candidate profile: read your profile, update it, and add or change experience, education, skills, languages, certifications and projects.
  • Applications: list your applications and their activity, change a status, add a note, and archive or restore an application.

CVizza does not run an AI model for this. Claude Code does the reasoning, and CVizza checks every request against the permissions you approved.

Some steps stay in the CVizza web app: Claude Code cannot import a job posting, create an application, publish a CV version or change your photo. Setting an application to Applied only records your own update; CVizza never contacts an employer.

What you need

  • A CVizza account.
  • Claude Code installed in your terminal. Use a current version, because the setup command relies on Claude Code's OAuth settings for MCP servers.
  • If you want to allow changes and you only sign in with Google, set a CVizza password first with the password recovery flow. Approving write permissions asks for your current password.

Step 1: Open the Claude Code setup

  1. Open your account settings and select Connections.
  2. Select the Claude Code CLI tab.
  3. Select Setup instructions.

The Connections page with the Claude Code CLI tab selected, a Setup instructions button and no connections yet

Step 2: Choose permissions and copy the command

Tick the permissions Claude Code should request. For a first try, choose the three read permissions: Read CV drafts, Read Candidate Profile and Read applications. Claude Code can then look at your data but cannot change it.

Permission What Claude Code can do
Read CV drafts List and read your CV drafts
Create and edit CV drafts Create, update and copy drafts and choose their template
Export PDF and DOCX Export a draft as PDF or DOCX
Read Candidate Profile Read your candidate profile
Edit Candidate Profile Update your profile and its entries
Read applications List applications and read their details and activity
Update applications Change a status, add a note, archive or restore

Editing an existing record needs both its read and its write permission. Exporting needs Read CV drafts and Export PDF and DOCX.

The command under the checkboxes updates as you tick them. Select Copy command and run it in your terminal. With the three read permissions it looks like this:

claude mcp add-json cvizza '{"type":"http","url":"https://mcp.cvizza.com/candidate","oauth":{"clientId":"cvizza-claude-code","scopes":"resumes:read profile:read applications:read"}}'

Step 1 of the setup with Read CV drafts, Read Candidate Profile and Read applications ticked and the Claude Code command with a Copy command button

Copy the command from the page rather than typing it, so that the address and permissions match your selection. There is no secret in it.

Step 3: Decide which tools need your approval

Claude Code can ask you before each change. Select Copy permissions and merge the rules into your project's .claude/settings.local.json. Tools in the ask list, such as editing a CV or changing an application status, then always wait for your approval.

Step 2 of the setup showing the .claude/settings.local.json rules with allow and ask lists and a Copy permissions button

The suggested allow list lets Claude Code read your CV drafts without asking. For other read tools, such as reading your profile or applications, Claude Code asks the first time; you can approve them there or add them to allow. If your settings already allow tools broadly, review those rules, because they can skip the approval prompt.

Step 4: Sign in from Claude Code

  1. Start Claude Code and enter /mcp.
  2. Select cvizza and choose to authenticate. Claude Code opens CVizza in your browser.
  3. Sign in to CVizza if you are not signed in already. If you use two-factor authentication or there are updated Terms to accept, CVizza asks for that first.

Step 3 of the setup explaining how to sign in with /mcp, how to recover from a cancelled request, and how to remove the local setup

CVizza then shows which account you are connecting and the permissions Claude Code requested.

The Connect Claude Code page signed in as demo-user with Read applications, Read Candidate Profile and Read CV drafts ticked, and Cancel and Allow access buttons

  1. Check the account name and the permissions. You can untick a permission to grant less than Claude Code requested, but you cannot add more here.
  2. Select Allow access. If you approve any permission that can change data, CVizza asks for your current password, and for an authenticator code if you use one.
  3. Return to the terminal. /mcp now shows cvizza as connected, and the connection appears under Your connections on the Claude Code CLI tab.

Cancel grants nothing. The approval page is valid for five minutes; if it expires, start again from /mcp.

Step 5: Try your first request

Start with requests that only read your data:

  • "List my CV drafts."
  • "Show my candidate profile and tell me which sections are still empty."
  • "List my applications and summarize where each one stands."

When you are ready for changes, reconnect with the write permissions you need (see below) and ask Claude Code to show the change before saving it:

  • "Rewrite the summary of my Product Designer CV for a senior UX role. Show me the new text before you save it."
  • "Create a new CV called Data Analyst from my profile and choose a one-column template."
  • "Export my Product Designer CV as a PDF."
  • "Move my most recent application to Interview and add a note about Thursday's call."

If a request needs a permission you did not approve, CVizza refuses it and nothing is changed.

Change permissions later

To add or remove permissions, open Setup instructions again, tick the new set and run the new command. Because the server is called cvizza already, remove the old setup first with claude mcp remove cvizza. Then authenticate again from /mcp and approve the new permissions. A new approval replaces your previous Claude Code connection; it never keeps old permissions you did not approve again.

Disconnect

There are two separate steps:

  • In CVizza: on the Claude Code CLI tab, select Revoke next to the connection. Claude Code loses access straight away. Other connections, such as personal access tokens, keep working.
  • On your computer: run claude mcp remove cvizza to delete the local setup. This alone does not revoke access in CVizza.

Each connection also ends automatically after 30 days. To keep using CVizza after that, authenticate again from /mcp.

Limits

Claude Code and your personal access tokens share one allowance per account: 60 reads per minute, 30 writes per hour and 10 exports per hour. Retries count too. Reconnecting does not reset the counters. You can see your current usage in your workspace under Limits.

The Limits page showing Reads 0 of 60 per minute, Writes 0 of 30 per hour and Exports 0 of 10 per hour with reset times

Stay safe

  • Approve only the permissions you need for the task.
  • Keep approvals on for tools that change data, and read each proposed change before you allow it.
  • Your CV, profile and notes can contain text copied from job postings. Claude Code should treat that text as data, never as instructions.

If something does not work

  • The browser shows an error instead of the approval page. Update Claude Code, then remove the setup and add it again with the copied command. A plain claude mcp add --transport http command without the oauth settings does not work with CVizza.
  • The approval page shows an error after a pause or after you cancelled. The request expired or was cancelled. Authenticate again from /mcp.
  • Claude Code stopped working after you revoked the connection. Clear the authentication for cvizza in /mcp and sign in again.
  • A change is rejected because the draft changed. Someone, possibly you in another tab, edited it in the meantime. Ask Claude Code to read it again and review the new version.
  • You use Codex or another MCP client. Use a personal access token instead, as described in Getting started with CVizza MCP.

What to do next