> ## 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 Claude

> Connect Claude to your Hireflix account with the MCP, or add the Hireflix skill, and manage positions and interviews by chatting.

Claude is the AI tool that works best with Hireflix. You can connect it in two ways:

| | [Hireflix MCP](#connect-with-the-mcp-recommended) (recommended) | [Hireflix skill](#use-the-skill) |
| - | - | - |
| **Sign-in** | Your Hireflix account | An API key you paste in chat |
| **Setup** | Add one connector | Allow four websites, then upload a file |
| **Good to know** | Free plan: one custom connector only | Needs **Use the internet while making files** turned on |

Not sure which to pick? Go with the MCP. See [MCP or skill?](https://docs.hireflix.com/ai/overview.md#mcp-or-skill) for the details.

> [!TIP]
>
> **Quick install:** [click here to open Claude](https://claude.ai/new?modal=add-custom-connector\&connectorName=Hireflix\&connectorUrl=https%3A%2F%2Fmcp.hireflix.com%2Fmcp#customize/connectors/yours) with the Hireflix connector already filled in. Click **Continue**, then **Add**, and pick up at the **Click Connect** step below.

## Connect with the MCP (recommended)

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

## Use the skill

Prefer to work with an API key, or want Claude to write GraphQL for your own integration? Use the skill instead.

**1. Allow the Hireflix websites in Claude**

In Claude, click your account name and open **Settings → Capabilities**. Under **Create and edit files**, make sure **Use the internet while making files** is turned on. Then click **Manage** next to **Allowed websites**.

![The Capabilities page in Claude settings with Use the internet while making files turned on and the Manage button next to Allowed websites](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-capabilities-allowed-websites.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=64381b1776b3bf72016eb7fd19e14085)

Leave **Which sites to allow** on **Standard download sites only**. Then add each of the following websites before you start a new chat: type it in the **Add a website** field and click **Add**.

* `api.hireflix.com` — the GraphQL API endpoint Claude talks to for every query and mutation.
* `media.hireflix.com` — where signed video playback URLs resolve; needed whenever Claude fetches or plays back an interview video.
* `com-hireflix-production-media.s3-accelerate.amazonaws.com` — the signed S3 URL Hireflix issues for video uploads (intro, outro, or per-question videos).
* `images.hireflix.com` — where uploaded question images are served; needed whenever Claude fetches or shows you an image from an image prompt question. (Uploading an image goes through `api.hireflix.com`, so it doesn't need this domain.)

> [!WARNING]
>
> Missing one of these websites can cause requests to silently fail partway through a task (e.g. Claude can create a position but can't upload the video you attached). Add all four now to avoid troubleshooting it later.

![The Allowed websites page in Claude settings with the Add a website field and the Hireflix websites in the list](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-allowed-websites-add.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=84cb808e38464de08a560bd72acc1956)

**2. Get the Hireflix skill file**

Open [hireflixsl.mintlify.app/skill.md](https://hireflixsl.mintlify.app/skill.md) and save the page as `skill.md`. You can hit `CTRL + S` or on Mac `CMD + S` to store the page as `skill.md` on your machine.

**3. Upload the skill to Claude**

In Claude, click your account name and open **Settings**. Click **Customize** in the left menu and open the **Skills** tab. Then click the **Add** button in the top right and choose **Upload skill**.

![The Skills tab under Settings > Customize with the Add menu open, showing Upload skill](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-skills-add.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=910cfbb3d72ef49f52c622f35762469d)

Drag the `skill.md` file you just saved into the **Skill file** box (or click it to browse for the file), then click **Upload**. Claude runs a security scan on the skill when you upload it.

![The Upload a skill page in Claude settings with the Skill file drop zone and the Upload button](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-skill-upload-file.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=9a3cc80aa3073e10d2c68c595079134c)

**4. Start a new chat and add your API key**

Start a **new** chat (so the allowed websites from step 1 apply), and give Claude your Hireflix API key so it can authenticate against `api.hireflix.com`. See the [Quickstart](https://docs.hireflix.com/tech/quickstart.md) if you still need to create one.

> [!WARNING]
>
> When sharing an API key with Claude AI, make sure to revoke it after your session has ended as a safety precaution.

## Try it out

Start a **new** chat and ask:

```text theme={null}
Using Hireflix, can you list all positions in my account?
```

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

> [accordion] Using Claude Code (terminal)?
>
> Add the Hireflix MCP with one command:
>
> ```bash theme={null}
> claude mcp add --transport http hireflix https://mcp.hireflix.com/mcp
> ```
>
> Start Claude Code, run `/mcp`, select **hireflix**, and choose **Authenticate**. Log in to Hireflix in your browser and click **Allow**.


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