Connect wrrk.ai to any AI app

Connect wrrk.ai to any AI app

Use your wrrk.ai workspace from the AI app or coding tool you already use: Claude, ChatGPT, Gemini, Mistral, Perplexity, the Claude and ChatGPT desktop apps, Raycast, Claude Code, Codex, Cursor, VS Code, Windsurf, Zed, Cline, Gemini CLI, or any other app that can add a remote server. The full guide, with a picture of each screen, is at https://wrrk.ai/connect.

What every app needs

Every app asks for the same few things. If a screen looks different from the steps below, fill it in like this:

Then the app opens wrrk.ai in your browser: sign in to your own wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

Claude has an Add to Claude button, Cursor an Add to Cursor button and VS Code an Add to VS Code button that open the app with wrrk.ai already filled in. They only fill the form: you still check it, confirm, sign in and approve.

Chat apps

Claude

Works in Claude on the web, the desktop app and the mobile app. Who can use it: Every Claude plan. The Free plan allows one custom connector.

Claude Free, Pro or Max

You can do this yourself. On Free you can add one custom connector.

One click: Add to Claude

1. Click Add to Claude. Claude opens with wrrk.ai and its link already filled in (sign in to Claude first if it asks).
2. Check the name is wrrk.ai and the URL matches https://wrrk.ai/api/mcp/connect, then click Add.
3. Click Connect next to wrrk.ai and sign in to your wrrk.ai account.
4. Tick the box to confirm the data-sharing notice, then click Approve.

Field by field for step 2 (Add custom connector):

Or add it by hand:

1. In Claude, open Customize, then Connectors.
2. Click +, then Add custom connector.
3. Name it wrrk.ai, paste https://wrrk.ai/api/mcp/connect and click Add. Then carry on from Connect above.

Their own guide: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

Claude Team or Enterprise

An Owner adds wrrk.ai once for everyone. Then each person connects.

One click: I'm the Owner — add for my organization

1. An Owner clicks I'm the Owner — add for my organization. Claude opens Organization settings with wrrk.ai and its link already filled in.
2. The Owner checks the name is wrrk.ai and the URL matches https://wrrk.ai/api/mcp/connect, then clicks Add.
3. Each member then opens Customize, then Connectors, and clicks Connect next to wrrk.ai.
4. Sign in to your own wrrk.ai account, tick the box and click Approve.

Field by field for step 2 (Add custom connector):

Or add it by hand:

1. An Owner opens Organization settings, then Connectors.
2. They click Add, then Custom, then Web, name it wrrk.ai, paste https://wrrk.ai/api/mcp/connect and click Add. Members then connect as above.

Their own guide: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

ChatGPT

Works in ChatGPT on the web, through developer mode. Who can use it: Paid ChatGPT plans, on the web. Not on the Free plan. On Business, Enterprise and Edu a workspace admin has to set it up. Some plans can only read, not make changes.

ChatGPT Plus or Pro

You can do this yourself on chatgpt.com. Some plans can look things up but not make changes.

1. Turn on developer mode: open Settings, then Security and login, and turn on Developer mode. (On older menus: Settings, Apps & Connectors, Advanced settings.)
2. Open Plugins (chatgpt.com/plugins), click +, then Add custom MCP server (some accounts show Create MCP App).
3. Name it wrrk.ai and, under Connection, paste https://wrrk.ai/api/mcp/connect. Set Authentication to OAuth, tick I understand and want to continue, and click Create (it may say Create as a plugin).
4. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.
5. In a new chat, type @wrrk.ai or pick it from the + menu, then ask your question.

Field by field for step 3 (New plugin):

Their own guide: https://developers.openai.com/apps-sdk/deploy/connect-chatgpt

ChatGPT Business, Enterprise or Edu

Only a workspace admin or owner can add it. There is a ready-made note to send them.

1. An admin allows custom apps in Workspace settings, under Permissions & roles, then Connected data.
2. The admin turns on Developer mode for themselves and adds wrrk.ai with the same steps as Plus and Pro, pasting https://wrrk.ai/api/mcp/connect.
3. The admin publishes it to the workspace.
4. Each member connects wrrk.ai and signs in with their own wrrk.ai account, then ticks the box and clicks Approve.

Their own guide: https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt

Gemini

Works in the Gemini app for some personal Google accounts, and in Gemini Enterprise with help from us. Who can use it: Personal Google accounts in the US, 18 or older, in English, with Keep Activity on. Not for work or school accounts. Gemini Enterprise can add it through a Google Cloud admin, with sign-in details from us.

Gemini app (personal Google account)

US only, in English. Google may not show the option on every plan yet. Add it on the web; it then works on your phone too.

