# Connect your MCP client
Connect Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code, Devin Desktop (Windsurf), or another remote MCP client to Creator MCP.

Add Creator MCP to the AI app you already use, sign in with your LottieFiles account, and start asking for animations. You only need this server address:

```text
https://creator.mcp.lottiefiles.com/mcp
```

## Claude and ChatGPT (no terminal)

Use these steps in your browser or the desktop app. You don't need to install anything. Setup takes about two minutes, and you only do it once. Claude and ChatGPT both support MCP Apps, so you can also [preview and refine animations in the chat](/en/developers/creator-mcp/preview).

<Callout type="info" title="Before you start">
  You need a LottieFiles account. Adding your own connector depends on your plan: Claude Free allows one custom
  connector, and on Claude Team or Enterprise an Owner adds it first. In ChatGPT Business or Enterprise workspaces, an
  admin must allow creating plugins with MCP servers.
</Callout>

### Claude

<Steps>
  <Step title="Open Connectors">
    In Claude on the web or in the desktop app, open **Customize → Connectors**. Select **+ Add**, then **Add custom connector**.

    <Image src="https://assets.docs.lottiefiles.com/static/2623c4e586-640.webp" alt="Claude Customize page on the Connectors tab with the Add menu showing Add custom connector" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/2623c4e586-640.webp 640w" width="875" height="444" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAECAYAAACzzX7wAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAYUlEQVR4nDWNSQ7DIAwA+QO2EYuoS6TQnNNTlf9/a6og5T5LGGNwHB9SSvTeaa0RY2TOnev6EXLJ5JwxM0op1FpRVeacfM+TsG0Dd8dMl/nAd01ECG93+qsvS1QW8BTu3R/9fSrJJqI2hwAAAABJRU5ErkJggg==" />
  </Step>

  <Step title="Enter the server details">
    Enter **Creator MCP** as the name, paste the server address above, and select **Continue**.

    <Image src="https://assets.docs.lottiefiles.com/static/d3ca28616f-640.webp" alt="Add custom connector dialog with the name Creator MCP and the server address filled in" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/d3ca28616f-640.webp 640w, https://assets.docs.lottiefiles.com/static/d3ca28616f-1024.webp 1024w" width="1086" height="836" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAGCAYAAAD+Bd/7AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAgklEQVR4nC2OWw7DIAwEc6KkBLAxjyQSd4hUVb3/MaaC5mPkn/HuLqpKOw4sF7z3OC+TPSbWdWVJKVHbSVQjhECUSIyCqLJtG0sphd4713VSa2UkDlFE/sKsaG2SszESB2ZPhYjOz1wKuTY0GaJp3ik45+a4/Rn42gNBjPfny33f/ABG109pgtlwmgAAAABJRU5ErkJggg==" />
  </Step>

  <Step title="Keep the detected sign-in settings">
    Claude detects how the server signs you in. Keep **Sign in now** and **Use Claude's published identity**, then continue and select **Add**.

    <Image src="https://assets.docs.lottiefiles.com/static/99ea887f97-640.webp" alt="Sign-in settings with Sign in now and Use Claude's published identity selected" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/99ea887f97-640.webp 640w, https://assets.docs.lottiefiles.com/static/99ea887f97-1024.webp 1024w" width="1080" height="1300" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAKCAYAAACJxx+AAAAACXBIWXMAAAAAAAAAAAHqZRakAAAAn0lEQVR4nD2OWxLEIAgEvVFK8QGYqMne/0yzBan40aXCgB1UBWNMiCpSSohUNokIwQJNFFQYRIREeRNjRNB+wkKZyANWPI5jE7QPrDnBzN600IdvYG647xu9dw+JyD5LKQitNW/mnFFr9aJhd5MOjQXCr6BLprR5Ja+J3/NgrYUxBlTVtxk2ELi9Dtd5wr77HOxuIXewyTmnT9v787ANf54PgteEq9q5AAAAAElFTkSuQmCC" />
  </Step>

  <Step title="Approve access on LottieFiles">
    If Claude shows a **Connect** button, select it first. On the LottieFiles approval page, check that the application is **Claude** and that you recognize the address shown under **After approval you will be sent to**. If the address is unfamiliar, don't approve. Select **Approve**, then sign in to LottieFiles if asked.

    <Image src="https://assets.docs.lottiefiles.com/static/267554f22b-640.webp" alt="LottieFiles page asking you to approve MCP access for Claude" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/267554f22b-640.webp 640w, https://assets.docs.lottiefiles.com/static/267554f22b-1024.webp 1024w" width="1072" height="924" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAHCAYAAAA1WQxeAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAq0lEQVR4nD2NsWrDMBQA9ftds/YTOmTOD3TqUEoCCYG02FBK/CRZkaxY2E8XUKDDwQ0HZ1KaGEQQsYi1DINwvQ6MIaCqGOdHur7Hed8C6xzWuhYs64pJUybExKqVZVW01n9vQb7PuPHW8OFJzJlcCmVZMCUHonwTbUeSDs0COkGdqFow83zHOWncYmDXX9j+nHm7nDh6i6mV9ipzaf/X457N4ZOXrw/e/355AKmq1Bx+jxqBAAAAAElFTkSuQmCC" />
  </Step>

  <Step title="Turn it on in a chat">
    In a new chat, select **+ → Connectors** and make sure **Creator MCP** is on. Then ask for an animation.

    <Image src="https://assets.docs.lottiefiles.com/static/74d5917332-640.webp" alt="Claude chat menu with Connectors open and Creator MCP switched on" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/74d5917332-640.webp 640w, https://assets.docs.lottiefiles.com/static/74d5917332-1024.webp 1024w" width="1516" height="800" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAECAYAAACzzX7wAAAACXBIWXMAAAAAAAAAAAHqZRakAAAAb0lEQVR4nD3F0QqDIBiAUd9i/nURmJuGkCTqqMZabPj+b/QNdrFzc9Q0TeSciTES55m0LP+NMSjnHMdxUEsh1cLr8+bxPLneHH3foUIItNbYt426rdR9pdY7wzCg9QVlrSWlhPeecRzpRBDRyG/hC626MIeaPDONAAAAAElFTkSuQmCC" />
  </Step>
