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

# Tella MCP Server

> Connect AI assistants like Claude to your Tella workspace with the Tella MCP server. Fix MCP authentication problems: OAuth login loop, mcp-remote stuck reconnecting, callback never completes, stale credentials, can't connect to Tella MCP, reset MCP login.

Tella offers an MCP (Model Context Protocol) server that lets you connect AI assistants like Claude directly to your Tella workspace.

## What can you do with the Tella MCP server?

Once connected, AI assistants can:

* Search videos by title or transcript, and access clips, metadata, captions, thumbnails, and chapters.
* Upload media and create or edit videos, including cuts, layouts, zooms, backgrounds, overlays, sound effects, and Studio Sound.
* Organize videos with tags, playlists, and playlist groups.
* Start exports, manage webhooks, and update sharing or presentation settings.

## Getting started

For full setup instructions, configuration options, and available commands, see our MCP documentation:

[**tella.com/docs/mcp-server**](https://tella.com/docs/mcp-server)

You can also pick up a skill from the [Tella Skills directory](https://www.tella.com/skills) — open-source, ready-made workflows, built and tested for Claude Code, that teach your AI agent how to edit videos on local files and publish your latest Tella recording to YouTube. Our [agent skills guide](/docs/help/integrations/agent-skills) walks through installing each one, with example prompts.

## Troubleshooting authentication

Connecting to the Tella MCP server runs an OAuth sign-in flow in your browser. When that flow gets stuck — the login never finishes, the AI client keeps reconnecting, or it worked before and suddenly stopped — it's almost always one of the two issues below.

### OAuth / callback loop

If clients like Claude Desktop connect through [`mcp-remote`](https://www.npmjs.com/package/mcp-remote), authorizing opens a browser tab that hands a code back to a local callback. The connection hangs in a loop when that callback can't complete.

Try these in order:

<Steps>
  <Step title="Finish the sign-in in your browser">
    When the AI client starts, a browser tab should open asking you to authorize Tella. Complete that sign-in fully and wait for the "you can close this tab" confirmation before switching back. If no tab opened, your client may have suppressed it — check the client's logs for an authorization URL and open it manually.
  </Step>

  <Step title="Make sure the local callback isn't blocked">
    The browser has to redirect back to a local callback URL on your machine. A VPN, proxy, or another process already using the callback port can break the handoff, leaving the client stuck reconnecting. Quit any other AI client that might be running the same MCP connection, then try again.
  </Step>

  <Step title="Fully restart the AI client">
    Quit the client completely (not just close the window) and reopen it so it starts a fresh connection rather than reusing a half-open one.
  </Step>

  <Step title="Authenticate the mcp-remote wrapper once from a terminal">
    If your client uses `mcp-remote` and restarts it before browser sign-in finishes, run `npx mcp-remote https://api.tella.com/mcp` in a terminal, complete the sign-in, wait for the confirmation page, then stop the command with Ctrl+C. The wrapper caches credentials in `~/.mcp-auth` for the next connection. Codex supports Tella's HTTP endpoint directly and does not need this workaround; follow the current command in the [MCP setup documentation](https://tella.com/docs/mcp-server).
  </Step>
</Steps>

### Reset stale credentials

If a client connected through `mcp-remote` used to work and is now stuck — for example after changing your password, switching workspaces, or a token expiring — the wrapper's cached credentials may need to be cleared so the next connection re-runs the full sign-in.

The `mcp-remote` credential cache lives in your home directory at `~/.mcp-auth`. Delete that folder — for example, run `rm -rf ~/.mcp-auth` in a terminal, or remove it in your file manager — to force a clean re-authentication on the next connection. Do this only for connections that use the wrapper; native HTTP clients manage credentials themselves.

<Note>
  `~/.mcp-auth` is in your **home** directory (the `~` matters). It is not `/.mcp-auth` at the filesystem root.
</Note>

After clearing the cache, fully restart your AI client and complete the browser sign-in again.

## What is MCP?

Model Context Protocol is an open standard that allows AI assistants to securely connect to external tools and data sources. It was created by Anthropic and is supported by Claude and other AI applications.