# Step by step help for the apps.

> Step by step help for Zorlya: create an account, sign in, add a job, read a match score, track applications, manage your plan, use mail and connect an AI

Source: https://zorlya.com/guides

Short, step by step help for the job seeker app, mail, AI clients and the API. Written to be followed, one step at a time. For how scoring works in depth, read the blog.

## Getting started

- **[Create your account and upload a resume](https://zorlya.com/guides/getting-started/create-your-account-and-upload-a-resume)**
  Sign up for the Zorlya job seeker app, confirm your email and upload the resume that every score is built from.
- **[Read your match scores](https://zorlya.com/guides/getting-started/read-your-match-scores)**
  What the 0 to 100 score on a job means, how its four parts are combined, and how to use the breakdown and the reason written under it.
- **[Sign in with GitHub, and connect or disconnect it](https://zorlya.com/guides/getting-started/sign-in-with-github)**
  Use Continue with GitHub to sign in, connect GitHub to an existing account under Settings, or disconnect it again without losing access.
- **[Add LinkedIn, GitHub and other profile links](https://zorlya.com/guides/getting-started/add-your-profile-links)**
  Add typed profile links on the Edit tab of your profile, with the address each field accepts and what to do when a link is refused.
- **[Install Zorlya as an app](https://zorlya.com/guides/getting-started/install-zorlya-as-an-app)**
  Install the Zorlya job seeker app from your browser on Android, iPhone or a computer, with no app store.
- **[Add a passkey to sign in](https://zorlya.com/guides/getting-started/add-a-passkey)**
  Add a passkey under Settings, Sign in and security so you can sign in with a fingerprint, face or device lock, and remove it later.

## Applications

- **[Track applications on the board](https://zorlya.com/guides/applications/track-applications-on-the-board)**
  Move each application through five stages on the Applications board, and keep notes, events and documents on the application itself.
- **[Add a job from any site](https://zorlya.com/guides/applications/add-a-job-from-any-site)**
  Add a job to Zorlya from a link or pasted text with the Add a job button, keep it private, score it and track it like any other job.
- **[Run an ATS keyword check on one job](https://zorlya.com/guides/applications/run-an-ats-keyword-check-on-one-job)**
  Compare the skills one job posting asks for with the skills on your profile, in the app, and use the result to fix your resume.

## Mail

- **[Sign in to Zorlya Mail](https://zorlya.com/guides/mail/sign-in-to-zorlya-mail)**
  Sign in to Zorlya Mail at mail.zorlya.com with a mailbox login and password, recover a lost password and find a message.

## For developers

- **[Find what Zorlya's MCP server offers](https://zorlya.com/guides/developers/what-the-mcp-server-offers)**
  What an AI client can read and change through Zorlya, the three kinds of thing the server exposes, and what you need before you build against it.
- **[Sign in with OAuth by hand](https://zorlya.com/guides/developers/sign-in-with-oauth-by-hand)**
  Discover the server, register a client, send a person through the Connect page with PKCE and trade the code for tokens, one curl request at a time.
- **[Make your first calls](https://zorlya.com/guides/developers/make-your-first-calls)**
  Send initialize, list the tools and call one with curl, and read what comes back, including the structured result and the error shapes.
- **[Page results and handle errors](https://zorlya.com/guides/developers/page-results-and-handle-errors)**
  Follow cursors to the end of a list, tell the kinds of error apart, and stay inside the per-minute limits.
- **[Build a client in TypeScript](https://zorlya.com/guides/developers/build-a-client-in-typescript)**
  A complete Zorlya MCP client in about 60 lines of Node with no dependencies, covering calls, cursor paging and a token refresh that keeps the rotated token.
- **[Build a client in Python](https://zorlya.com/guides/developers/build-a-client-in-python)**
  A complete Zorlya MCP client in under 80 lines of Python with the standard library only, covering calls, cursor paging and a refresh that keeps the rotated token.
- **[Test with the MCP Inspector](https://zorlya.com/guides/developers/test-with-the-mcp-inspector)**
  Connect the official MCP Inspector to Zorlya to see every request and answer, try tools by hand and find out why a client will not connect.
- **[Refresh tokens, narrow scopes and end a connection](https://zorlya.com/guides/developers/tokens-scopes-and-revocation)**
  How long Zorlya tokens last, how refresh rotation and replay detection work, how scopes narrow, and how a person or a client ends a connection.
- **[Secure a client that talks to Zorlya](https://zorlya.com/guides/developers/security-checklist-for-clients)**
  What a client that talks to Zorlya should do with tokens, redirects, scopes and tool results, and what an AI model should never be trusted to decide.

## Connect an AI client

- **[Connect Claude on the web and Claude Desktop](https://zorlya.com/guides/ai-clients/claude-ai-and-desktop)**
  Add Zorlya to Claude as a custom connector with the URL https://mcp.zorlya.com, sign in with OAuth, and ask Claude about your matches.
- **[Connect Claude Code](https://zorlya.com/guides/ai-clients/claude-code)**
  Add Zorlya to Claude Code with one claude mcp add command, sign in through the browser with /mcp, and query your matches from the terminal.
- **[Connect ChatGPT](https://zorlya.com/guides/ai-clients/chatgpt)**
  Add Zorlya to ChatGPT as a custom MCP server at https://mcp.zorlya.com and sign in with OAuth. Includes what we could not confirm.
- **[Connect Cursor to Zorlya](https://zorlya.com/guides/ai-clients/cursor)**
  Add the Zorlya MCP server to Cursor with one entry in mcp.json, then choose what Cursor may do on Zorlya's Connect page and sign in.
- **[Connect VS Code with GitHub Copilot to Zorlya](https://zorlya.com/guides/ai-clients/vscode-copilot)**
  Add Zorlya as an HTTP MCP server in VS Code so Copilot's agent can read your matches, then sign in on Zorlya's Connect page.
- **[Connect Windsurf to Zorlya](https://zorlya.com/guides/ai-clients/windsurf)**
  Add Zorlya to Windsurf's Cascade through mcp_config.json using a serverUrl, then sign in on Zorlya's Connect page. Docs are thin on OAuth.
- **[Connect Zed to Zorlya](https://zorlya.com/guides/ai-clients/zed)**
  Add Zorlya to Zed as a remote MCP server with a single url entry under context_servers, then sign in through Zed's OAuth prompt.
- **[Connect Gemini CLI to Zorlya](https://zorlya.com/guides/ai-clients/gemini-cli)**
  Add Zorlya as a remote MCP server in Gemini CLI, sign in through the browser, and ask for your matches from the terminal.
- **[Connect OpenAI Codex CLI to Zorlya](https://zorlya.com/guides/ai-clients/codex-cli)**
  Add Zorlya to Codex CLI as a Streamable HTTP MCP server in config.toml, sign in with codex mcp login, and query your matches.
- **[Connect stdio-only clients to Zorlya with mcp-remote](https://zorlya.com/guides/ai-clients/stdio-clients-with-mcp-remote)**
  Use the mcp-remote bridge to reach Zorlya from a client that can only launch local stdio servers, and learn where it keeps its OAuth tokens.
- **[Connect n8n to Zorlya](https://zorlya.com/guides/ai-clients/n8n)**
  How n8n's MCP Client Tool node and its MCP OAuth2 credential line up with Zorlya's OAuth 2.1 server, and what the n8n docs leave unconfirmed.
- **[Connect Zapier to Zorlya](https://zorlya.com/guides/ai-clients/zapier)**
  How Zapier's beta MCP Client app connects to a remote MCP server with OAuth, and what Zapier's docs leave unconfirmed for Zorlya.
- **[Connect Make to Zorlya](https://zorlya.com/guides/ai-clients/make)**
  How Make's MCP Client app connects to a remote MCP server, the redirect URI it documents, and what Make's docs leave unconfirmed for Zorlya.
- **[Approve an AI app on the Connect page](https://zorlya.com/guides/ai-clients/what-you-approve-when-you-connect)**
  The Connect page step by step, the permission levels, which tools each kind of Zorlya account gets, what is logged, and how to end a connection.

## Help

- **[Contact support and track a ticket](https://zorlya.com/guides/help/contact-support-and-track-a-ticket)**
  Open a support ticket from the contact page or your account, confirm your email, follow the reply, then solve, reopen or rate it.
- **[Change your plan or cancel it](https://zorlya.com/guides/help/change-your-plan-or-cancel)**
  See what you have used, compare Free, Plus and Pro, upgrade, downgrade or cancel from the Plans page.
- **[Export or delete your data](https://zorlya.com/guides/help/export-or-delete-your-data)**
  Download a copy of your Zorlya data or delete your account from Settings, Privacy, and what happens when you do.