1. On gemini.google.com, open Settings, then Connected Apps.
2. Under Custom apps, click Add a custom app, paste https://wrrk.ai/api/mcp/connect as the server URL and click Next.
3. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.
4. In a chat, type @ and pick wrrk.ai, then ask your question.

Field by field for step 2 (Add a custom app):

Their own guide: https://support.google.com/gemini/answer/17209137

Gemini Enterprise

Needs your Google Cloud admin and a short setup step from us.

1. Email support@wrrk.ai and tell us your company uses Gemini Enterprise. We send your admin the sign-in details Gemini asks for.
2. Your admin opens Gemini Enterprise in the Google Cloud console, then Data stores, Create data store, Custom MCP Server, Add MCP server.
3. They paste https://wrrk.ai/api/mcp/connect as the server URL, choose OAuth, enter the details we sent, click Verify Auth, then turn on the wrrk.ai actions.
4. Each person signs in to their own wrrk.ai account the first time Gemini uses it.

Field by field for step 3 (Custom MCP Server: Authentication settings):

Their own guide: https://docs.cloud.google.com/gemini/enterprise/docs/connectors/custom-mcp-server/set-up-custom-mcp-server

Le Chat (Mistral)

Works in Mistral's chat app, now called Mistral Vibe, on the web. Who can use it: Any Mistral Vibe plan where you can manage connectors. Only an admin can add one; on Free, Pro and Student plans the account owner is the admin.

Mistral Vibe (formerly Le Chat)

You can do this yourself on chat.mistral.ai if you own the account. On a team plan, ask your admin.

1. On chat.mistral.ai, open Connectors and click + Add Connector.
2. Open the Custom MCP Connector tab, name it wrrk (Mistral doesn't allow dots or spaces in the name), paste https://wrrk.ai/api/mcp/connect as the Server URL and click Connect.
3. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

Field by field for step 2 (Custom MCP Connector):

Their own guide: https://docs.mistral.ai/le-chat/knowledge-integrations/connectors/mcp-connectors

Perplexity

Works in Perplexity on the web. Who can use it: Perplexity Pro, Max and Enterprise. On Enterprise, an admin has to turn on "Allow members to add custom connectors" first.

Perplexity Pro, Max or Enterprise

Add it on perplexity.ai in a web browser.

1. Open Plugins in the sidebar (or Customize, then Connectors), then Add custom, Connector, Add MCP connector.
2. Choose Remote, name it wrrk.ai, paste https://wrrk.ai/api/mcp/connect as the MCP Server URL, set Authentication to OAuth 2.0 and click Add.
3. Click the wrrk.ai connector card to sign in.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

Field by field for step 2 (Add MCP connector):

Their own guide: https://www.perplexity.ai/help-center/en/articles/13915507-adding-custom-remote-connectors

Desktop apps

Claude Desktop

The same connector as Claude on the web: add it once and it shows up on web, desktop and mobile. Who can use it: Every Claude plan. The Free plan allows one custom connector.

Claude for Mac or Windows

Connectors you add on claude.ai appear in the desktop app by themselves, and the other way round.

One click: Add to Claude

1. Click Add to Claude, or in the desktop app open Customize, then Connectors, click + and Add custom connector.
2. Check the name is wrrk.ai and the URL matches https://wrrk.ai/api/mcp/connect, then click Add.
3. Click Connect next to wrrk.ai.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.
5. You don't need to edit claude_desktop_config.json. That file is only for tools that run on your computer.

Field by field for step 2 (Add custom connector):

Their own guide: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

ChatGPT desktop

The ChatGPT app for Mac and Windows has its own server list, shared with Codex. ChatGPT on the web uses Plugins instead. Who can use it: The ChatGPT desktop app for macOS or Windows.

ChatGPT desktop app

Servers you add here also work in the Codex CLI and IDE extension: they share one settings file.

1. In the ChatGPT desktop app, open Settings, then MCP servers, and click Add server.
2. On Connect to a custom MCP, name it wrrk, choose Streamable HTTP and paste https://wrrk.ai/api/mcp/connect into URL. Leave Command to launch, Arguments, Environment variables and Working directory empty (they are only for STDIO), and leave the token and headers empty too: there is nothing to paste. Click Save.
3. Click Restart if the app asks. Then click Authenticate next to wrrk.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

Field by field for step 2 (Connect to a custom MCP):

Their own guide: https://learn.chatgpt.com/docs/extend/mcp?surface=app

Raycast

Use wrrk.ai from Raycast AI on your Mac. Who can use it: Raycast Pro.

Raycast Pro

1. Open Raycast and run the Install MCP Server command.
2. Name it wrrk, set Transport to HTTP, paste https://wrrk.ai/api/mcp/connect as the URL, set OAuth Type to Dynamic, and install it.
3. Open Manage MCP Servers, select wrrk and use the Sign In action.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

Field by field for step 2 (Install MCP Server):

Their own guide: https://manual.raycast.com/ai/model-context-protocol

Coding tools

Claude Code

One command in your terminal. Who can use it: Any Claude Code install.

Claude Code

1. Run this in your terminal.
2. Start Claude Code, type /mcp, choose wrrk and pick Authenticate.
3. Your browser opens: sign in to wrrk.ai, tick the box and click Approve.

For step 1:

claude mcp add --transport http wrrk https://wrrk.ai/api/mcp/connect

Their own guide: https://code.claude.com/docs/en/mcp

Codex

OpenAI's coding agent: the CLI, the IDE extension and the ChatGPT desktop app share one list of servers. Who can use it: Any Codex install that can sign in to ChatGPT or an OpenAI API key.

Codex CLI

1. Add wrrk.ai, then sign in. Run these in your terminal:
2. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.
3. Start Codex and type /mcp to check wrrk is listed.

For step 1:

codex mcp add wrrk --url https://wrrk.ai/api/mcp/connect
codex mcp login wrrk

Or add it by hand:

1. Or add this to ~/.codex/config.toml yourself, then run codex mcp login wrrk:

For step 1 (~/.codex/config.toml):

[mcp_servers.wrrk]
url = "https://wrrk.ai/api/mcp/connect"

Their own guide: https://learn.chatgpt.com/docs/extend/mcp?surface=cli

Codex IDE extension (VS Code, Cursor, Windsurf)

Uses the same ~/.codex/config.toml, so if you added wrrk.ai in the CLI or the desktop app it is already here.

1. In the Codex panel, open the gear menu, then MCP servers, and click Add server.
2. On Connect to a custom MCP, name it wrrk, choose Streamable HTTP and paste https://wrrk.ai/api/mcp/connect into URL. Leave Command to launch, Arguments, Environment variables and Working directory empty (they are only for STDIO), and leave the token and headers empty too: there is nothing to paste. Click Save.
3. Click Restart extension. When wrrk asks you to sign in, click Authenticate (or run codex mcp login wrrk in a terminal).
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

Field by field for step 2 (Connect to a custom MCP):

Their own guide: https://learn.chatgpt.com/docs/extend/mcp?surface=ide

Cursor

One click opens Cursor with wrrk.ai filled in. Who can use it: Any Cursor plan.

Cursor

Needs Cursor installed on this computer for the button to work.

One click: Add to Cursor

1. Click Add to Cursor. Cursor opens and offers to install wrrk with the link already filled in.
2. Check the URL matches the link above, then click Install.
3. When Cursor says wrrk needs you to sign in, follow its prompt.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.
5. In Cursor chat, use Agent mode and ask about your workspace.

Or add it by hand:

1. Or add this to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project) and save:

