> ## Documentation Index > Fetch the complete documentation index at: https://hireflixsl.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Connect your AI tool to Hireflix with the MCP ## What is this? The **Hireflix MCP server** at `https://mcp.hireflix.com/mcp` connects your AI tool of choice directly to your Hireflix account. Once connected, it can look up and manage your positions, candidates, interviews, and webhooks for you. Just ask in plain English. You don't need an API key. You sign in with your Hireflix account, and your AI tool works with **your current permissions**, so it can only see and do what you can in the dashboard. If you use Claude, that also makes the MCP simpler to set up than the [Claude skill](https://hireflixsl.mintlify.site/user/getting-started/claude-skill.md), because you don't have to allow any websites in your settings. **Quick path:** 1. [Check your plan](#supported-ai-tools): make sure your AI tool's plan supports custom MCP servers. 2. [Connect your AI tool](#connect-your-ai-tool): add the MCP URL, sign in to Hireflix, and allow access. 3. [Try it out](#try-it-out): ask a first question, then use the example prompts. ## Supported AI tools We've tested the Hireflix MCP with these AI tools: | AI tool | Plan you need | Good to know | | - | - | - | | **Claude** | Any plan | On the free plan, you can only add **one** custom connector. If you've already added another one, remove it first or upgrade your Claude plan. | | **ChatGPT / Codex** | **Business**, Enterprise, or Edu | You need one of these plans to both read and write through the MCP. See [OpenAI's guide to custom MCP servers](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) for details. | Using something else? Any AI tool that supports remote MCP servers with OAuth should be able to connect with the same URL, but we haven't tested other tools yet. ## Available tools Once connected, your AI tool can use these Hireflix tools: | Area | What your AI tool can do | | - | - | | **Positions** | List, get, create, and update positions, including uploading intro, outro, and question videos | | **Candidates** | Invite someone to a position | | **Interviews** | List, get, score, shortlist, share, and discard interviews | | **Webhooks** | List, create, and remove webhooks | | **Schema tools** | Introspect, search, validate, and execute queries against the full Hireflix GraphQL schema | > [!NOTE] > > Not everything you can do in Hireflix has its own tool. Fetching interview transcriptions, for example, isn't in the list above. That's what the schema tools are for: your AI tool uses **introspect** and **search** to look through the full GraphQL schema Hireflix provides, finds the query it needs, and runs it with **execute**. So if you ask for something without a dedicated tool, it can usually still do it. ## Connect your AI tool Choose your AI tool and follow the steps. > [tab] Claude > > **1. Open your connector settings** > > In Claude, click your account name and open **Settings**. Click **Customize** in the left menu and open the **Connectors** tab. Then click the **Add** button in the top right and choose **Add custom connector**. > > ![The Connectors tab under Settings > Customize with the Add menu open, showing Add custom connector](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-connectors-add.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=dd9952037ddfabaf77267f6dbb6dfb01) > > **2. Enter a name and the MCP URL** > > Name the connector `Hireflix` and enter the MCP server URL: > > ```text theme={null} > https://mcp.hireflix.com/mcp > ``` > > Click **Continue**. > > ![The Add custom connector dialog with the name Hireflix and the URL https://mcp.hireflix.com/mcp filled in](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-connect-mcp.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=32944a21cf937322196d5750b2b421e3) > > **3. Keep the default connection settings** > > Claude detects how to connect to Hireflix and pre-fills the authentication settings (**Sign in now** and **Register automatically**). Leave them as they are and click **Add**. > > ![The Add custom connector dialog with the detected authentication and OAuth client settings selected](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-add-custom-connector.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=fe19b106632b229bbad51397c4dfe297) > > **4. Click Connect** > > Claude opens the **Hireflix** connector page, which tells you you're not connected to Hireflix yet. You can always find this page again under **Settings → Customize → Connectors**, in the **Yours** list. Click **Connect** to start linking your account. This opens a connection request on Hireflix. If you're not logged in to Hireflix yet, log in first. > > ![The Hireflix connector page in Claude showing You're not connected to Hireflix yet and a Connect button](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-connect-hireflix-flow.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=5105b8f5b40a41b127b3f28e2055c867) > > **5. Allow Claude to access your account** > > Hireflix shows what Claude will be able to do. Click **Allow** to give it access. This lets Claude: > > * Access your Hireflix account using your current permissions. > * Read and manage positions, candidates, interviews, and webhooks. > * Keep access while your session and permissions remain valid. > > ![The Hireflix consent screen asking to allow Claude to access your Hireflix account](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-allow-claude-hireflix.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=48d34217006063574f6211fe1ffb1b7f) > > That's it, you're connected. Next, [try it out](#try-it-out). > > > [accordion] Fine-tune tool permissions (optional) > > > > In Claude, go to **Settings → Customize → Connectors**, switch to **Yours**, and open **Hireflix** to choose exactly which tools Claude may use. Tools are split into **Read-only tools** and **Write/delete tools**, and for each tool you can pick: > > > > * **Always allow**: Claude uses the tool without asking. > > * **Ask permission**: Claude asks you before every use. This is the default for every tool. > > * **Block**: Claude can't use the tool at all. > > > > You can change a single tool, or a whole group at once using the dropdown next to the group name. > > > > > [!TIP] > > > > > > Want Claude to look things up but never change anything? Set **Read-only tools** to always allow, and block the **Write/delete tools** (or leave them on ask permission). Claude can then browse positions and interviews freely, but can't create or update positions, invite candidates, or change interview stages without you. > > > > ![Tool permissions for the Hireflix connector, grouped into read-only tools and write/delete tools, each with allow, ask, and block options](https://mintcdn.com/hireflixsl/LrAYsWLBx8Qr_JUp/images/hireflix-userguide-tool-permissions.png?fit=max\&auto=format\&n=LrAYsWLBx8Qr_JUp\&q=85\&s=80195f4a3c1c3bc2cf17029997c21d8e) > [tab] ChatGPT / Codex > > ChatGPT and Codex use the same interface, so these steps work for both. > > **1. Open the Plugins page** > > Click **Customize** in the left menu (1), then **Plugins** (2). Click the **Add** button in the top right (3) and choose **Add custom MCP server** (4). > > ![The Plugins page under Customize with the Add menu open, showing Add custom MCP server](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-add-custom-mcp-server.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=188dc9830b56a9761dc9f8fe22b7f4b6) > > **2. Enter the server details** > > Fill in the form: > > * **Name**: `Hireflix` > > * **Description** (optional): `One-way video interview` > > * **Connection**: keep **Server URL** selected and enter the MCP server URL: > > ```text theme={null} > https://mcp.hireflix.com/mcp > ``` > > * **Authentication**: **OAuth** > > Don't click **Create as a plugin** yet. Click **Advanced OAuth settings** first. > > ![The Add custom MCP server form with the name, description, server URL, and OAuth filled in, and Advanced OAuth settings highlighted](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-add-mcp-server-form.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=2ea6348a2b1a11e72f8d63653733ff6d) > > **3. Remove the extra OIDC scopes** > > > [!WARNING] > > > > Don't skip this step. If you leave any other scopes in the list, the connection to Hireflix fails. > > With **Advanced OAuth settings** open (1), scroll all the way down in the pane on the right to **OIDC scopes supported** (2). Remove everything from the list except these two scopes: > > ```text theme={null} > openid > offline_access > ``` > > Leave the other settings as they are. > > ![Advanced OAuth settings expanded, with OIDC scopes supported showing only openid and offline\_access, and the Create as a plugin button](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-mcp-oidc-scopes.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=c092b8108a83b18bb279d7abb1916b19) > > **4. Create the plugin** > > Check **I understand and want to continue**, then click **Create as a plugin** (3 in the screenshot above). > > **5. Click Connect Hireflix** > > ChatGPT asks you to connect Hireflix. Read the information about how your data is shared, then click **Connect Hireflix**. ChatGPT redirects you to Hireflix. > > ![The Connect Hireflix dialog in ChatGPT with the Connect Hireflix button](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-connect-hireflix.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=52c0c791f263f18283e005e9f5294974) > > **6. Allow ChatGPT to access your account** > > If you're not logged in to Hireflix yet, log in first. Hireflix then shows what ChatGPT will be able to do for your organization. Click **Allow** to give it access. This lets ChatGPT: > > * Access your Hireflix account using your current permissions. > * Read and manage positions, candidates, interviews, and webhooks. > * Keep access while your session and permissions remain valid. > > ![The Hireflix consent screen asking to allow ChatGPT to access your Hireflix account](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-allow-chatgpt-hireflix.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=e0d92963038f713e22ef59158d07a2f1) > > **7. Check that the plugin is installed** > > **Hireflix** now appears under **Installed** in the **Customize** menu (1). Open it and click **Try now** (2). This opens a new chat with Hireflix already tagged. > > ![The Hireflix plugin page in ChatGPT, with Hireflix listed under Installed and a Try now button](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-hireflix-plugin.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=5562103b3bb68b254a1af7aa65bd79f0) > > That's it, you're connected. Next, [try it out](#try-it-out). ## Try it out Start a **new** chat and ask something simple to check that the connection works: ```text theme={null} Using the Hireflix MCP, can you list all positions in my account? ``` In ChatGPT or Codex, the chat you opened with **Try now** already has **Hireflix** tagged, so you only need to type your question. To confirm that write access works too, follow up with a small change, such as renaming a position. ![A ChatGPT conversation where Hireflix is tagged in the message, the positions in the account are listed, and one position is renamed](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-mcp-chat-example.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=0f05960d3484a452caad8a7dcb9ef42b) ### Example prompts Once that works, you can ask about your positions, interviews, and candidates, for example: * "Which interviews for the `` position are completed but not yet evaluated?" * "Give me interview stats per stage (pending, to evaluate, shortlisted, discarded) for each of my positions." * "Summarize the answers from the latest completed interview for the `` position." * "Fetch the transcriptions for all interviews for the `` position." * "Can you analyze the responses for all interviews for the `` position and give me a rating for each, based on which candidate you think is best for our company?" * "Invite `` `` `` to the `` position." * "Shortlist the interview from `` and give it a score of 4." ### Creating positions To create a position through the MCP, use the [position template](https://hireflixsl.mintlify.site/user/getting-started/claude-skill.md#the-position-template) from the Claude skill tutorial. It works the same with any AI tool. Copy it, fill it in, attach any intro, outro, or question videos, and send it to your AI tool. The template follows the same input schema Hireflix expects, so your AI tool knows exactly which fields are required and what the character limits are. ## What's next? > [card] [Interview Management](https://hireflixsl.mintlify.site/tech/features/overview.md#interview-flow) > > Explore the full interview flow: from inviting candidates to reviewing completed interviews. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.