# Connecting Claude Code > From FilmScorecard Help: https://www.filmscorecard.com/help/connecting-claude-code Connect Claude Code, Anthropic's terminal app, to your FilmScorecard account with one command, then ask it about your festivals in plain words. Once it is connected, Claude Code can look through what your own screens show you (submissions, judges, scorecards, awards, judge pay and settings) and answer questions about it. It acts as you, so it reaches exactly what you reach and nothing more, and **it can change only three things**: a film's status, your own flag, and Priority. Everything a connected app can do is in [Connecting an AI app](https://www.filmscorecard.com/help/connecting-an-ai-app.md#what-a-connected-app-can-do). For Claude on claude.ai or in the desktop app, see [Connecting Claude](https://www.filmscorecard.com/help/connecting-claude.md). ## Before you start - **Your organization needs AI access.** FilmScorecard switches it on one organization at a time. To check, open **Your profile** in the menu behind your name and choose the **Connections** tab: if Claude Code's row offers **How to connect**, you have it. If the **AI apps** card says "AI access isn't on for *your organization* yet", press **Request AI access**: it opens our contact form with the request already written. See [Connections](https://www.filmscorecard.com/help/your-account-settings.md#connections). - **Claude Code installed, and a terminal open.** If typing `claude` in a terminal does nothing, install Claude Code first. - **The address.** Every app needs the same one. It is already inside the command below, and Claude Code's steps on the Connections tab show the whole command with a **Copy** button beside it: ``` https://www.filmscorecard.com/api/mcp ``` **There is no key, token or password to copy anywhere.** Claude Code never sees your sign-in code: FilmScorecard gives it a pass of its own when you allow it, and you can take that back at any time. ## Connecting Claude Code 1. **Add the server.** In a terminal, run: ``` claude mcp add --transport http filmscorecard https://www.filmscorecard.com/api/mcp ``` `filmscorecard` is the name Claude Code shows for the connection. Any name will do. **As written, the connection belongs to the folder you ran it in.** To have it in every folder, add `--scope user`: ``` claude mcp add --transport http --scope user filmscorecard https://www.filmscorecard.com/api/mcp ``` 2. **Authenticate.** Start Claude Code in the same folder and run `/mcp`. **filmscorecard** is listed as needing you to authenticate. Choose it, then choose to authenticate. Your browser opens on FilmScorecard. 3. **Sign in, if FilmScorecard asks.** If you are not signed in to FilmScorecard in that browser, you get the log-in screen first. Sign in with your emailed code as usual (see [Logging in](https://www.filmscorecard.com/help/logging-in.md)), and you come straight back. 4. **Check the request.** The connection page asks whether to let the app in. It shows the app's name, with "wants to connect to your account." under it; **Will act as**, which is the address you sign in with; and **It can**, which reads "read and update festival data you already have access to". **Make sure it names Claude Code, the app you just added.** If you did not just start connecting an app, press **Deny**, and nothing is connected. 5. **Press Allow.** Your browser tells you that you can go back to Claude Code, and `/mcp` shows **filmscorecard** as connected. **To check it worked**, open the **Connections** tab on your account screen: Claude Code reads **Connected**, with the date you allowed it. ## Using it Ask about your festivals in Claude Code the way you would ask a colleague. For example: - "Which festivals and seasons can you see in FilmScorecard?" - "Give me an overview of this season's submissions and judging." - "List the films in this season that are still In Consideration." - "Mark these three films as Priority." **Claude Code starts by finding your festivals**, because every other question names an organization, a festival or a season. If you belong to more than one, say which one you mean. **It changes only three things, and a status move is always previewed first.** Before any film moves between In Consideration, Selected and Not Selected, FilmScorecard shows Claude Code exactly which films would move, and nothing changes until Claude Code asks again to confirm. Each tool that changes something is marked as doing so, and Claude Code can use that mark to ask you first. See [Moving films between statuses](https://www.filmscorecard.com/help/connecting-an-ai-app.md#moving-films-between-statuses). **A change Claude Code makes is the same change you would make on the Submissions screen**, made as you. Your colleagues see it on their own screens when their list next refreshes. **For more to ask, and habits that get better answers**, see [Using an AI app](https://www.filmscorecard.com/help/using-an-ai-app.md). ## If something goes wrong | What you see | What to do | | --- | --- | | `claude: command not found` | Claude Code is not installed, or your terminal cannot find it. Install it, then open a new terminal. | | `/mcp` does not list **filmscorecard** | You started Claude Code in a different folder from the one you added it in. Add it again there, or add it with `--scope user` so every folder has it. | | **filmscorecard** still needs you to authenticate | The browser half was not finished. Run `/mcp`, choose **filmscorecard**, and authenticate again. | | "AI access isn't enabled for your organization.", with **Deny** and no **Allow** | None of your organizations has AI access, or you are signed in on an account that belongs to no organization, such as a judge's. Press **Deny** so Claude Code stops waiting, then press **Request AI access** on your Connections tab. | | "This connection request has expired or was already answered. Start again from your AI app." | A request does not last long and can be answered once. Authenticate again from `/mcp`. | | "This connection request is incomplete. Start again from your AI app." | The page was opened from a bookmark or typed by hand. Authenticate again from `/mcp`. | | "That didn't go through. Try again." | Your answer did not reach FilmScorecard. Press **Allow** again. If it keeps happening, authenticate again from `/mcp`. | | Claude Code says it was told "Too many calls in the last minute. Wait a moment and try again." | Each person can make 120 calls a minute across every app they have connected. Wait a moment. See [120 calls a minute](https://www.filmscorecard.com/help/connecting-an-ai-app.md#120-calls-a-minute). | | Claude Code says it was told "AI access isn't enabled for this organization." | AI access for that organization has been switched off since you connected. See [When AI access is switched off](https://www.filmscorecard.com/help/connecting-an-ai-app.md#when-ai-access-is-switched-off). | | Claude Code says it was told "That needs … and your role doesn't include it." | Your role does not reach that screen, so Claude Code cannot either. See [When the app is refused](https://www.filmscorecard.com/help/connecting-an-ai-app.md#when-the-app-is-refused). | ## Disconnecting Claude Code 1. Open **Your profile** in the menu behind your name, and choose the **Connections** tab. 2. On **Claude Code**'s row, press the amber **Disconnect** beside the connection. 3. Press the amber **Disconnect** in the dialog. **Claude Code is refused from its next request.** To use it again, authenticate again from `/mcp`, and FilmScorecard asks you again. **Removing the server from Claude Code takes it out of Claude Code, but FilmScorecard keeps listing the connection** until you disconnect it on the Connections tab. To tidy up completely, do both. To remove it from Claude Code, run: ``` claude mcp remove filmscorecard ``` ## Related guides - [Using an AI app](https://www.filmscorecard.com/help/using-an-ai-app.md): what to ask it, and how to get good answers. - [Connecting an AI app](https://www.filmscorecard.com/help/connecting-an-ai-app.md): everything a connected app can do, the 34 tools, what it is never given, and every sentence it is told when it is refused. - [Your account settings](https://www.filmscorecard.com/help/your-account-settings.md#connections): the Connections tab. - [Connecting Claude](https://www.filmscorecard.com/help/connecting-claude.md), [Connecting ChatGPT](https://www.filmscorecard.com/help/connecting-chatgpt.md), [Connecting Cursor](https://www.filmscorecard.com/help/connecting-cursor.md) and [Connecting another AI app](https://www.filmscorecard.com/help/connecting-another-ai-app.md).