# Connect Your Client
Set up the LottieFiles MCP server in Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed, or any MCP client that supports remote servers.

To connect your MCP client to LottieFiles, register the server URL and sign in — there's nothing to install. The server is remote-only: it speaks Streamable HTTP at a single endpoint and authenticates with OAuth.

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

On first use, your client opens a browser window where you sign in to LottieFiles and approve access. See [Auth, Security, and FAQ](/en/platform/mcp/security) for how the OAuth flow works and how to revoke access later.

## Client Setup

<Tabs
  defaultValue="claude-code"
  items={[
  { label: 'Claude Code', value: 'claude-code' },
  { label: 'Claude', value: 'claude' },
  { label: 'Cursor', value: 'cursor' },
  { label: 'VS Code', value: 'vscode' },
  { label: 'Windsurf', value: 'windsurf' },
  { label: 'Zed', value: 'zed' },
  { label: 'Other clients', value: 'other' },
]}
>
  <TabsContent value="claude-code">
    Run this command in your terminal:

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

    Then, inside a Claude Code session, run `/mcp` and select **lottiefiles** to complete the OAuth sign-in.
  </TabsContent>

  <TabsContent value="claude">
    In the Claude apps (web and desktop), add the server as a custom connector:

    1. Open **Settings → Connectors**.
    2. Select **Add custom connector**.
    3. Enter a name (for example, `LottieFiles`) and the URL `https://mcp.lottiefiles.com/mcp`.
    4. Select **Add**, then **Connect** to sign in with your LottieFiles account.

    On Team and Enterprise plans, an admin can add the connector for the whole organization from **Organization settings → Connectors**.
  </TabsContent>

  <TabsContent value="cursor">
    Add the server to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project):

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

    Or use the one-click install link: [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=lottiefiles\&config=eyJ1cmwiOiJodHRwczovL21jcC5sb3R0aWVmaWxlcy5jb20vbWNwIn0=)

    Cursor prompts you to sign in the first time it uses the server.
  </TabsContent>

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

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

    Open Copilot Chat in agent mode, and VS Code walks you through the sign-in when the server starts.
  </TabsContent>

  <TabsContent value="windsurf">
    Add the server to `~/.codeium/windsurf/mcp_config.json`:

    ```json
    {
      "mcpServers": {
        "lottiefiles": {
          "serverUrl": "https://mcp.lottiefiles.com/mcp"
        }
      }
    }
    ```

    Refresh the plugins list in the Cascade panel to trigger the sign-in.
  </TabsContent>

  <TabsContent value="zed">
    Add the server to your Zed `settings.json`:

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

    Zed launches the server through the `mcp-remote` bridge, which handles the OAuth sign-in in your browser.
  </TabsContent>

  <TabsContent value="other">
    Any client that supports remote MCP servers over Streamable HTTP with OAuth connects with just the URL:

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

    If your client only supports local (stdio) servers, bridge it with [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):

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

## Verify the Connection

After signing in, ask your assistant:

> What LottieFiles MCP tools do you have available?

You should see four tools: `operations_list`, `schema_search`, `schema_details`, and `graphql_execute`. Then try a real request:

> List the projects in my LottieFiles workspace.

If the connection fails, see [Troubleshooting](/en/platform/mcp/security#troubleshooting).

## Requirements

- A [LottieFiles account](https://lottiefiles.com/) — the server acts with your permissions, scoped to what your account can access.
- An MCP client that supports remote servers (Streamable HTTP) with OAuth, or Node.js 18+ if you use the `mcp-remote` bridge.
