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

# Troubleshoot your AI assistant connection

> Fix connection and sign-in problems, understand every message your assistant can get from Fayne, and know what to send support.

## Connecting and signing in

> [accordion] The Fayne sign-in window never opens
>
> Your assistant may have saved a failed attempt. Remove Fayne from your assistant's settings and add it again with `https://mcp.fayneos.com/mcp`. In Claude Code run `claude mcp remove fayne`, add it again, then `/mcp`. Pop-up blockers can also stop the window: allow pop-ups for your assistant and retry.

> [accordion] Claude says it couldn't register or sign in
>
> When you add the connector, choose **Register automatically** if Claude asks which OAuth client to use. Claude doesn't let you change this afterwards, so remove Fayne and add it again with that option.

> [accordion] I can't find where to add a custom connector in ChatGPT
>
> Custom MCP apps depend on your ChatGPT plan and your workspace admin's settings. Ask your admin to allow custom MCP apps, or use another assistant from [Connect your assistant](https://fayneos.com/docs/ai-assistants/connect.md).

> [accordion] It connected, but it can't see my academy or course
>
> The connection only reaches the academies you ticked on the sign-in screen. Ask your assistant "Which Fayne academies can you reach?" To add an academy, disconnect it in **Settings > MCP server** and connect again, ticking the academy, or choose all your academies.

> [accordion] It was working and now says it's not authorized
>
> The connection was disconnected in Fayne, or its access token was revoked. Connect again from your assistant's settings, or create a new token. If you were removed as an admin of an academy, connecting again won't bring it back: ask the owner to add you to the team again.

> [accordion] My assistant doesn't use Fayne at all
>
> Make sure the Fayne connector is switched on for this chat; some assistants let you pick connectors per conversation. In ChatGPT, mention `@Fayne`. Then ask directly: "Use Fayne to list my courses."

## Messages your assistant may get

Fayne tells your assistant what went wrong and what to do next, and it should pass that on to you in plain words. If you want the detail, here is what each one means.

| What it says | What it means | What to do |
| - | - | - |
| Needs an area you haven't allowed | The request needs **Analytics and people**, **Pricing and offers**, or **Members and messages**. | Switch the area on in **Settings > MCP server**, then ask again. |
| The academy is paused | The academy's plan has lapsed, so it's read-only. | The academy owner reactivates the plan in **Settings > Billing**. |
| A plan limit | For example, the most courses your plan allows. | Remove something, or upgrade. Nothing was half-created. |
| Rate limit reached | More than 100 changes in 60 seconds from this connection. | Wait the number of seconds it gives. |
| Not found, or that academy isn't reachable | The course, lesson or person isn't in the academies this connection reaches, or was deleted, or you lost access to that academy. | Ask it to list what it can see, or check the academy. |
| That confirmation expired or was already used | The preview is older than 10 minutes, was made by another connection, or something it depends on changed. (Confirming the same preview twice just returns the first result.) | Ask for a fresh preview and confirm that one. |
| Still in progress | The same change is still running. | Wait a few seconds and ask again. |
| Failed partway | Something went wrong after the change may have started. | Ask your assistant to check the current state before trying again. |
| The lesson changed since it was read | Someone, maybe you in the editor, saved the lesson in between. | Your assistant re-reads the lesson and tries again. |

## Images and uploads

> [accordion] "That link is a web page, not an image file"
>
> Open the image itself, right-click it and choose **Copy image address**, and give your assistant that link.

> [accordion] "The site blocks downloads or needs a sign-in"
>
> The image's website won't let Fayne download it. Use an image you can open without signing in, or ask your assistant for an upload link and upload it from your computer.

> [accordion] The upload page says the link expired or isn't valid
>
> Upload links work for 30 minutes and for one image. Ask your assistant for a new link.

> [accordion] The upload page says the image can't be used
>
> Check the format and size in [Images and files](https://fayneos.com/docs/ai-assistants/images-and-files.md). Logos and favicons can't be GIFs, and SVGs can't contain scripts. Drop a different file on the same page.

> [accordion] "The upload didn't go through"
>
> Your connection dropped or a network filter blocked the upload. Try again on the same page, or on another network.

## In the editor

> [accordion] "Your assistant changed this lesson" appears in the editor
>
> Your assistant saved the lesson while you had unsaved edits in it. (A change from another tab or a teammate shows **Changed elsewhere** instead.) Choose **Load latest** to see its version (your unsaved edits to that lesson are discarded) or **Keep mine** to save yours over it. See [How changes stay safe](https://fayneos.com/docs/ai-assistants/safety.md#working-in-the-editor-at-the-same-time).

> [accordion] My assistant says it changed a lesson, but I don't see it
>
> Click back into the editor tab: it checks for changes as soon as you return. While the tab is open, changes appear within seconds while an assistant is working in your academy, and otherwise within about 30 seconds. If you still don't see it, reload the page.

> [accordion] Members don't see the changes
>
> Lesson edits are drafts until published. Publish them in the editor, or ask your assistant to publish the lesson changes.

## Contact support

[Contact support](https://fayneos.com/docs/support.md) with:

* the assistant you use (for example Claude or ChatGPT) and the academy,
* the approximate time,
* the message you or your assistant saw.

Don't send access tokens, passwords or private lesson content.


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