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.
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
- Open your account settings and select Connections.
- Select the Claude Code CLI tab.
- Select Setup instructions.
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"}}'
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.
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
- Start Claude Code and enter
/mcp. - Select cvizza and choose to authenticate. Claude Code opens CVizza in your browser.
- 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.
CVizza then shows which account you are connecting and the permissions Claude Code requested.
- 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.
- 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.
- Return to the terminal.
/mcpnow 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 cvizzato 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.
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 httpcommand without theoauthsettings 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
/mcpand 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
- Keep the data Claude Code reads accurate with Build your candidate profile.
- Learn how drafts and versions work in Create and export your first CV.
- Add jobs to track in Add a job to your application tracker.