> ## 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.
</Note>

## 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.
</Note>

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

<Steps>
  <Step title="Open your connector settings">
    Go to [claude.ai/customize/connectors](https://claude.ai/customize/connectors).

    Or from anywhere in Claude: click your initials in the bottom-left corner, click
    **Settings**, then **Connectors** in the left-hand menu.
  </Step>

  <Step title="Add a custom connector">
    Scroll to the bottom of the connectors list and click **Add custom connector**.
  </Step>

  <Step title="Fill in the two fields">
    * **Name** — type `Framesports`. This is just the label you'll see in the list.
    * **Remote MCP server URL** — paste the URL you copied in Step 1.

    Leave **Advanced settings** alone. The OAuth Client ID and Client Secret boxes in
    there are **optional and you do not need them** — Framesports registers itself
    automatically.

    Click **Add**.
  </Step>

  <Step title="Sign in and approve">
    Framesports now appears in your connectors list. Click **Connect** next to it.

    A Framesports window opens. Sign in if you're asked to, then click **Allow**.

    You'll be sent back to Claude, and the connector will show as connected.
  </Step>

  <Step title="Try it">
    Start a new chat and ask:

    ```
    Using Framesports, what were our last three sessions?
    ```

    Claude will ask permission the first time it uses a Framesports tool. Approve it.
  </Step>
</Steps>

## Claude Code

<Steps>
  <Step title="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
    ```
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.

    Back in the terminal, the status changes to **`✔ Connected`**.
  </Step>

  <Step title="Try it">
    ```
    Use the framesports server to list our last three sessions
    ```
  </Step>
</Steps>

<Note>
  If the browser doesn't open, copy the URL printed in the terminal and open it manually.
</Note>

## ChatGPT

<Warning>
  ChatGPT needs **Developer mode** turned on. Without it, ChatGPT will connect to
  Framesports but won't be able to use any of its tools — it only calls tools named
  `search` and `fetch`, which Framesports doesn't have. The connector will look connected
  and do nothing.

  Developer mode requires a paid plan, and on Business, Enterprise and Edu an admin may
  need to allow it first.
</Warning>

<Steps>
  <Step title="Turn on Developer mode">
    Click your profile picture (top right) → **Settings** → **Apps & Connectors** →
    **Advanced settings** → turn on **Developer mode**.
  </Step>

  <Step title="Create the connector">
    Go back to **Settings** → **Apps & Connectors** and click **Create** (or **New
    connector**).
  </Step>

  <Step title="Fill it in">
    * **Name** — `Framesports`
    * **Description** — `Read this club's rugby sessions, players, clips and stats.`
      ChatGPT reads this when deciding whether to use the connector, so don't leave it blank.
    * **MCP Server URL** — paste the URL you copied in Step 1.
    * **Authentication** — choose **OAuth**.

    Click **Create**.
  </Step>

  <Step title="Sign in and approve">
    Click **Connect**. The Framesports consent screen opens — click **Allow**.
  </Step>

  <Step title="Try it">
    Start a new chat, enable the Framesports connector for that chat, and ask it about
    your sessions.
  </Step>
</Steps>

## 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 your analysts logged, 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.

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

## Troubleshooting

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="ChatGPT connects but never uses it">
    Developer mode isn't on. See the warning in the ChatGPT section above — without it,
    ChatGPT can't call any of the Framesports tools.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>