> This page is for version v1.3 (default). > For other versions, use one of these documentation indexes: > - v1.3 (default): https://docs.twelvelabs.io/v1.3/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.twelvelabs.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.twelvelabs.io/_mcp/server. # Start with the Jockey MCP > Connect the Jockey MCP to Claude or ChatGPT, add your videos, and ask questions about them in plain English. No code. Four steps. Use Jockey to talk to your videos. The Jockey MCP connects Jockey to Claude or ChatGPT. Once it is connected, add your videos and ask for what you need, like "find every moment where someone enters a room." Jockey answers with the matching clips and timestamps. 4 steps, no code 1. 1ConnectAdd it to your assistant 2. 2CheckConfirm it works 3. 3Add videosUpload or paste a link 4. 4AskSearch in plain English Everything happens in Claude or ChatGPT and your browser. # Where Jockey works * **No code:** this page covers it. * **In your own app:** use the Agents API to create knowledge stores and ask Jockey questions from code. See the [Agents quickstart](/v1.3/agents/get-started/quickstart). # Before you start * Claude or ChatGPT. You can use the desktop app or the web version. * A free TwelveLabs account. You can create one when you connect Jockey in step 1. * Videos to search. You can upload files, or paste a public link such as a YouTube URL. # What you will have at the end A conversation in Claude or ChatGPT where you can search your own videos, ask for summaries, and jump to the exact moments you described. #### Connect Jockey to Claude or ChatGPT Choose the assistant you use. #### Claude In Claude, open the **Customize** menu item in the left sidebar. ![The Claude sidebar with Customize highlighted](/_fern-img/6c8cafed12c297a3cf3a9fb4496247aeb8bcd85bccc6aba85579497aba6a0000.webp) Open the **Connectors** tab, search for **Jockey**, and select the **+** button on **Jockey by TwelveLabs**. ![Searching for Jockey in Claude connectors](/_fern-img/eed2cf691c8f109977b481af441f89c73af22cd241cf3f5885286d3102713dca.webp) When prompted, log in to your TwelveLabs account, or select **Sign up** to create a free one. ![The TwelveLabs log in screen](/_fern-files/twelvelabs.docs.buildwithfern.com/bc7acef432faa990a4bf3137e97da5ec56b0e142dad1f371dccb9a1f33ed0750/docs/assets/1.3/jockey-quickstart/jockey-login.png) A green check mark on the Jockey connector means you are connected. ![The Jockey connector showing a green check mark](/_fern-img/2ce0cc8bfda4715f5287c788e9d6e0a0be39c8baeb95b79b08aa0a11b05e2ebe.webp) #### ChatGPT Open ChatGPT and go to **Plugins** in the left sidebar. ![The ChatGPT sidebar with Plugins highlighted](/_fern-img/9b67533a2dcaeb0a4aafd426f52378e650403f0b616c8c94fdeae0ac36d1359d.webp) Type **Jockey** in the search bar, then select the **+** button next to **Jockey by TwelveLabs**. ![Searching for Jockey on the ChatGPT Plugins page](/_fern-img/f072f1e7e5b598478b2bfe535bb674c2641eed1637e88cae5c5de23c711ff2c5.webp) When prompted, log in to your TwelveLabs account, or sign up for a free one. You are sent back to ChatGPT, and three dots next to Jockey's connection status mean you are connected. #### Check that it works Start a new chat in Claude or ChatGPT and ask: ```text What Jockey tools do you have available? ``` Your assistant describes what Jockey can do. The first time it uses a Jockey tool, it asks for permission. Select the **Allow once** button, or the **Always allow** button if you do not want to be asked again. This is how it looks in Claude: ![Claude asking permission to use a Jockey tool](/_fern-img/4e4971e5a96b1e13c2596cf165b5aee832f81efa42aa70c451647156cda00201.webp) #### Add your videos Ask your assistant to add videos, for example: "I want to add videos to Jockey." It asks where they should go. Jockey keeps your videos in a **knowledge store**, a collection it can search together. Choose an existing one or create a new one. ![Claude asking which knowledge store to use](/_fern-files/twelvelabs.docs.buildwithfern.com/ad80103ef621d4591b58389103fc376d713eedd6dc185799aadf099c25dcd5cb/docs/assets/1.3/jockey-quickstart/claude-choose-knowledge-store.png) Your assistant replies with an upload link. These screenshots show Claude. ![Claude replying with a link to upload videos](/_fern-img/46b67310312599ec81a6d9f612fcb492c4f7eaabaf2cbf1af8c848fa4ddc2f04.webp) Select the link, then confirm if your assistant asks to open it. ![Claude asking to confirm opening the upload link](/_fern-img/7878d47a47d425a3efb7895eeb643075937ad4c207db6a861f626a6a3d9b05de.webp) This upload page is part of [Connect](https://connect.twelvelabs.io), where you add videos and images to your knowledge stores. Choose files from your computer or from Google Drive. Videos can be up to 5 GB and images up to 32 MB. ![The Jockey upload page](/_fern-img/27fc905e2bdd4c76043365b2de1fc5a2c0ead66453d2c1cb0d45de486933be2f.webp) You can also paste a public video link, such as a YouTube URL, into the chat and ask your assistant to add it. Jockey cannot fetch TikTok, Instagram, or Google Drive links directly. Use the upload page for those files. When the upload finishes, go back to your assistant and say you are done. Jockey checks that your videos are ready before you search. #### Ask about your videos Ask in your own words. Jockey replies with matching moments and timestamps. ```text Find every moment where someone enters a room. ``` ```text Summarize each video in two sentences. ``` ```text Find where I talk about pricing. ``` # What to try next Once your videos are in, try a recipe. Recipes are ready-made tasks for common jobs, and several suit creators and small teams. #### [Assemble highlight reels](/v1.3/agents/recipes/assemble-highlight-reels) Find and sequence moments into highlight reels or curated playlists. #### [Agentic search](/v1.3/agents/recipes/agentic-search) Have Jockey interpret your query, reason across your videos and images, and explain each match. #### [Organize a video library](/v1.3/agents/recipes/organize-a-video-library) Find the best way to organize a collection and categorize every video. #### [Generate a corpus overview](/v1.3/agents/recipes/get-a-corpus-overview) Summarize all your videos and images: themes, subjects, and patterns. See all [Jockey recipes](/v1.3/agents/recipes). # Manage your videos in Connect Claude and ChatGPT only show the chat. They do not show what Jockey has stored for you. [Connect](https://connect.twelvelabs.io) does: you use it to check your videos, organize them, and see your usage and billing. To use it: #### Sign in Go to [connect.twelvelabs.io](https://connect.twelvelabs.io) and sign in with the same TwelveLabs account you used to connect Jockey. #### Open a knowledge store Open a knowledge store to see the videos and images in it, and which ones are ready. #### Add or group items Upload more files, including from Google Drive, or group related items into a collection. A collection is a named subset of a knowledge store, so you can work with related items together. #### Check your plan and usage Open the account menu to check your plan, your storage use, and your Jockey runs per cycle, and to reach the usage dashboard, billing, pricing, support, and settings. ![The Connect account menu showing plan, storage use, Jockey runs, usage dashboard, billing, pricing, support, and settings](/_fern-img/d26f7543bfd2284aca50a7086f89b4e20f83b070e9dfc27fbce53e8ffed8cfcf.webp) Developers can also create and manage collections through the API. See [Create an item collection](/v1.3/api-reference/knowledge-store-items/item-collections/create). # If something looks off * **Jockey does not see my new videos.** Longer videos take longer to become ready. Ask your assistant whether your videos are ready. * **The connector does not appear.** Update the app, then search for **Jockey by TwelveLabs** in Claude under **Customize**, **Connectors**, or in ChatGPT under **Plugins**. * **Authorization is stuck.** Sign out of your TwelveLabs account in your browser and try again. * **Your assistant cannot add a link.** Jockey cannot fetch TikTok, Instagram, or Google Drive links directly. Use the upload page for those files. # Next steps #### [Open Connect](https://connect.twelvelabs.io) See your knowledge stores, uploads, usage, and billing. #### [How Jockey works](/v1.3/agents/concepts/jockey) Learn how Jockey reasons across your videos and images. #### [Building an app? Use the API](/v1.3/agents/get-started/quickstart) Use Jockey from your own code, in four steps.