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

# Third-Party AI

> Connect Claude, Claude Code or ChatGPT to your club so you can ask your own AI assistant about your sessions, players and clips.

## What this is

Framesports publishes an **MCP server** — a standard address you can hand to an AI
assistant so it can read your club's data. Once it's connected you can ask your own
assistant things like "how did we go against Brothers on Saturday?" or "build me a deck
on our lineout" and it will answer from your real sessions.

It works with anything that supports MCP. This guide covers Claude, Claude Code and
ChatGPT.

> [!NOTE]
>
> The assistant sees exactly what **you** see — every club you're a member of, and nothing
> outside them. If you're in more than one, tell it which one you mean ("how did
> Wests go on Saturday?") and it will work it out.

## Step 1 — Copy your server URL

1. In Framesports, click your club name in the bottom-left, then **Settings**.
2. In the settings menu, under **AI**, click **Third-Party AI**.
3. Click the copy button next to **MCP Server URL**.

It looks like this:

```
https://app.framesports.ai/mcp
```

> [!NOTE]
>
> Only club **admins** can see this page. If you can't find it, ask whoever set up your
> club to send you the URL — it's the same for everyone in the club.

## Claude (claude.ai and the Claude desktop app)

[https://iframe.mediadelivery.net/embed/461277/86a73eb0-d0d3-4bff-a448-accbb2ffa70e?autoplay=true\&loop=true\&muted=true\&preload=true\&responsive=true](https://iframe.mediadelivery.net/embed/461277/86a73eb0-d0d3-4bff-a448-accbb2ffa70e?autoplay=true\&loop=true\&muted=true\&preload=true\&responsive=true)

**1. Open your connectors**

In Claude, click **Customize** in the sidebar, then **Connectors**, then **Add**.

Or go straight to [claude.ai/customize/connectors](https://claude.ai/customize/connectors).

**2. Name it and paste the URL**

* **Name** — type `Framesports`. This is just the label you'll see in the list.
* **MCP server URL** — paste the URL you copied in Step 1.

Click **Continue**.

**3. Add it**

Leave the authentication settings as they are — Framesports registers itself
automatically — and click **Add**.

**4. Connect and approve**

Click **Connect**. A Framesports pop-up opens over Claude. Sign in if you're asked to,
then click **Allow**.

**5. Let it read without asking**

On the Framesports connector page, set **Read-only tools** to **Always allow**.

Claude then stops asking before every look at your data. Anything that changes
something still asks first.

**6. Try it**

Start a new chat and ask:

```
Using Framesports, chart our tackles made and missed in each of our last five games
```

Then ask it to **add clip links to the chart** — every number becomes a link that
plays exactly those clips in Framesports.

## Claude Code

**1. Add the server**

In your terminal — not inside a `claude` session — run:

```bash theme={null}
claude mcp add --transport http framesports https://app.framesports.ai/mcp
```

Add `--scope user` if you want it available in every project, not just this one:

```bash theme={null}
claude mcp add --scope user --transport http framesports https://app.framesports.ai/mcp
```

**2. Check it was added**

```bash theme={null}
claude mcp list
```

You'll see `framesports` with **`! Needs authentication`**. That's expected — the next
step signs you in.

**3. Sign in**

Start a session by running `claude`, then type:

```
/mcp
```

Select **framesports** from the list, press <kbd>Enter</kbd>, and choose
**Authenticate**. Your browser opens the Framesports consent screen — click **Allow**.

![The Framesports consent screen, naming the assistant that is asking, with Allow and Cancel buttons.](https://mintcdn.com/framesports/3XPAZ5XFmL3fELxu/images/third-party-ai/consent-allow.png?fit=max\&auto=format\&n=3XPAZ5XFmL3fELxu\&q=85\&s=ccc02bc23d713d40ed69ba7722ce7a5d)

Back in the terminal, the status changes to **`✔ Connected`**.

**4. Try it**

```
Using Framesports, chart our tackles made and missed in each of our last five games
```

> [!NOTE]
>
> If the browser doesn't open, copy the URL printed in the terminal and open it manually.

## ChatGPT

> [!WARNING]
>
> ChatGPT needs **Developer mode** turned on to add Framesports. Without it, ChatGPT will
> connect but won't be able to use any of its tools, so the connector looks connected and
> does nothing. On Business, Enterprise and Edu workspaces an admin may need to allow it
> first.

[https://iframe.mediadelivery.net/embed/461277/e9606e1a-a2ec-495c-bdb2-0be722acfcc5?autoplay=true\&loop=true\&muted=true\&preload=true\&responsive=true](https://iframe.mediadelivery.net/embed/461277/e9606e1a-a2ec-495c-bdb2-0be722acfcc5?autoplay=true\&loop=true\&muted=true\&preload=true\&responsive=true)

**1. Turn on Developer mode**

Click your name in the bottom-left corner → **Settings** → **Security and login**,
and turn on **Developer mode**.

**2. Create the app**

Close Settings, click **Plugins** in the sidebar, then the **+** button at the top
right.

**3. Fill it in**

* **Name** — `Framesports`
* **Server URL** — paste the URL you copied in Step 1.
* **Authentication** — leave it on **OAuth**.

Tick **I understand and want to continue**, then click **Create**.

**4. Sign in and approve**

Click **Sign in with Framesports**. A Framesports pop-up opens. Sign in if you're
asked to, then click **Allow**.

**5. Let it read without asking**

On the Framesports page that opens, click **Permissions** and choose **Allow read
actions**.

**6. Try it**

Start a new chat, click **+** and pick **Framesports**, then ask:

```
Using Framesports, chart our tackles made and missed in each of our last five games
```

Then ask it to **add clip links to the chart** — every number becomes a link that
plays exactly those clips in Framesports.

## What it can do

A connection belongs to **you**, not to one club — so if you're in several, you connect
once and can ask about any of them. Once connected, your assistant can:

* **Read your sessions** — results, match stats, who played, how the game moved.
* **Read your players** — form across sessions, where they rank, their development plan.
* **Find clips** — every event in your sessions, filtered by player, session or type.
* **Build presentations** — assemble a clip deck on a theme.

It also loads short built-in guides that teach it how to read your data properly — so it
knows the difference between your side and the opposition's, and won't invent a number.

## Making changes

Your assistant can also make changes on your behalf (for example archiving a session or
building a presentation), but not silently. For anything that archives or deletes
something, can't be undone, costs credits, stops an analysis, or reaches someone outside
your club, it stops and shows you a plain-English preview of exactly what it's about to
do, naming the record and saying whether it can be undone, before it does it. Nothing
happens until you say yes; if you say no, or don't answer within ten minutes, nothing
changes and the assistant has to ask again. Routine creating and editing (like building
a presentation) doesn't need this extra step.

## What it can't do

These are always refused, no matter what you allow:

* **Anything to do with billing** — plans, credits, payments.
* **Sign-in and account identity** — passwords, who someone is.
* **Account access and sharing** — inviting people, or making something public.

Those stay with a person. If you ask your assistant to do one, it will say so.

## Managing connected assistants

Club admins can see who has connected an AI assistant on the **Third-Party AI** settings
page, below the server URL: each row shows the assistant, who authorised it, when, and
when it was last used. To remove one, open its **⋯** menu and choose **Remove access**.

> [!NOTE]
>
> A connection belongs to the person, not the club, so removing it stops that assistant
> for them everywhere, including their other clubs, on its next request. They can
> reconnect it at any time.

## Troubleshooting

> [accordion] The assistant says it can't see any data
>
> Check the connector actually finished connecting — adding the URL isn't enough on its
> own, you also have to click **Connect** and approve the Framesports consent screen.
>
> In Claude Code, `claude mcp list` should say `✔ Connected`, not `! Needs authentication`.

> [accordion] It's answering about the wrong club
>
> If you're in more than one club, name the one you mean in your question — "how did
> Wests go on Saturday?" rather than "how did we go on Saturday?". Ask it to list your
> clubs if you're not sure what they're called.

> [accordion] ChatGPT connects but never uses it
>
> Check Developer mode is on (Settings → Security and login), and that you picked
> **Framesports** from the **+** menu in that chat.

> [accordion] It's asking me to sign in again
>
> The consent screen runs on `app.framesports.ai`, so you sign in there even if you're
> already signed in elsewhere. That's normal, and it only happens when you connect or
> reconnect.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.