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

# Connect your AI assistant to Fayne

> Set up Fayne in Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex, Gemini CLI or any assistant that supports remote MCP. One URL, sign in with your Fayne account, pick your academies.

Every assistant connects to the same address:

```text theme={null}
https://mcp.fayneos.com/mcp
```

There is no key to copy. The first time your assistant connects, a Fayne window opens: you sign in with your normal Fayne login, choose which academies it may work in and what it may do, and click **Allow access**. Your assistant keeps that access until you disconnect it. You'll also find the URL in Fayne under **Settings > MCP server**.

> [!TIP]
>
> The sign-in screen asks two things. **Which academies**: the ones you tick, or, if you manage more than one, all of them, including ones you create or join later. **What it may use**: courses and lessons are always included; switch on analytics and people, pricing and offers, or members and messages if you want those. You can change the areas later. See [Permissions](https://fayneos.com/docs/ai-assistants/permissions.md).

## Pick your assistant

> [tab] Claude
>
> Works on claude.ai and in the Claude desktop app. A connector you add is tied to your Claude account, so it's also available in the Claude mobile apps.
>
> **1. Open Connectors**
>
> In Claude, open **Customize > Connectors** and choose **Add custom connector**.
>
> **2. Add Fayne**
>
> Name it `Fayne` and paste the URL:
>
> ```text theme={null}
> https://mcp.fayneos.com/mcp
> ```
>
> If Claude asks how to sign in, keep **Sign in** on. If it asks which OAuth client to use, choose **Register automatically**. Click **Add**.
>
> **3. Sign in and choose your academies**
>
> Click **Connect**. A Fayne window opens: sign in, pick your academies and areas, and click **Allow access**.
>
> **4. Try it**
>
> In a new chat, ask: "List my Fayne academies and what each one is missing."
>
> > [!NOTE]
> >
> > On Claude Free you can add one custom connector. On Team and Enterprise, an organization owner first adds Fayne under **Organization settings > Connectors** (**Add > Custom > Web**, same URL); members then find it under **Customize > Connectors** with a "Custom" label and click **Connect**. Claude's sign-in options can't be changed after you add a connector: to change them, remove Fayne and add it again.

> [tab] ChatGPT
>
> ChatGPT adds Fayne as a custom app on the web. Which plans and workspaces may add custom MCP apps is set by OpenAI and your workspace admin, and changes from time to time; if you don't see the option, ask your admin or check OpenAI's help center.
>
> **1. Add a custom app**
>
> Go to **chatgpt.com/plugins**, click **+** and choose **Add custom MCP server**.
>
> **2. Enter Fayne's details**
>
> Name: `Fayne`. Server URL:
>
> ```text theme={null}
> https://mcp.fayneos.com/mcp
> ```
>
> Choose **OAuth** for authentication, confirm the notice, and create it.
>
> **3. Sign in and choose your academies**
>
> ChatGPT opens a Fayne window. Sign in, pick your academies and areas, and click **Allow access**. Review the tools and install.
>
> **4. Use it in a chat**
>
> In a new chat, type `@Fayne` and ask, for example: "@Fayne show my courses."
>
> > [!TIP]
> >
> > In ChatGPT you can attach an image to the chat and ask Fayne to use it as your logo or put it in a lesson. See [Images and files](https://fayneos.com/docs/ai-assistants/images-and-files.md).

> [tab] Claude Code
>
> Add Fayne from your terminal:
>
> ```bash theme={null}
> claude mcp add --transport http --scope user fayne https://mcp.fayneos.com/mcp
> ```
>
> Then start Claude Code and run `/mcp`, choose **fayne** and authenticate. A browser window opens for the Fayne sign-in.
>
> > [!TIP]
> >
> > `--scope user` makes Fayne available in all your projects. Use `--scope project` to share it with your team through a checked-in `.mcp.json`; each teammate still signs in with their own Fayne account. Leave the flag out to add it to the current project only.
>
> Claude Code can also send files from your computer straight to Fayne, for example "make `./logo.png` my academy's logo". See [Images and files](https://fayneos.com/docs/ai-assistants/images-and-files.md).

> [tab] Cursor
>
> Add Fayne to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "fayne": {
>       "url": "https://mcp.fayneos.com/mcp"
>     }
>   }
> }
> ```
>
> Open **Cursor Settings > MCP**. Fayne appears in the list; when it asks you to sign in, a browser window opens for the Fayne sign-in. Once connected it shows as active.

> [tab] VS Code
>
> With GitHub Copilot in agent mode, add Fayne to `.vscode/mcp.json` in your project, or to your user configuration with the **MCP: Open User Configuration** command:
>
> ```json theme={null}
> {
>   "servers": {
>     "fayne": {
>       "type": "http",
>       "url": "https://mcp.fayneos.com/mcp"
>     }
>   }
> }
> ```
>
> Start it from the file's **Start** link or the **MCP: List Servers** command. VS Code opens a browser window for the Fayne sign-in on the first connection.

> [tab] Codex
>
> Add Fayne to `~/.codex/config.toml`:
>
> ```toml theme={null}
> [mcp_servers.fayne]
> url = "https://mcp.fayneos.com/mcp"
> ```
>
> Then sign in:
>
> ```bash theme={null}
> codex mcp login fayne
> ```
>
> A browser window opens for the Fayne sign-in.

> [tab] Gemini CLI
>
> Add Fayne from your terminal:
>
> ```bash theme={null}
> gemini mcp add --transport http fayne https://mcp.fayneos.com/mcp
> ```
>
> Or add it to `~/.gemini/settings.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "fayne": {
>       "httpUrl": "https://mcp.fayneos.com/mcp"
>     }
>   }
> }
> ```
>
> In Gemini CLI, run `/mcp auth fayne` to sign in.

> [tab] Other assistants
>
> Any assistant that supports remote MCP servers can connect. Look for "Add MCP server", "Custom connector" or "Integrations" in its settings and give it:
>
> * **URL:** `https://mcp.fayneos.com/mcp`
> * **Transport:** HTTP (sometimes called "Streamable HTTP")
> * **Authentication:** OAuth, with automatic (dynamic) client registration
>
> If your assistant can't sign in with OAuth, use an [access token](#use-an-access-token) instead.

