> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hireflix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Hireflix in ChatGPT and Codex

> Connect ChatGPT or Codex to your Hireflix account with the MCP, or add the Hireflix skill. Requires a Business, Enterprise, or Edu plan.

ChatGPT and Codex use the same interface, so everything on this page works for both. You can connect them in two ways: the [Hireflix MCP](#connect-with-the-mcp-recommended) (sign in with Hireflix, recommended) or the [Hireflix skill](#use-the-skill) (paste an API key). See [MCP or skill?](https://docs.hireflix.com/ai/overview.md#mcp-or-skill) for the differences.

> [!NOTE]
>
> You need a ChatGPT **Business**, Enterprise, or Edu plan to both read and write through Hireflix. See [OpenAI's guide to custom MCP servers](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) for details.

> [!WARNING]
>
> **ChatGPT is known to be less reliable with MCP servers and skills than Claude.** What to expect:
>
> * **Large results:** asking for a lot of data at once (for example, every interview across all positions) can make ChatGPT stall or cut the answer short. Ask for smaller chunks, such as one position or the latest 10 interviews.
> * **Slow responses:** requests can take noticeably longer, and sometimes time out.
> * **Skipped or wrong tool calls:** ChatGPT sometimes answers without using Hireflix, or guesses the wrong fields. Tagging **Hireflix** and asking step by step helps.
>
> If you keep running into these issues, try Claude instead.

## Connect with the MCP (recommended)

**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).

## Use the skill

> [!NOTE]
>
> You need a ChatGPT **Business**, Enterprise, or Edu plan to use the Hireflix skill.

**1. Start creating a skill**

Click **Customize** in the left menu (1), then **Skills** (2). Click the **Add** button in the top right (3) and choose **Create skill** (4). This opens a new chat with **Skill Creator** tagged.

> [!NOTE]
>
> You might already see **Hireflix** under **Installed** in the left menu. That's the plugin from the [MCP tutorial](https://docs.hireflix.com/ai/mcp.md), not the skill.

![The Skills page under Customize with the Add menu open, showing Create skill](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skills-create-skill.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=eb6960e558a413c21b804739b6345e4b)

**2. Paste the skill file and send the instruction**

Open [hireflixsl.mintlify.app/skill.md](https://hireflixsl.mintlify.app/skill.md), copy the full contents, and paste them into the chat. They pop up as an attached file (1).

Prefer working with a file? Save the page as `skill.md` with `CMD + S` on Mac or `CTRL + S` on Windows, then attach that file to the chat instead. Copying the contents directly is usually easier.

> [!WARNING]
>
> Add the contents of the file. Using the direct link to `skill.md` doesn't work.

Then add this instruction and send your message (2):

```text theme={null}
Can you create a skill for Hireflix based on the attached skill.md file
```

![A new chat with Skill Creator tagged, the pasted skill file attached, and the instruction typed in the message box](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-paste-file.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=b3db790a16c138cf2ffaf2483fba7444)

**3. Wait for the skill to be created**

Creating the skill takes around 30 seconds to a minute. ChatGPT tells you when the Hireflix skill is created and installed.

![ChatGPT confirming that it created and installed the Hireflix skill](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-created.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=236d22490c202f60339b6d7ffd371327)

**4. Open the skill**

Go back to **Customize → Skills**, find **Hireflix** in the **Installed** list on the page, and click it.

![The Skills page with the Hireflix skill highlighted in the Installed list](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skills-list.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=b2ec520cd7c1def54226999cabb5dcdf)

**5. Click Try now**

Click **Try now**. This opens a new chat with the Hireflix skill already tagged.

![The Hireflix skill details with a Try now button](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-try-now.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=4231725ba6ead624c8f396c97f5cfcc5)

**6. Add your API key and ask a question**

You can now ask anything. With the skill tagged (1), give it your Hireflix API key the first time you use it (2). See the [Quickstart](https://docs.hireflix.com/tech/quickstart.md) if you still need to create one. For example:

```text theme={null}
Can you show all positions in my account? Here's my API key: <key>
```

![A new chat with the Hireflix skill tagged and a question that includes an API key placeholder](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-api-key-prompt.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=a88a3046cf7d0193cbb3e03eed2b72d8)

ChatGPT uses the skill to answer your question:

![ChatGPT listing six positions and reminding you to rotate the API key you pasted](https://mintcdn.com/hireflixsl/FhH-Xy15PDlx_OP7/images/hireflix-userguide-chatgpt-skill-demo.png?fit=max\&auto=format\&n=FhH-Xy15PDlx_OP7\&q=85\&s=f01354b066e6c56aa7139cbe9f208613)

> [!WARNING]
>
> When you're done chatting, don't forget to rotate your key in your [API keys settings](https://admin.hireflix.com/en/my-account/api-keys).

## Try it out

Open a new chat with **Hireflix** tagged (use **Try now** on the plugin or skill page) and ask:

```text theme={null}
Can you list all positions in my account?
```

![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)

Then try the [example prompts](https://docs.hireflix.com/ai/guides/example-prompts.md) or [create a position via chat](https://docs.hireflix.com/ai/guides/create-position-via-chat.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.