Skip to main content

​
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.
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:
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)

1

Open your connector settings

Go to 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.
2

Add a custom connector

Scroll to the bottom of the connectors list and click Add custom connector.
3

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

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

Try it

Start a new chat and ask:
Claude will ask permission the first time it uses a Framesports tool. Approve it.

​
Claude Code

1

Add the server

In your terminal — not inside a claude session — run:
Add --scope user if you want it available in every project, not just this one:
2

Check it was added

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:
Select framesports from the list, press Enter, and choose Authenticate. Your browser opens the Framesports consent screen — click Allow.Back in the terminal, the status changes to ✔ Connected.
4

Try it

If the browser doesn’t open, copy the URL printed in the terminal and open it manually.

​
ChatGPT

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

Turn on Developer mode

Click your profile picture (top right) → Settings → Apps & Connectors → Advanced settings → turn on Developer mode.
2

Create the connector

Go back to Settings → Apps & Connectors and click Create (or New connector).
3

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

Sign in and approve

Click Connect. The Framesports consent screen opens — click Allow.
5

Try it

Start a new chat, enable the Framesports connector for that chat, and ask it about your sessions.

​
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

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.
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.
Developer mode isn’t on. See the warning in the ChatGPT section above — without it, ChatGPT can’t call any of the Framesports tools.
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.