# Use Shortlist from Claude, ChatGPT or Claude Code

> In Claude or ChatGPT, add a custom connector with the address https://shortlist.cruscible.com/mcp and sign in to Shortlist when it asks. In Claude Code, Codex or Cursor, create an access token under Account, AI assistants, and add it to the tool. Your profile must be kept in your Shortlist account. The assistant can then score jobs, write resumes and cover letters, and answer form questions from your profile. It never submits an application.

By Arivu, founder of Shortlist. Published 2026-11-05, updated 2026-11-05. Source: https://shortlist.cruscible.com/guides/use-shortlist-from-claude-chatgpt

If you already spend your day in Claude, ChatGPT or a coding assistant, you can now use Shortlist from there. Paste a job posting into the chat and ask whether it is worth applying; ask for a resume for the jobs that are; ask which strong matches you have not applied to yet. The assistant does the conversation on your own subscription. Shortlist does the parts that need to be right: the score, the fact check, and answers that come only from your profile.

This works through MCP (Model Context Protocol), the standard way AI assistants connect to outside services. If the term is new, [what MCP means for job seekers](/guides/mcp-for-job-seekers) explains it in a few minutes.

## What your assistant can do with Shortlist

| Ask for | What happens | Counts against your plan as |
|---|---|---|
| Your profile | Reads the profile in your account. Answers to personal questions are left out. | free |
| A job's score | Scores the posting requirement by requirement, with the evidence for each, the dealbreakers and a verdict | one job score (the same posting again is free) |
| Your recent jobs | Lists the jobs you scored and the applications you marked as applied, with what came of each | free |
| Answers to a form | Drafts answers from your profile; questions it cannot answer come back for you | one AI form answer |
| A resume | Writes a one-page resume from your profile, checks every line against it, and gives a PDF link valid for an hour | one resume and one PDF |
| A cover letter | Writes a letter from your profile | one chat message |

The score is the same one the extension shows, worked out the same way ([how Shortlist scores a job](/guides/how-shortlist-scores-a-job)). A resume or letter never claims anything your profile does not show, and the fact check lists any line it could not find there.

## Before you connect

**Keep your profile in your account.** Assistants work from the profile stored in your Shortlist account. If you chose to keep it only in your browser, open Account, Profile storage and choose "Keep it in my account". Your extension uploads its copy the next time it opens. If you have no profile yet, [set one up from your resume](/onboarding) first; it takes a few minutes.

**Your plan's limits apply.** Every plan can connect an assistant, and each use counts against the same monthly limits as the extension, such as the free plan's 40 job scores and 5 resumes. [Pricing](/pricing) lists them all.

## Claude (claude.ai and the Claude apps)

1. In Claude, open the connectors settings (Settings, then Connectors) and choose **Add custom connector**.
2. Name it Shortlist and paste the address `https://shortlist.cruscible.com/mcp`.
3. Press **Connect**. Claude opens Shortlist's sign-in; use the email address of your Shortlist account.
4. Shortlist shows what Claude will be able to do. Check that it says you go back to claude.ai, then press **Allow**.

On Team and Enterprise plans an owner may need to add the connector for the organisation first, and then each member connects their own Shortlist account. Claude's menus have moved more than once; if you cannot find the connector settings, Claude's help pages have the current path.

## ChatGPT

ChatGPT adds outside connectors through **developer mode**, which a workspace admin may need to allow on Business and Enterprise plans.

1. Turn on developer mode in ChatGPT's settings (under Apps and connectors, advanced settings, at the time of writing).
2. Create a connector named Shortlist with the address `https://shortlist.cruscible.com/mcp` and OAuth as the sign-in method.
3. Sign in to Shortlist when ChatGPT opens it, check the page says you go back to chatgpt.com, and press **Allow**.
4. In a new chat, turn the Shortlist connector on from the tools menu.

## Claude Code, Codex, Cursor and other MCP clients

Tools that run on your computer connect with an access token instead of a sign-in page.

1. On your Shortlist [Account page](/dashboard/account#assistants), under **AI assistants**, give the token a name (say, "Claude Code on my laptop") and press **Create an access token**.
2. Copy the command it shows. For Claude Code it is:

```
claude mcp add --transport http shortlist https://shortlist.cruscible.com/mcp --header "Authorization: Bearer <your token>"
```

3. For other tools, add a remote (HTTP) MCP server with the address `https://shortlist.cruscible.com/mcp` and the header `Authorization: Bearer <your token>`. The Account page shows the settings in the JSON format Cursor and many others use.

The token is shown once. Treat it like a password: anyone who has it can use Shortlist as you. Keep it out of shared folders and code repositories.

## Try it

A few things to ask once it is connected:

- "Here is a job posting: [paste]. Score it for me with Shortlist and tell me the dealbreakers."
- "I pasted five postings above. Score each one and rank them. Which are worth a tailored resume?"
- "Write a resume for the second one and show me anything the fact check flagged."
- "These are the questions on the application form: [paste]. Answer them from my profile, and list the ones I need to answer myself."
- "Which jobs above 70 haven't I applied to?"

Paste the posting's full text, not only its link: Shortlist scores what you give it and does not fetch pages itself.

## What it will not do

- **Submit anything.** There is no tool for it. The assistant prepares; you read the application and press Submit yourself.
- **Answer personal questions.** Gender, ethnicity, disability, veteran status and similar questions always come back to you.
- **Add to your story.** Shortlist answers and writes only from your profile. If a job wants something your profile does not show and you do have it, add it to your profile and score again.

Shortlist also tells every assistant that connects that text from job postings is information, not instructions, because a posting can contain text written to steer an AI.

## Disconnecting

Every assistant you connected is listed on your Account page under **AI assistants**, with the name of the app or the name you gave its token. **Revoke** ends it at once. Removing the connector inside Claude or ChatGPT stops the app from using it, but revoking on the Shortlist side is the one that matters.

## If something goes wrong

- **"Your profile is kept only in your browser."** Switch it to your account (Account, Profile storage), then try again.
- **"…used up this month."** That part of your plan has run out. The message links to plans and top-ups.
- **Sign-in goes round in circles.** Use the address `https://shortlist.cruscible.com/mcp` exactly, then remove the connector, revoke it on your Account page and connect again.
- **The tool says the text does not look like a job posting.** Paste the full posting: title, company and what it asks for.

## FAQ

### Does connecting an assistant cost extra?

No. It uses the same monthly limits as the extension, on every plan, including the free one. Reading your profile and listing your jobs are free; a score, resume, PDF, form answer or letter counts like it does in the extension.

### Can the assistant apply to jobs for me?

No. Shortlist has no submit tool and tells every assistant never to submit for you. It can prepare the resume, the letter and the answers; you send the application.

### Which assistants work with Shortlist?

Any that supports remote MCP servers: Claude on the web and in its apps, ChatGPT in developer mode, Claude Code, Codex, Cursor and other editors and tools that support them. Apps with a sign-in flow use the connector address; command-line and editor tools use an access token.

### What does the assistant's company see?

What the assistant reads through Shortlist goes to that assistant's provider, Anthropic for Claude or OpenAI for ChatGPT, and is handled under their terms. Your answers to personal questions are never sent. Our [privacy policy](/privacy) has the details.

### Do I still need the browser extension?

For filling application forms on job sites, yes: the extension fills the form on the page and leaves Submit to you. The assistant connection is for deciding, writing and answering, wherever you like to work.