For step 1 (~/.cursor/mcp.json):

{
  "mcpServers": {
    "wrrk": {
      "url": "https://wrrk.ai/api/mcp/connect"
    }
  }
}

Their own guide: https://cursor.com/docs/context/mcp

VS Code

Works in GitHub Copilot agent mode. One click opens VS Code with wrrk.ai filled in. Who can use it: VS Code with GitHub Copilot. Business and Enterprise organizations can turn this off for their members.

VS Code with GitHub Copilot

Needs VS Code installed on this computer for the button to work.

One click: Add to VS Code

1. Click Add to VS Code. VS Code opens with wrrk and its link already filled in.
2. Click Install.
3. When VS Code asks whether wrrk may sign in, click Allow.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.
5. Open Copilot Chat, switch to Agent mode, and ask about your workspace.

Or add it by hand:

1. Open the Command Palette and run MCP: Add Server, choose HTTP, paste the link, and name it wrrk.
2. Or add this to .vscode/mcp.json in your project:

For step 2 (.vscode/mcp.json):

{
  "servers": {
    "wrrk": {
      "type": "http",
      "url": "https://wrrk.ai/api/mcp/connect"
    }
  }
}

Their own guide: https://code.visualstudio.com/docs/copilot/customization/mcp-servers

Windsurf

Works in Cascade. Newer builds are called Devin Desktop; the steps are the same. Who can use it: Any Windsurf or Devin Desktop plan. Team admins can limit which servers members may add.

Windsurf (Devin Desktop)

1. In the Cascade panel, open the … menu, go to MCPs and click Open MCP config file.
2. Add wrrk to the file and save it:
3. Back in MCPs, refresh the list if wrrk isn't there yet. Sign in when your browser opens.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

For step 2 (mcp_config.json):

{
  "mcpServers": {
    "wrrk": {
      "serverUrl": "https://wrrk.ai/api/mcp/connect"
    }
  }
}

Their own guide: https://docs.devin.ai/desktop/cascade/mcp

Zed

Works in Zed's Agent Panel. Who can use it: Any Zed install.

