FilmScorecardHelp

Working with an AI app

View as Markdown (opens in a new tab)

Connecting Claude

Connect Claude, on claude.ai or in the Claude desktop app, to your FilmScorecard account, then ask it about your festivals in plain words.

Once it is connected, Claude 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.

This page covers claude.ai in a browser and the Claude desktop app. The steps are the same in both. For Claude Code, the terminal app, see Connecting Claude Code.

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

  • A Claude plan that allows custom connectors. On a Team or Enterprise plan, your Claude administrator may need to add the connector for everyone first. If so, send them the address below.

  • The address. Every app needs the same one. Claude's steps on the Connections tab show it with a Copy button beside it:

    https://www.filmscorecard.com/api/mcp

There is no key, token or password to copy anywhere. Claude 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

  1. Open Connectors. In Claude, open Settings, then Connectors.
  2. Add a custom connector. Choose Add custom connector. Name it FilmScorecard, which is the name Claude will show you, and paste the address as its URL. Leave any advanced settings empty, such as a client ID or secret: Claude and FilmScorecard sort those out between them when you connect.
  3. Connect. Choose Connect beside the new connector. Your browser opens on FilmScorecard.
  4. 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.
  5. 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, the app you just added. If you did not just start connecting an app, press Deny, and nothing is connected.
  6. Press Allow. Your browser goes back to Claude, and the connector is connected.

To check it worked, open the Connections tab on your account screen: Claude reads Connected, with the date you allowed it.

Using it

Start a new conversation and ask about your festivals 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 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 exactly which films would move, and nothing changes until Claude asks again to confirm. Each tool that changes something is marked as doing so, and apps can use that mark to ask you first. See Moving films between statuses.

A change Claude 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
There is no Connectors page, or no Add custom connector, in Claude's settingsYour Claude plan may not allow custom connectors, or on a Team or Enterprise plan your administrator manages them. Ask them to add it, with the address above.
"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 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. Choose Connect in Claude again.
"This connection request is incomplete. Start again from your AI app."The page was opened from a bookmark or typed by hand. Choose Connect in Claude again.
"That didn't go through. Try again."Your answer did not reach FilmScorecard. Press Allow again. If it keeps happening, start again from Claude.
Claude 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 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 says it was told "That needs … and your role doesn't include it."Your role does not reach that screen, so Claude cannot either. See When the app is refused.

Disconnecting Claude

  1. Open Your profile in the menu behind your name, and choose the Connections tab.
  2. On Claude's row, press the amber Disconnect beside the connection.
  3. Press the amber Disconnect in the dialog.

Claude is refused from its next request. To use it again, choose Connect in Claude's settings, and FilmScorecard asks you again.

Removing the connector in Claude's own settings takes it out of Claude, but FilmScorecard keeps listing the connection until you disconnect it on the Connections tab. To tidy up completely, do both.

Related guides