FilmScorecardHelp

Working with an AI app

View as Markdown (opens in a new tab)

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.

For Claude on claude.ai or in the desktop app, see Connecting Claude.

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.

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

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.

If something goes wrong

What you seeWhat to do
claude: command not foundClaude Code is not installed, or your terminal cannot find it. Install it, then open a new terminal.
/mcp does not list filmscorecardYou 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 authenticateThe browser half was not finished. Run /mcp, choose filmscorecard, and authenticate again.
"AI access isn't enabled for your organization.", with Deny and no AllowNone 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.
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.
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.

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