Zed

1. Open the Agent Panel settings (agent: open settings), go to MCP Servers, click Add Server, then Add Remote Server.
2. Make the entry match this (it goes under context_servers in your settings.json), and save:
3. When Zed asks you to sign in to wrrk, accept.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

For step 2 (settings.json):

{
  "context_servers": {
    "wrrk": {
      "url": "https://wrrk.ai/api/mcp/connect"
    }
  }
}

Their own guide: https://zed.dev/docs/ai/mcp

Cline

Works in the Cline extension for VS Code and other editors. Who can use it: Any Cline install.

Cline

1. In the Cline panel, click the MCP Servers icon and open the Remote Servers tab.
2. Name it wrrk, paste https://wrrk.ai/api/mcp/connect as the Server URL, choose Streamable HTTP and click Add Server.
3. Click Authenticate next to wrrk.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

Field by field for step 2 (Remote Servers):

Or add it by hand:

1. Or click Configure MCP Servers and add this to cline_mcp_settings.json:

For step 1 (cline_mcp_settings.json):

{
  "mcpServers": {
    "wrrk": {
      "type": "streamableHttp",
      "url": "https://wrrk.ai/api/mcp/connect",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Their own guide: https://docs.cline.bot/mcp/connecting-to-a-remote-server

Gemini CLI

One command in your terminal. Who can use it: Any Gemini CLI install.

Gemini CLI

1. Run this in your terminal (--scope user makes it work in every folder).
2. Start Gemini CLI and run /mcp auth wrrk.
3. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

For step 1:

gemini mcp add --transport http --scope user wrrk https://wrrk.ai/api/mcp/connect

Or add it by hand:

1. Or add this to ~/.gemini/settings.json. Use httpUrl, not url:

For step 1 (~/.gemini/settings.json):

{
  "mcpServers": {
    "wrrk": {
      "httpUrl": "https://wrrk.ai/api/mcp/connect"
    }
  }
}

Their own guide: https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md

Any other app

Most AI apps that can add tools take the same few details. Who can use it: Any app that can add a remote server with sign-in. Apps that only run local commands can use a bridge.

Apps that take a server URL

For any app with a place to add your own server or connector.

1. Open the app's settings for MCP servers, Connectors, Integrations or Tools, and choose to add a custom (or remote) one.
2. Name it wrrk, choose Streamable HTTP (some apps say HTTP or Remote), paste https://wrrk.ai/api/mcp/connect as the URL, and pick OAuth if it asks how to sign in. Leave the token, API key, headers and client ID empty.
3. Save, then sign in when the app asks.
4. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

Field by field for step 2 (Add a server):

Apps that only run local commands (advanced)

Needs Node.js 18 or later. Uses mcp-remote, a widely used open-source bridge that wrrk.ai does not maintain. Use a URL option instead whenever the app has one.

1. Add this to the app's server config file and save:
2. Restart the app. The bridge opens your browser to sign in.
3. Your browser opens wrrk.ai. Sign in to your wrrk.ai account, tick the box to confirm the data-sharing notice, and click Approve.

For step 1:

{
  "mcpServers": {
    "wrrk": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://wrrk.ai/api/mcp/connect"
      ]
    }
  }
}

Their own guide: https://github.com/punkpeye/mcp-remote

Not supported yet

• ChatGPT Free: Adding your own apps needs developer mode, which is only on paid plans.
• ChatGPT phone app: You can only add it on chatgpt.com. Once added, it works on your phone.
• Gemini with a work or school account: Google only allows custom apps on personal accounts. Companies can use Gemini Enterprise instead.
• Perplexity Mac and phone apps: Perplexity only lets you add your own connectors on the web.

Good to know

• Your AI app sees and does only what your wrrk.ai role allows, and asks you before it changes data, sends a message or spends credits
• Look-ups are free; paid actions like lead searches show the credit price first
• The wrrk.ai data the app reads goes to the company that runs it (and, in a coding tool, to the AI model you pick), under your agreement with them. Full details: Privacy Policy, section 6A, and Terms, section 9A
• Every connection shows up in Settings > Connected apps, where you can disconnect it. Access stops straight away

Troubleshooting

• The form wants a command to launch, arguments or a working directory: you're on the STDIO option. Switch to Streamable HTTP (or HTTP) and paste the link
• It asks for a token or API key: leave it empty and choose OAuth. There is no wrrk.ai key to paste
• "Couldn't connect" or a 404: check the link is exactly https://wrrk.ai/api/mcp/connect
• The browser never opens to sign in: look for an Authenticate, Sign in or Connect button next to wrrk in the app's server list, or restart the app
• Approve stays greyed out: tick the box confirming the data-sharing notice first
• A tool is missing: tools follow your wrrk.ai role. Ask your admin if you need more access