</Steps>

On Team and Enterprise plans, an Owner first adds the connector in **Organization settings → Connectors**. Members then select **Connect** in **Customize → Connectors**. See [Claude's custom connector guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

### ChatGPT

<Steps>
  <Step title="Open Plugins">
    In ChatGPT on the web or in the desktop app, open **Plugins** in the sidebar. Select **Add**, then **Create custom MCP server**.

    <Image src="https://assets.docs.lottiefiles.com/static/f5bcf79a06-640.webp" alt="ChatGPT Plugins page with the Add menu open and Create custom MCP server listed" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/f5bcf79a06-640.webp 640w" width="974" height="375" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAADCAYAAACuyE5IAAAACXBIWXMAAAsTAAALEwEAmpwYAAAATklEQVR4nB2MMQoAIAwDfYGKtkVBF3F29P8/O6lTCHdJmHPSe6fWiohQSqG1xt6bey/BBTMjxkhK6edai3MOYwyCiaCqH+ac8YEDf/X+AOS/HuomhrE5AAAAAElFTkSuQmCC" />
  </Step>

  <Step title="Enter the server details">
    Enter **Creator MCP** as the name and paste the server address above. Leave **Authentication** as **OAuth**. You don't need to change **Advanced OAuth settings**.

    <Image src="https://assets.docs.lottiefiles.com/static/9931ae5f37-613.webp" alt="Add custom MCP server form with the name and server address filled in and Authentication set to OAuth" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/9931ae5f37-613.webp 613w" width="613" height="757" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAKCAYAAACJxx+AAAAACXBIWXMAAAAAAAAAAAHqZRakAAAA10lEQVR4nD1QW4qEQAzMEQZkxnHbXrXV9t2vVRAXZm/gZbw/NaRh9qMIoSqppGieZ+z7DucclFIoiiJCSok8z0F932McR7Rti67rwD3XpmlQliXIGINt26KIyQ+GYYgiYosQApZliSKt9T+qqgJZa+G9j+Q0TXE9k7ylrmvQYgzWdY1Hsh0PMLhnMVlr8Pd64fc48BM8vHPwziJ4h77ToPx5h5JfqKSA+hYoRIY0ueGZ3JA97qBMFNC6h9Zd9OTfhRBI0xRJkoA4HM7gQ3BAx3Hgui6c54k3XCt1ff2pavgAAAAASUVORK5CYII=" />
  </Step>

  <Step title="Create the plugin">
    Tick **I understand and want to continue**, then select **Create as a plugin**. On smaller screens, scroll down inside the form to reach the button.

    Select **Connect Creator MCP**.

    <Image src="https://assets.docs.lottiefiles.com/static/8598ae4822-640.webp" alt="ChatGPT dialog to connect Creator MCP with a Connect Creator MCP button" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/8598ae4822-640.webp 640w" width="994" height="984" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAICAYAAADED76LAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAr0lEQVR4nFWOtw2FUAxF3xxkRBI5DUHDDJRMAQ0dbEIFG8BmB/lJv/jFkdP1tZVhGNi2jeM4eJ5HGIYEQYBlWZimiZKhkCQJeZ7Tti1VVemeoGQzjmPKsqTrOvq+pygKoijSrkps67rWiCjLMu0m8U8gtj+kFoH8oXzf13ebptFRhmma6n9c10VN08TzPFzXxXmemvu+ed+XeZ5RwzCw7zvbtrEsC+u66vw4DsZx5APFom9SA4et5wAAAABJRU5ErkJggg==" />
  </Step>

  <Step title="Approve access on LottieFiles">
    On the LottieFiles approval page, check that the application is **ChatGPT** and that you recognize the address shown under **After approval you will be sent to**. If the address is unfamiliar, don't approve. Select **Approve**, then sign in to LottieFiles if asked.

    <Image src="https://assets.docs.lottiefiles.com/static/d2f1a60919-640.webp" alt="LottieFiles page asking you to approve MCP access for ChatGPT" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/d2f1a60919-640.webp 640w, https://assets.docs.lottiefiles.com/static/d2f1a60919-1024.webp 1024w" width="1080" height="946" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAHCAYAAAA1WQxeAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAqUlEQVR4nDWNwYrCMBRF8/9f4GpAcDHL+RVRHCqC1WWT9KVp2sQm8Ug7zOJwudwDV80xIs7hhmHDitCLEKZALhW1jve2RRtD12m0XrNDxP0JYZ6RwZNLIedCqXXjv6uYElYcvRs2UbzHiODDxLIKS/SMpmU0D4J98o4WygR1otYFlV4J53qkt4zB89NeOdx++bqeacSitr9cSCmR65vvW8O+ubC7HDkZzQeuONQz5KFZ4AAAAABJRU5ErkJggg==" />
  </Step>

  <Step title="Use it in a chat">
    Start a new chat, type `@Creator`, select **Creator MCP** from the list, and ask for an animation.

    <Image src="https://assets.docs.lottiefiles.com/static/bc8753e91e-640.webp" alt="ChatGPT message box with Creator MCP selected before a prompt for a bouncing ball animation" zoom variant="default" srcSet="https://assets.docs.lottiefiles.com/static/bc8753e91e-640.webp 640w, https://assets.docs.lottiefiles.com/static/bc8753e91e-1024.webp 1024w" width="1720" height="400" loading="lazy" data-blur="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAACCAYAAABllJ3tAAAACXBIWXMAAAAAAAAAAAHqZRakAAAAOElEQVR4nB3IwQkAMAgEwVThR0Rz6tP+y7sQHwPLHmSzqtjdCwDdnZlJEeEB7o5PVWlmjAjOzPYDyC0WGHKwNKkAAAAASUVORK5CYII=" />
  </Step>
</Steps>

Plugin names must be unique. If you add the server again, delete the old plugin first in **Settings → Plugins**, or choose another name. See [OpenAI's plugin guide](https://help.openai.com/articles/20001256).

<Callout type="info" title="Approve within five minutes">
  The LottieFiles approval page expires after five minutes and then shows `consent expired`. Start the connection again
  from the connector or plugin and approve right away.
</Callout>

## Developer tools

Use these steps for coding agents, editors, and terminal clients. The server uses **Streamable HTTP with OAuth**.

<Tabs
  className="flex-wrap"
  persist="creator-mcp-client"
  defaultValue="claude-code"
  items={[
  { label: 'Claude Code', value: 'claude-code' },
  { label: 'Codex', value: 'codex' },
  { label: 'Cursor', value: 'cursor' },
  { label: 'VS Code', value: 'vscode' },
  { label: 'Devin Desktop (Windsurf)', value: 'windsurf' },
  { label: 'Other clients', value: 'other' },
]}
>
  <TabsContent value="claude-code">
    Run in your terminal:

    ```bash
    claude mcp add --transport http --scope user creator-mcp https://creator.mcp.lottiefiles.com/mcp
    ```

    `--scope user` makes the server available in every project. Omit it to add the server to the current directory only.

    Inside a Claude Code session, run `/mcp`, select **creator-mcp**, and complete sign-in in your browser.

    [Claude Code MCP documentation](https://code.claude.com/docs/en/mcp)
  </TabsContent>

  <TabsContent value="codex">
    Run in your terminal:

    ```bash
    codex mcp add creator-mcp --url https://creator.mcp.lottiefiles.com/mcp
    ```

    Complete the sign-in prompt. To start sign-in separately, run:

    ```bash
    codex mcp login creator-mcp
    ```

    You can also configure the server in `~/.codex/config.toml`:

    ```toml
    [mcp_servers.creator-mcp]
    url = "https://creator.mcp.lottiefiles.com/mcp"
    ```

    [Codex MCP documentation](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)
  </TabsContent>

  <TabsContent value="cursor">
    Add this entry to `~/.cursor/mcp.json` for all projects, or `.cursor/mcp.json` for the current project:

    ```json
    {
      "mcpServers": {
        "creator-mcp": {
          "url": "https://creator.mcp.lottiefiles.com/mcp"
        }
      }
    }
    ```

    Open Cursor's MCP settings, enable the server, and complete the OAuth sign-in when prompted. Make sure the tools are available to Agent.

    [Cursor MCP documentation](https://cursor.com/docs/mcp)
  </TabsContent>

  <TabsContent value="vscode">
    Add the server to `.vscode/mcp.json` in your workspace:

    ```json
    {
      "servers": {
        "creator-mcp": {
          "type": "http",
          "url": "https://creator.mcp.lottiefiles.com/mcp"
        }
      }
    }
    ```

    You can also run **MCP: Add Server** for a guided setup, or add the server to your user configuration to use it in every workspace.

    Use **MCP: List Servers** in the Command Palette to start the server and complete sign-in. Open Chat in Agent mode and enable the server's tools in the tools picker.

    [VS Code MCP documentation](https://code.visualstudio.com/docs/agent-customization/mcp-servers)
  </TabsContent>

  <TabsContent value="windsurf">
    Windsurf is now Devin Desktop. Its default Devin Local agent and the Devin CLI share one user configuration. Run:

    ```bash
    devin mcp add -s user creator-mcp https://creator.mcp.lottiefiles.com/mcp
    devin mcp login creator-mcp
    ```

    Or add the server to `~/.config/devin/mcp_config.json` (`%APPDATA%\devin\mcp_config.json` on Windows), then run the login command:

    ```json
    {
      "mcpServers": {
        "creator-mcp": {
          "url": "https://creator.mcp.lottiefiles.com/mcp"
        }
      }
    }
    ```

    The legacy Cascade agent reads the same file.

    [Devin MCP documentation](https://docs.devin.ai/cli/extensibility/mcp/configuration)
  </TabsContent>

  <TabsContent value="other">
    For a client with remote MCP and OAuth support, add the server URL through its MCP settings. Select **HTTP** or **Streamable HTTP** if it asks for a transport.

    If your client only supports local stdio servers, use the [`mcp-remote` bridge](https://www.npmjs.com/package/mcp-remote) with a supported Node.js installation:

    ```json
    {
      "mcpServers": {
        "creator-mcp": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://creator.mcp.lottiefiles.com/mcp"]
        }
      }
    }
    ```

    This runs a connection bridge locally. Creator MCP still runs on the hosted server.
  </TabsContent>
</Tabs>

Merge entries into an existing configuration rather than replacing other servers.

## Check the connection

Ask your agent:

> List the tools available from Creator MCP, then read its animation overview.

The server always exposes `creator_exec`, `creator_docs`, and `creator_document`. `creator_download_file` and `creator_delete_file` appear when file storage is available, and `creator_import_media` when the server also has an upload route. `creator_account` appears with a workspace connection; `creator_save_to_workspace`, `creator_open_in_creator`, and `creator_load_from_workspace` also need file storage. In clients that support MCP Apps, `creator_preview` adds the [preview card](/en/developers/creator-mcp/preview), for up to 11 tools. See [MCP tools](/en/developers/creator-mcp/reference#mcp-tools). Use these tool names exactly as shown.

Then [make your first animation](/en/developers/creator-mcp/quickstart). If tools or sign-in are missing, see [connection troubleshooting](/en/developers/creator-mcp/troubleshooting#connection-and-sign-in).