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

> ## Agent Instructions
> Product noun is jobs.
> MCP at https://rest.hotfix.jobs/mcp is the hiring contract for agents with a company API key.
> Do not invent unpublished REST, hiring stats, or webhooks.
> Do not mention Greenhouse, Ashby, Quick Apply, or claim.
> Creating a draft, offer, or booking link does not send email.

# Get started

> Connect Cursor, Claude Code, or another MCP client to rest.hotfix.jobs/mcp.

Connect an MCP client to Hotfix MCP with a company API key. You are done when the client lists Hotfix tools for that company.

## Before you connect

1. Mint a company API key at **Org → API**. Any admin can create one.
2. Copy the secret when it appears. Prefix is `hf_`.
3. Keep the secret in an environment variable or a private config. Do not commit it.

URL:

```
https://rest.hotfix.jobs/mcp
```

## Connect Cursor

Create `.cursor/mcp.json` in the project, or `~/.cursor/mcp.json` for every project:

```json theme={null}
{
  "mcpServers": {
    "hotfix": {
      "url": "https://rest.hotfix.jobs/mcp",
      "headers": {
        "Authorization": "Bearer hf_…"
      }
    }
  }
}
```

Restart Cursor or reload MCP servers, then enable Hotfix. Confirm the client lists Hotfix tools.

## Connect Claude Code

Run this in the terminal:

```bash theme={null}
claude mcp add --transport http hotfix https://rest.hotfix.jobs/mcp --header "Authorization: Bearer hf_…"
```

`--scope local` is the default (this project, you only). `--scope project` writes `.mcp.json` for the team. `--scope user` is every project for you.

If the header would land in a shared file, use an environment variable your shell already has, not the raw secret.

Run `/mcp` in Claude Code and confirm Hotfix is connected.

## Connect VS Code

Create `.vscode/mcp.json` in the workspace:

```json theme={null}
{
  "servers": {
    "hotfix": {
      "type": "http",
      "url": "https://rest.hotfix.jobs/mcp",
      "headers": {
        "Authorization": "Bearer hf_…"
      }
    }
  }
}
```

Open the Command Palette and run **MCP: List Servers**. Start Hotfix. For every workspace, use **MCP: Open User Configuration** instead.

## Connect another client

Add Hotfix as a remote MCP server.

* Transport: Streamable HTTP
* URL: `https://rest.hotfix.jobs/mcp`
* Header: `Authorization: Bearer hf_…`

If the client takes JSON:

```json theme={null}
{
  "mcpServers": {
    "hotfix": {
      "url": "https://rest.hotfix.jobs/mcp",
      "headers": {
        "Authorization": "Bearer hf_…"
      }
    }
  }
}
```

If the client only speaks local stdio, bridge with `mcp-remote` and pass the same URL and header. Do not run an unofficial hiring server.

## Troubleshooting

A bad or missing key returns `401` before a tool runs.

```json theme={null}
{
  "error": "invalid_token",
  "error_description": "A valid API key is required."
}
```

Use `https://rest.hotfix.jobs/mcp`. `mcp.hotfix.jobs` is on the host allowlist, but DNS for that host is not wired.

There is no OAuth login. If the client asks you to authorize in a browser, switch it to a bearer header.

Next: [Supported tools](/hiring-mcp/tools).