Guides

Step by step help for the apps.

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

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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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