The client does not open 1club sign-in
Check these items:- The endpoint is exactly
https://mcp.1club.ai. A connection made earlier athttps://mcp.1club.ai/adminalso works. - The client supports remote MCP servers with OAuth.
- OAuth is selected as the authentication method, if the client asks.
- Pop-ups are allowed for the client and
auth.1club.ai. - A workspace administrator has enabled custom MCP apps or connectors when the client requires it.
Sign-in succeeds but authorization is denied
Connecting an assistant requires the AI assistants (MCP) permission in the organization. Owners always have it, and administrators hold it by default.- If the authorization page says You are not staff of any organization, or leaves out the organization you expected, your role there does not hold the permission, or you have no gym assigned. Ask an owner or administrator to grant AI assistants (MCP) to your role in Settings > Organization > Permissions.
- If the organization is on a free plan or trial, upgrade before connecting the admin MCP server.
https://mcp.1club.me needs no 1club admin account. It only asks for a 1club.me sign-in when someone books.
A tool fails with a permission error
Ask the assistant to callget_account. It returns the authorized organization and the scopes on the connection. Read effectiveScopes, not scopes: a full-access API key reports scopes as ["*"], and only effectiveScopes spells out what that expands to. Compare that list with the tools reference.
If the scope is there and the call is still refused, your role is the limit. An OAuth connection acts as you, so in each organization and gym it can do only what your role can do in the admin. Ask an administrator to change your role’s permissions, or have someone whose role allows the action do it.
An OAuth grant’s scopes are fixed once you approve them - there is no way to widen or narrow a live connection. To change them, revoke the connection under Settings > Integrations > AI assistants (MCP), disconnect it in the client, and authorize it again, ticking the Make changes boxes you need this time.
If the assistant authenticates with a Platform API key rather than OAuth - which the admin MCP server also accepts, for developer-managed clients - then it is that key’s scopes that apply, and you edit them under Settings > Integrations > APIs & webhooks. A key is always refused the tools that change staff roles and permissions.
The assistant works in the wrong organization
An OAuth connection works in every organization you are staff of. When there is more than one, the assistant has to pick one for every call.- Name the business in your question, for example “at the Downtown studio”.
- Ask the assistant to call
get_account. It lists every organization the connection can act in, so you can check the name you used. - To stop the assistant acting in one organization at all, revoke it there under Settings > Integrations > AI assistants (MCP). It keeps working in your other organizations.
I see a mix of network and organization tools
The client is using an old or incorrect endpoint. Remove the connection and add the correct address:
A connection to
https://mcp.1club.ai/discovery stops working: the 1club server moved to https://mcp.1club.me. Remove it and add the new address.
The admin and 1club servers never expose each other’s tools.
The tool list is missing new tools
Compare the client’s list with the tools reference. Re-scan tools or remove and re-add the connection. Many clients cache the tool catalog. The admin server covers classes and progression, areas and blocks, bookings, check-ins, events, contacts and tags, instructors and the staff roster, staff roles, plans, memberships, products, charges and payments, invoices and reports, rules and policies, forms, messages and templates, the website, content, media, gyms, and competitors. A missing OAuth scope causes a permission error when a tool runs. It does not normally remove the tool from the list.Everything worked, then stopped
Check these items:- The connection was revoked. Review connected assistants in 1club.
- The person who authorized it lost access. A connection carries the access of whoever approved it. If they left the organization, or their role there lost the AI assistants (MCP) permission, the connection stops working there on its next tool call. Someone who still holds the permission has to connect the assistant again. Check this first when an assistant stops working around a staff change.
- The organization downgraded. API and MCP access stop when the paid feature is no longer available.
- It sat unused for 90 days. The client registration and its tokens are deleted, so the client has to register and authorize again.
- The client lost its refresh credentials. Disconnect and complete OAuth again. Replaying a refresh token that has already been rotated revokes the whole connection, so a client that restores an old copy of its credentials has to reconnect. Parallel refreshes are not affected: tool calls that all refresh at once are treated as one rotation.
- The rate limit was reached. MCP shares the Platform API limit of 100 requests per minute per organization. Wait a minute and retry.
A write fails even though reading works
Read and write scopes are separate. For example,classes:read does not satisfy classes:write.
The usual cause is that no write box was ticked on the authorization page. Every write capability is offered there as an individual checkbox that starts unchecked, so approving the page without touching it produces a read-only connection - which is the intended default, not a bug. Call get_account to see the granted scopes, then revoke and reconnect if the assistant genuinely needs to write.
The operation can also fail a business rule after authorization:
- A plan cannot be deleted while memberships reference it. Retire it by setting
isActivetofalse. - A class cannot be deleted while affected future occurrences have active bookings or waitlist entries.
- A booking cannot be checked in outside its configured window, when required payment is outstanding, or after it was already checked in. Only a
confirmedorpendingbooking can be checked in - a cancelled or no-show booking is rejected. - A booking that was paid or invoiced cannot be deleted. Cancel and refund it instead.
publish_websiteandrollback_websiteneed the Website Plan Addon.
The assistant invents data instead of calling a tool
Confirm the 1club app or connector is enabled for that conversation. Ask the assistant explicitly to use the 1club tools, or name the tool you expect, such aslist_classes or list_checkins.