# Use X02 in Claude, ChatGPT, Gemini and other AI chat apps X02 runs a remote [Model Context Protocol](https://modelcontextprotocol.io) server at `https://up.x02.me/mcp` (Streamable HTTP, OAuth 2.1). Add it as a connector in Claude, ChatGPT, Gemini, Grok, Le Chat or any other MCP app, sign in to X02 in the browser window that opens, and the assistant can upload, find, view, rename, move, delete, organize and share the account's files. No API key is ever pasted into the AI app. **Server address:** `https://up.x02.me/mcp` It is not a secret — it is the address the AI app connects to. The app discovers the sign-in endpoints itself, opens x02.me so the user can sign in, and stores its own token. The connector is free on every X02 account; some AI apps put custom connectors behind their own paid plans. ## What you can ask - "Find the screenshot I uploaded last Tuesday and tell me what's in it." - "Upload https://example.com/logo.png to my X02 and give me the link." - "Put this week's uploads in a folder called Client Work and share it." - "How much of today's upload quota do I have left?" - "Rename my last five uploads to something readable." - "I've got a photo on my laptop I want up there." ## Connect it You need an X02 account first. ### Claude 1. In a chat, open the + menu and choose Browse connectors. 2. Search for X02 and click Add. 3. Sign in to X02 in the window that opens, review the permissions, and click Allow Access. Open: https://claude.ai/customize/connectors X02 is listed in Anthropic's connector directory. To add it by hand instead, open Customize → Connectors → + → Add custom connector and paste the server address. It then follows you across claude.ai, the desktop app and mobile. ### ChatGPT 1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode. 2. Add a connector and paste the server address. 3. Sign in to X02 when the browser opens. Open: https://chatgpt.com/ Needs a paid plan (Plus, Pro, Business, Enterprise or Edu) and works on the web only. Without developer mode ChatGPT exposes only search and fetch tools, and X02 has neither. ### Gemini 1. On gemini.google.com, open Settings → Connected Apps. 2. Under Custom apps, click Add a custom app and paste the server address. 3. Click Next and sign in to X02 when asked. Open: https://gemini.google.com/ Google currently limits custom apps to personal Google accounts, in the US, aged 18 or over, with Keep Activity turned on. Add it on the web; it then works in the Gemini mobile app too. ### Grok 1. Go to grok.com/connectors and click New Connector → Custom. 2. Paste the server address. 3. Sign in to X02 when asked. Open: https://grok.com/connectors xAI documents custom connectors for Business and Enterprise plans. ### Le Chat 1. Open Connectors from the sidebar and click + Add Connector. 2. Switch to the Custom MCP Connector tab, name it x02 and paste the server address. 3. Click Connect and sign in to X02 when asked. Open: https://chat.mistral.ai/ Available on every Mistral plan, including Free. On a team plan, only an admin can add connectors. ### Another app 1. Look in the app's settings for Connectors, Integrations, Apps or MCP. 2. Choose the option to add your own (Custom, Add custom connector, Add server) and paste the server address. 3. Sign in to X02 when your browser opens, check the permissions, and approve. The app has to support remote connectors with sign-in. If it only asks for a command to run, or only takes an API key, X02 cannot be added there. To check it worked, ask "what x02 tools do you have?" — there should be fifteen. Full walkthrough: [Set up X02 in Claude, ChatGPT, Grok and more](https://x02.me/blog/set-up-x02-mcp-in-your-ai-client). ### Developer tools Claude Code, Cursor, VS Code and Windsurf connect with the same address; choose HTTP or Streamable HTTP as the transport, not stdio. In Claude Code: ```bash claude mcp add --transport http x02 https://up.x02.me/mcp ``` Details: [developer setup](https://x02.me/blog/set-up-x02-mcp-in-your-ai-client#claude-code). ## Tools - `get_account` — Plan, limits, and how much of today's upload quota is left. - `list_files` — Page through uploads, narrowing by search, folder, file kind and upload date. - `get_file` — Metadata for one file: URL, size, type, folder, views, expiry. - `view_file` — Show the assistant the actual image, so it can identify a file rather than guess from its name. - `request_file_from_user` — Get a link the user drops a file into — the working route for anything attached to a chat. - `check_file_handoff` — Collect what they dropped. Waits for the upload, so nobody has to say “done”. - `upload_file` — Upload small file content directly. Bytes are base64-encoded into the call, so in practice this suits icons and snippets, not screenshots — use upload_from_url instead. - `upload_from_url` — Rehost a remote image by URL. No size cap beyond your plan limit. - `rename_files` — Rename one or more stored files. Each hosted URL changes with it. - `move_files` — Move one or many files into a folder, or back to the root library. - `delete_files` — Permanently delete one or more files. Not reversible. - `list_folders` — List folders, including file counts and share state. - `create_folder` — Create a folder. - `delete_folder` — Delete a folder. Not reversible. - `share_folder` — Turn a folder into a shared album and return the link. ## Permissions Requested when you connect, shown on the consent screen, and checked on every call: - `account:read` — Read your username, plan, limits, and usage. - `files:read` — List and inspect your files. - `files:write` — Upload, rename, and move files. - `files:delete` — Delete files. - `folders:read` — List your folders. - `folders:write` — Create, delete, and share folders. Disconnecting an app in its own connector settings revokes that app only; the account's API key, folder keys and other connected apps are unaffected. ## Questions ### What is the X02 MCP server? A connector that lets an AI chat app work on your X02 files. Add https://up.x02.me/mcp to Claude, ChatGPT, Gemini, Grok, Le Chat or another app that supports connectors, and the assistant can upload, search, view, rename, move, delete, organize into folders and share albums for you. MCP (Model Context Protocol) is the open standard these apps use to connect to outside services. ### Do I have to paste my API key into the AI app? No. Connecting opens x02.me in your browser, you sign in and approve the permissions the app asked for, and the app receives its own token. Your API key never leaves X02. ### Is it free? Yes. The connector works on free X02 accounts, with your plan's normal upload limits. Some AI apps put custom connectors behind their own paid plans — ChatGPT, for example. ### Can the assistant upload a file I attached to the chat? Not directly — AI apps have no way to pass an attachment on to a connector. The assistant hands you a drop link instead, and you paste or drag the file into it. Files already online can be rehosted by URL with no extra step. ### How do I disconnect an app? Remove the connector in the app's own settings. That app's access ends; your API key, folder keys and any other connected apps are unaffected. ### Which permissions does it ask for? Six, shown on the consent screen before you approve: read your account, read files, upload and edit files, delete files, read folders, and manage folders. Anything outside what you approved is refused. ### Does it work in code editors too? Yes — Claude Code, Cursor, VS Code and Windsurf all connect with the same address. Part 2 of the setup guide has the details. ## Guides - [Set up X02 in Claude, ChatGPT, Grok and more](https://x02.me/blog/set-up-x02-mcp-in-your-ai-client): Step-by-step for every app, with the plan requirements that trip people up. - [Ten things to ask an assistant connected to X02](https://x02.me/blog/x02-mcp-workflows-and-recipes): Worked examples, from finding a file by its old name to publishing an album. - [How to send files to X02 from an AI chat](https://x02.me/blog/how-to-send-files-to-x02-from-an-ai-chat): Drop links, the standing tray, and rehosting from a URL. - [What you are actually approving](https://x02.me/blog/x02-mcp-permissions-and-scopes-explained): Which permission governs what, and what disconnecting really does. - [Troubleshooting X02 connections](https://x02.me/blog/troubleshooting-x02-mcp-connections): Every way a connection fails, what the error means, and the fix. - [Developer reference](https://x02.me/api-docs#mcp): MCP and REST API docs. Machine-readable: [MCP server card](https://x02.me/.well-known/mcp.json), [OAuth protected-resource metadata](https://up.x02.me/.well-known/oauth-protected-resource/mcp).