Connect your client

Setup steps for every supported client - Claude, ChatGPT, Gemini, Perplexity, Claude Code, Cursor, VS Code, Codex CLI, Cline, Gemini CLI, Goose, Apple Shortcuts, Linear, and any other MCP client - all doors into the same one server.

Every client below reaches the same remote MCP server over Streamable HTTP, the same account, and the same profile:

https://mcp.usemycontext.ai/mcp

Most clients connect the same way: add a custom or remote MCP server, paste the URL, and sign in with your email and a one-time code over OAuth. A few clients cannot do the browser sign-in yet and use an access token in an Authorization: Bearer header instead; you generate that token on the Connect page inside the app (Advanced, manual setup). Each client below notes which path it takes.

Chat apps

Claude (web and desktop)

One click to add from the Claude Directory. Connect to Claude

The fastest path is the Claude Directory - one click, no URL to paste.

Open the UseMyContext.ai listing in the Claude Directory at claude.ai/directory/connectors/usemycontext - our Community-tier listing - and click Connect.

Approve the OAuth screen that opens in your browser, then sign in with your email and the code we send. That is the whole setup.

In a chat, open the tools menu and make sure UseMyContext is enabled. Full walkthrough: How do I connect Claude to UseMyContext?

Prefer to add it manually? Open Settings, then Connectors, choose “Add custom connector”, enter https://mcp.usemycontext.ai/mcp, and approve the OAuth screen. It reaches the same server and the same account.

ChatGPT

On paid ChatGPT plans, open Settings, then Apps, open Advanced settings, and turn on Developer mode. Back in Apps, click “Create app”, name it UseMyContext, paste https://mcp.usemycontext.ai/mcp as the Connection, and click Create to sign in. Pull it into a chat with @UseMyContext. On older ChatGPT versions this lives under Settings, then Connectors.

Gemini

In the Gemini app, open Settings, then Connectors (sometimes shown as Extensions), choose “Add custom connector”, and paste https://mcp.usemycontext.ai/mcp. Click Connect or Authorize and sign in with your email and code. Gemini’s custom remote MCP support is newer and can be limited; if it cannot sign in over OAuth, use the manual token and an Authorization: Bearer header instead.

Perplexity

Perplexity has disabled custom MCP connectors for now, so UseMyContext cannot be added there yet. If you would like it available, email api@perplexity.ai and ask them to support custom MCP connectors.

Coding tools

Claude Code

The fastest path is the open-source plugin, installed with two commands:

/plugin marketplace add usemycontext/claude-code-plugin
/plugin install usemycontext@usemycontext

Then run /mcp, pick usemycontext, and choose Authenticate to sign in. Prefer the raw server without the plugin? Run claude mcp add --transport http usemycontext https://mcp.usemycontext.ai/mcp (add --scope user to use it in every project). On a headless box, claude mcp login usemycontext does the sign-in from the shell. Details: claude-code-plugin.

Cursor

Add the server to your mcp.json (a remote server needs only url, no type), then connect under Cursor Settings, Tools and MCP Servers, and sign in when Cursor opens the browser:

{
  "mcpServers": {
    "usemycontext": {
      "url": "https://mcp.usemycontext.ai/mcp"
    }
  }
}

The cursor-plugin packages the same server with folder mapping for Cursor’s plugin marketplace.

VS Code

Open the Command Palette (Cmd+Shift+P or Ctrl+Shift+P) and run “MCP: Add Server”. Choose HTTP, paste https://mcp.usemycontext.ai/mcp, name it UseMyContext, and pick Global (or Workspace), then sign in in-editor. Editing .vscode/mcp.json by hand uses a servers block:

{
  "servers": {
    "usemycontext": {
      "type": "http",
      "url": "https://mcp.usemycontext.ai/mcp"
    }
  }
}

Codex CLI

Open ~/.codex/config.toml and add a server block:

[mcp_servers.usemycontext]
url = "https://mcp.usemycontext.ai/mcp"

Sign in over OAuth with codex mcp login usemycontext. No OAuth? Add bearer_token_env_var = "UMC_TOKEN" to the block and export UMC_TOKEN with an access token from the app’s Connect page.

Cline

In Cline, open the MCP Servers icon, then Remote Servers, then Edit Configuration. Add UseMyContext as a streamableHttp server. Cline’s OAuth over Streamable HTTP is still patchy, so it uses an access token in an Authorization: Bearer header:

{
  "type": "streamableHttp",
  "url": "https://mcp.usemycontext.ai/mcp",
  "headers": { "Authorization": "Bearer YOUR_TOKEN" }
}

Gemini CLI

Open ~/.gemini/settings.json and add UseMyContext under mcpServers, using httpUrl for a remote Streamable HTTP server:

{
  "mcpServers": {
    "usemycontext": { "httpUrl": "https://mcp.usemycontext.ai/mcp" }
  }
}

Start gemini and it opens the browser sign-in. If it cannot sign in over OAuth, add "headers": { "Authorization": "Bearer YOUR_TOKEN" } with a token from the app’s Connect page.

Goose

In Goose, open Settings, then Extensions, then “Add custom extension”. Set Type to Streamable HTTP, name it UseMyContext, and set the endpoint to https://mcp.usemycontext.ai/mcp. Goose’s OAuth discovery cannot reach us yet, so add one Request Header: name Authorization, value Bearer YOUR_TOKEN (the word Bearer, a space, then an access token from the app’s Connect page).

Anything else

Any MCP client

In any MCP-capable client, add a remote or custom MCP server (Streamable HTTP) and paste https://mcp.usemycontext.ai/mcp. If the client speaks OAuth over MCP, UseMyContext opens its sign-in (your email and a one-time code). If it does not, send an Authorization: Bearer YOUR_TOKEN header with an access token from the app’s Connect page. Some clients name the fields differently: type may be called transport, and some need only url. Whatever the client, the server address is always https://mcp.usemycontext.ai/mcp - if a listing points anywhere else, it is not us.

Apple Shortcuts

Add to your context, or hear what your AI knows, by voice or text from iPhone, iPad, or Mac, without opening the app. Build a Shortcut with a “Get Contents of URL” action pointed at https://mcp.usemycontext.ai/mcp, method POST, an Authorization: Bearer YOUR_TOKEN header (token from the app’s Connect page), and a JSON body calling one MCP tool. To add a note, call suggest_update (it files a pending suggestion you approve in the app); to read your profile aloud, call profile. Full recipe: the in-app Connect page, Apple Shortcuts.

Linear

Linear’s custom MCP dialog signs in with a header, not the email OAuth flow. Generate an access token on the app’s Connect page (the Linear card), then in Linear open Workspace settings, Security, and enable MCP servers (needs an admin). Add a custom server URL of https://mcp.usemycontext.ai/mcp, then under your own Settings, Agent personalization, MCP servers, pick it and add the Authorization header with your token.