# Connect an AI app

Let ChatGPT, Claude, Cursor or another AI app use GoRunner as you.

You choose the app in GoRunner, add GoRunner in the app, then sign in once. You decide which workspace it reaches and what it may do.

## Open the MCP page

*Cloud and Self-hosted only:*

In GoRunner, open **MCP** in the sidebar, under **Keel**. With no app connected yet, the page reads **Connect your first AI app**: choose an app and its steps show in place. Once one is connected, press **Connect an AI app** at the top: the same steps open in a panel.

![The MCP page with no app connected: MCP in the sidebar, then Connect your first AI app with five apps and All 13 apps, Workflow tools and Server.](https://docs.gorunner.io/img/ai-apps/mcp-first-light.jpg)

*Embed only:*

In the product you use, open its **MCP** page and press **Connect an AI app**.

*Cloud and Self-hosted only:*

The panel starts with the server’s address and **Copy**. The page shows it under **Server**.

![The top of the Connect an AI app panel: the MCP server address, with Copy ringed.](https://docs.gorunner.io/img/ai-apps/ai-panel-top-light.jpg)

## Choose your app

Choose the app you use. GoRunner shows its steps and the one key to press. Each app’s page here has the same steps:

### Chat apps

- [ChatGPT](https://docs.gorunner.io/mcp/chatgpt)
- [Claude](https://docs.gorunner.io/mcp/claude)

### Editors

- [Cursor](https://docs.gorunner.io/mcp/cursor)
- [VS Code](https://docs.gorunner.io/mcp/vscode)
- [Devin Desktop](https://docs.gorunner.io/mcp/devin)
- [Zed](https://docs.gorunner.io/mcp/zed)

### Terminals

- [Claude Code](https://docs.gorunner.io/mcp/claude-code)
- [Codex](https://docs.gorunner.io/mcp/codex)
- [Gemini CLI](https://docs.gorunner.io/mcp/gemini-cli)

### More

- [Goose](https://docs.gorunner.io/mcp/goose)
- [LM Studio](https://docs.gorunner.io/mcp/lm-studio)
- [Raycast](https://docs.gorunner.io/mcp/raycast)
- [Another app](https://docs.gorunner.io/mcp/another-app)

## Allow access

When the app asks you to sign in, GoRunner shows **Allow “Claude” to use GoRunner?**, with the app’s name.

![GoRunner’s Allow access page for Claude: the workspace, then what it may do, with Draft and run chosen.](https://docs.gorunner.io/img/ai-apps/ai-consent-claude-light.jpg)

1. Check the address under the app’s name. It is where your sign-in goes: a website such as `claude.ai`, **on this computer**, or **the cursor app on this computer**. If it isn’t the app you are connecting, press **Cancel**.
2. Under **Workspace**, check the workspace. If you are in several, the heading reads **Workspaces**: tick each one it may reach.
3. Under **What it may do**, choose **Read only**, **Draft and run** or **Draft, run and publish**. **Draft and run** is chosen for you.
4. Press **Allow access**.

You should see **Connected**, with the app, the workspace and its number of tools. The app then appears under **Connected apps** on the MCP page.

**Why don’t I see all three choices?**

What’s offered follows your role. An operator sees **Read only** and **Read and run**. A viewer gets read only, with no choice. **Draft, run and publish** appears only where a workspace you ticked allows publishing.

**What if nothing happens after I add it?**

The panel waits up to 15 minutes. After 10 it says: “Still waiting. Nothing has reached GoRunner from Claude in 10 minutes.”

Check that the app has the whole address, and that you finished signing in. Then press **Check again** if the panel offers it.

**What if the sign-in page refuses?**

If the address is another workspace’s, copy it again from your own panel. If your role allows none of what the app asked, tick another workspace or ask an admin. If the request expired, start again from the app.

**Can I paste a token into the chat instead?**

No. An app adds GoRunner in its own settings, not from a conversation. Pasting a token into a chat connects nothing, and shows the token to the model.

**What if the panel says sign-in is off?**

Only a test installation runs without sign-in. Then any app that reaches the address can do anything, publishing included, and ChatGPT and Claude can’t connect. Turn sign-in on before anyone else can reach it. See [`AUTH_ENABLED` in Settings (.env)](https://docs.gorunner.io/self-host/settings#AUTH_ENABLED).

## Related

- [Choose what an AI app may do](https://docs.gorunner.io/mcp/permissions): What each choice allows · 3 min
- [Turn your workflows into tools](https://docs.gorunner.io/mcp/workflows-as-tools): Let an AI app run a workflow you made · 4 min
- [Connect with an API token](https://docs.gorunner.io/mcp/api-token): For an app that can’t sign in · 3 min

Source: https://docs.gorunner.io/mcp/connect
