Frequently Asked Questions about AI Agents (MCP)
Below is a selection of common questions covering the following areas:
Some answers link to full articles for more detail, while others are provided directly here. If you cannot find the information you need, please contact our Support Team.
Setup
Full Guide: Connect Your Own AI Agent
What is the GymMaster MCP server?
It lets you use GymMaster from the AI app you already use, such as Claude or ChatGPT. Ask a question in the app, and it gets the answer from your GymMaster data.
MCP (Model Context Protocol) is the standard that AI apps use to connect to other software. GymMaster gives the agent the same tools as Gymmy, so it can:
- Run reports and KPIs, and compare periods
- Look up members, memberships, visits and bookings
- Find members at risk of cancelling, debtors, failed payments and memberships that expire soon
- Check class attendance, no-shows and instructor performance
- Read the class schedule, availability and tasks
- Search the GymMaster user manual and your settings
- Help build your own website or app on the member API v4 (beta). Refer to Build your own website or app with the member API
Which version of GymMaster do I need?
Version v1750 or higher. If your site is on an older version, contact our Support Team about an upgrade.
Should I use Gymmy or my own AI agent?
Both use the same tools. They differ in where you chat, how you pay for the AI, and who sees member names.
| Gymmy | Your own agent | |
|---|---|---|
| Where you chat | On your Home dashboard in GymMaster | In your AI app, such as Claude or ChatGPT, next to your other work |
| How you pay | Your club enters an API key from an AI provider. The provider charges for usage (tokens), so long questions and large reports cost more. See Setup Gymmy. | Your plan with the AI provider, such as Claude Pro or ChatGPT Plus. GymMaster does not need an API key. Large reports use more of the usage limit of your plan. |
| Member names you see | Real names. GymMaster puts the names back into the answer before it shows it to you. | Tokens such as Member#123, unless you select Show member names |
| Member names the AI provider gets | Never. The provider gets only tokens such as Member#123. |
Tokens, unless you select Show member names. Then the provider gets real names. |
Use Gymmy when staff must see member names but names must not go to an AI provider. You can use both.
Which AI agents can connect?
- Claude (web, desktop and mobile)
- ChatGPT
- Claude Code
- Codex (OpenAI)
- Gemini CLI (Google)
- Cursor
- VS Code (GitHub Copilot)
An app on your own computer that supports MCP, OAuth sign-in and the Streamable HTTP transport can also connect. An AI app that runs on a website can connect only if it is in the list above. This stops an unknown website from getting access to your data.
What is the server address?
It is your GymMaster site address with /mcp/staff at the end, for example:
https://yourclub.gymmasteronline.com/mcp/staff
Go to Settings > Integrations > AI to see the address for your site. Click it to copy it.
How do I connect an agent?
- Go to Settings > Integrations > AI and find Use GymMaster in your AI app (MCP).
- Select your agent in Your AI agent. GymMaster shows the steps for that agent, with your server address already in them.
- Do the steps. The agent opens GymMaster in your browser.
- Log in to GymMaster if it asks you to.
- Select the options that you want, then click Allow.
You do not need a password or key for the agent. When you click Allow, GymMaster gives the agent its own sign-in, which you can revoke at any time.
How do I connect Claude?
- On claude.ai, open Settings, then Connectors.
- Click Add custom connector.
- Enter the name yourclub (GymMaster) and your server address, then click Add.
- Click Connect. Log in to GymMaster if it asks you to, then click Allow.
You add the connector one time. It then works in Claude on the web, in the desktop app and in the mobile app. On a Team or Enterprise plan, an owner must add the connector first, in Admin settings.
How do I connect ChatGPT?
- In ChatGPT, open Settings, then Apps & Connectors.
- Under Advanced settings, turn on Developer mode.
- Click Create. Enter the name yourclub (GymMaster) and your server address.
- Set Authentication to OAuth, then click Create.
- Log in to GymMaster if it asks you to, then click Allow.
How do I connect Claude Code?
Run this in a terminal, with your own server address:
claude mcp add --transport http yourclub-gymmaster https://yourclub.gymmasteronline.com/mcp/staff
Start Claude Code and type /mcp. Select yourclub-gymmaster, then Authenticate. Your browser opens GymMaster. Log in if it asks you to, then click Allow.
How do I connect Codex, Gemini CLI, Cursor or VS Code?
Each of these agents reads the server address from a settings file:
| Agent | Settings file | Sign-in step |
|---|---|---|
| Codex | ~/.codex/config.toml |
Run codex mcp login yourclub-gymmaster |
| Gemini CLI | ~/.gemini/settings.json |
Type /mcp auth yourclub-gymmaster in Gemini CLI |
| Cursor | ~/.cursor/mcp.json |
In Settings > MCP, click Connect next to yourclub-gymmaster |
| VS Code | .vscode/mcp.json |
Start the server, then click Allow when VS Code asks you to sign in |
Select the agent in Settings > Integrations > AI to get the text for the file, with your server address in it. Click Copy and paste it into the file. Then do the sign-in step, log in to GymMaster if it asks you to, and click Allow.
Who can connect an agent?
Staff with an AI Agent role. An administrator sets it on the Permissions tab of the staff member: Basic lets them connect an agent that can read data and make pages, Intermediate also lets them select Allow changes, and Admin also lets them select Show member names. The staff member must also have a staff role that lets them see club data, such as reports, members or the schedule.
You cannot connect an agent while you mimic a staff member, because the agent would then act as that staff member.
Which of my staff already have an AI Agent role?
When the AI Agent role arrived, GymMaster gave each staff member a level based on the roles they already had:
- Staff with the Admin level in all of Member, Schedule, Task, Point of Sale, Report, Dashboard, Settings, Administrative and Doors Access got Admin.
- Staff with the Admin level in Administrative, but not in all of the others, got Basic.
- Everyone else got No Access, and so do new staff members.
You can change anyone’s level on the Permissions tab of their staff account. Staff with the Admin level in Administrative can give any level. Other administrators can only give a level up to their own.
Can I connect more than one agent?
Yes. Each agent has its own connection, its own options and its own Revoke button. For example, you can connect Claude with Show member names and Claude Code without it.
Access and Privacy
Full Guide: Options
What data can the agent see?
The agent acts as you, at the club that you logged in to. It sees only the data that your staff roles let you see. If you cannot run reports in GymMaster, the agent cannot run them for you.
Does the agent see member names and contact details?
Not unless you allow it. By default, members and staff show as tokens such as Member#123 and Staff#4. The number is the ID of the member or staff member in GymMaster, so you can find them yourself. Email addresses, phone numbers and street addresses are removed.
The agent can read the feedback that members give when they cancel, so it can tell you why members leave. Email addresses and phone numbers in that feedback are removed.
If you select Show member names when you connect, the agent gets the real names of members and staff. Contact details, dates of birth, notes and medical details stay hidden.
Who is responsible for member names that the agent sees?
Your club. The agent sends what it sees to its AI provider, such as Anthropic or OpenAI. If you select Show member names, member names go to that provider. Make sure that this agrees with your privacy policy and the privacy law in your country.
Only staff with the Admin level of the AI Agent role can select Show member names.
Does my AI provider train its models on our data?
That depends on your provider and your plan, not on GymMaster. Check the data and privacy settings of your AI app. Business plans, such as Claude Team and ChatGPT Business, usually do not use your chats for training.
How long does a connection stay active?
A read-only connection stays active until you revoke it.
A connection with Allow changes or Show member names stops after 30 days. Connect the agent again to continue. This makes sure that a person checks these options at regular intervals.
How do I stop an agent?
- Go to Settings > Integrations > AI, or the Security tab of your account.
- Click Revoke next to the agent.
The agent stops at once. Administrators see the agents of all staff at the club, and can revoke any of them.
GymMaster also stops all agents of a staff member when:
- The staff member changes their password
- An administrator logs them out
- An administrator removes their AI Agent role
If an administrator lowers the AI Agent role instead, the agent keeps working but loses Allow changes or Show member names.
Does GymMaster record what the agent does?
Yes. GymMaster records each tool that an agent uses, with the staff member that it acts for. It also records each connection that shows names or can change data.
Changing Data
Can the agent change data?
Only if you select Allow changes when you connect. Without it, the agent can only read data, make pages and send feedback.
With Allow changes, the agent can:
- Classes: create a class or add it to the schedule, change its capacity, prices or booking rules, change the times or dates of sessions (for example over a public holiday), or cancel sessions
- Bookings: book members into classes, book appointments, cancel bookings (with or without a late cancellation fee), manage waitlists, and mark attendance (check in, no-show with or without the fee, or undo a check-in)
- Staff: change staff availability and the roster
- Members: add or remove member labels, add notes and call logs, send an email to a member, add or update prospects, and update member details
- Memberships: sell a membership, cancel memberships, add or change holds, and move members from one membership type to another
- Membership types: add a membership type, change its name, description, benefits or questionnaires, or discontinue it
- Discount codes: create a code, or change its dates, use limit or clubs
- Tasks: create, change or delete staff tasks
- Reports: create or change reports, and change report and KPI emails
- Club setup: change branding, club files, email templates, agreements, questionnaires and club settings
The agent can make only the changes that your staff roles let you make in GymMaster.
Does the agent ask before it changes something?
Yes. Each change tool shows a preview first, for example the old and new class times and how many members are booked. The agent must show you the preview and get your agreement before it makes the change.
Read the preview carefully. The agent decides what to send to GymMaster, and it can make mistakes.
Do members get emails when the agent makes a change?
Yes, the same emails as when you make the change in GymMaster. For example, members get your booking change email when a class time changes, and your check-in email when the agent checks them in. A late cancellation fee or no-show fee is charged to the member, as when you charge it in GymMaster.
Is Allow changes safe?
Text from members, such as notes and messages, can contain instructions that trick an agent into changes that you did not ask for. Select Allow changes only for an agent that you trust, and read each preview before you agree. When you only want answers, connect without Allow changes.
Connection Problems
“Your staff roles do not let you connect an AI agent”
Your staff account does not have an AI Agent role. Ask an administrator to give you one on the Permissions tab of your account.
“Your staff roles do not give you access to the GymMaster AI tools”
Your staff roles do not let you see the club data that the agent uses, such as reports, members or the schedule. Ask an administrator for the roles that you need.
“Stop mimicking before you connect an AI agent”
Stop the mimic, then connect with your own account.
“This sign-in has expired” or “This sign-in link is not valid”
The sign-in took too long, or the link came from an old attempt. Start the connection again in the agent.
My AI app is not in the list and cannot connect
If the app runs on a website, GymMaster does not accept it. Only the websites of the agents in the list can connect, so that an unknown website cannot get access to your data. An app on your own computer can connect if it supports OAuth sign-in and the Streamable HTTP transport.
I cannot find Add custom connector in Claude
On a Team or Enterprise plan, an owner must add the connector first, in Admin settings. Some Claude plans do not have custom connectors.
I cannot find Create in ChatGPT
Turn on Developer mode first, under Advanced settings in Apps & Connectors. Some ChatGPT plans do not have developer mode.
My agent stopped working
The connection was revoked or stopped. This occurs when:
- A connection with Allow changes or Show member names is older than 30 days
- You changed your password
- An administrator logged you out or revoked the agent
- An administrator removed your AI Agent role
Connect the agent again. In Claude, go to Settings > Connectors and click Connect next to GymMaster.
The agent says that it cannot use a tool
The tool needs a staff role that you do not have, or it changes data and you did not select Allow changes. Ask an administrator for the role, or connect the agent again with Allow changes.
The agent says that there are too many requests
GymMaster lets each agent make 120 requests a minute. Wait a minute, then ask again. Ask for one report for a long period, not many reports for short periods.
The agent says that a setting is off
Some features, such as a guest pass benefit or the Day Pass membership basis, need a setting. The agent gives you a link to the setting. You can turn on a setting that you can see. For a hidden setting, contact our Support Team.
Using an Agent
What can I ask the agent?
Ask about your club in your own words, as you would ask a colleague. For example:
- Members: “How many members have the Weekly Gym membership?” “Which members are at risk of cancelling?” “What did members say when they cancelled last month?”
- Sales: “Compare new sign-ups this quarter to last quarter.” “How much revenue did each membership type bring in last month?”
- Classes: “Which classes had low attendance last month?” “Which members do not come to their bookings?”
- Billing: “Who owes money?” “Which payments failed this week?”
- Help: “How do I set up a class pack?” “Where is the setting for booking reminders?”
How do I get better answers?
- Give a date range, such as “last month” or “1 July to 30 September”.
- Ask the agent which report or KPI it used, then check an important number in GymMaster.
- Ask for a table or a chart when you want to compare numbers.
- Without Show member names, use the member ID, such as
Member#123, to find a member in GymMaster.
Can the agent make a page or a chart that I can keep?
Yes. Ask the agent for a page, such as a chart of class attendance. Your agent may call the page an artifact, which is the same thing. The agent gives you a link to a preview in GymMaster. Open it, then tell the agent to save it or what to change. A preview that you do not save is removed after 24 hours.
The agent can build the page with live data, so the numbers are fresh every time someone opens it. Each person who opens the page sees only the data their own roles allow.
You need a Report role at the club.
To see your pages, click View your AI pages in Settings > Integrations > AI. Only you and the full administrators of your club can open a page until a staff member with the Report admin role shares it. See Pages for more.
Why does the agent say that it cannot make a page?
The most common reasons are:
- You do not have a Report role at the club.
- You already have 50 pages, or you made 20 in the last day. Delete one that you no longer need, or try again tomorrow.
Can the agent see more than one club?
The agent uses the club that you logged in to. Some tools, such as KPIs and member search, can show all clubs when your staff roles give you access to all of them.
Can the agent make mistakes?
Yes. An AI agent can misread a question or a report. Check important numbers in GymMaster before you act on them, and read each preview before you agree to a change.
Common Questions This Covers
- How do I connect Claude or ChatGPT to GymMaster
- What is the GymMaster MCP server address
- How do I set up the GymMaster MCP server
- Which AI agents can connect to GymMaster
- Which version of GymMaster do I need for AI agents
- What is the difference between Gymmy and an AI agent
- Who can connect an AI agent
- What personal details does an AI agent see
- Does my AI provider train on our member data
- Can an AI agent change data in GymMaster
- Do members get emails when an AI agent makes a change
- How do I revoke an AI agent
- Why did my AI agent stop working
- What can I ask an AI agent about my club
- Can an AI agent make a page or chart of my data
- Why can my AI agent not make a page