## Use an access token

For an assistant that can't open a sign-in window, such as a script, a server, or a tool without OAuth support, create an access token in Fayne:

**1. Create the token**

In the academy you want to connect, open **Settings > MCP server**, go to **Access tokens** and click **Create access token**. Give it a name you'll recognize, and switch on any optional areas it needs.

**2. Copy it now**

Fayne shows the token once. Copy it, or copy the ready-made Claude Code command shown next to it:

```bash theme={null}
claude mcp add fayne --transport http https://mcp.fayneos.com/mcp --header "Authorization: Bearer YOUR_TOKEN"
```

**3. Add it to your assistant**

Other assistants take the same URL with an `Authorization: Bearer YOUR_TOKEN` header.

> [!WARNING]
>
> An access token works for one academy, the one whose settings you created it in, and doesn't expire on its own. Treat it like a password: don't paste it into chats or shared files, and revoke it in **Settings > MCP server** (the trash icon next to it) when you no longer need it. Anyone who manages the academy can see and revoke its tokens.

## Check that it works

Ask your assistant: "Which Fayne academies can you reach, and what can you do in them?" It answers with your academies and the areas you allowed. Then try something small, like "List my courses."

## Connect more academies or more people

* **Several academies:** one connection can reach several academies, or all of them. Tick them on the sign-in screen. To change which academies a connection reaches, disconnect it and connect again. Access tokens always reach one academy.
* **Your team:** each admin connects their own assistant with their own Fayne login and sees the academies they manage. See [Team](https://fayneos.com/docs/academy/team.md).

Next: [what you can ask](https://fayneos.com/docs/ai-assistants/what-you-can-do.md).


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