# Zed

Connect Zed to GoRunner, then ask it to build, run and check your workflows.

## You need

- **Zed**: On your computer.

## Connect Zed

*Cloud and Self-hosted only:*

1. In GoRunner, open **MCP** in the sidebar. If an app is already connected, press **Connect an AI app**. Choose **Zed**; if it isn’t shown, press **All 13 apps**.

   ![The Connect an AI app panel with Zed chosen. The ringed key is the one to press.](https://docs.gorunner.io/img/ai-apps/ai-zed-light.jpg)

2. Press **Copy** next to **MCP server address**. Open **Settings** → **AI** → **MCP Servers**, then **Add Server** → **Add Remote Server**.

3. Paste the address, name it gorunner and save. Sign in when Zed asks.

4. On **Allow “Zed” to use GoRunner?**, choose the workspace and what it may do, then press **Allow access**.

*Embed only:*

[Since v2026.10.23](https://docs.gorunner.io/changelog/v2026.10.23)

1. In the product you use, open **MCP**, press **Connect an AI app** and choose **Zed**. Press **Copy** next to the address.
2. Open **Settings** → **AI** → **MCP Servers**, then **Add Server** → **Add Remote Server**.
3. Paste the address, name it workflows and save. Sign in when Zed asks.
4. Choose what it may do, then press **Allow access**.

You should see “**Connected** · Zed · Acme · 12 tools” in the panel.

It stays connected for up to 180 days, or until you disconnect it.

*Embed only:*

The panel shows your product’s name where these steps say `workflows`. Without sign-in for AI apps, the panel shows Zed with a token instead: make or paste one, and copy the setting it fills in. If the product lets apps run your workflows but not build them, the address ends in `/tools`. Zed can then only call your published workflows. See [Turn your workflows into tools](https://docs.gorunner.io/mcp/workflows-as-tools).

**Can I use an API token instead?**

Yes, for an app that can’t sign in. In the panel, press **Use an API token instead**. [Connect with an API token](https://docs.gorunner.io/mcp/api-token) shows each step.

**How do I disconnect Zed?**

*Cloud and Self-hosted only:*

On the **MCP** page, under **Connected apps**, press **Disconnect** next to the app. Revoke a token in **Settings › Workspace › API tokens**.

*Embed only:*

On the product’s **MCP** page, press **Disconnect** next to the app.

It stops on its next request. Remove it in Zed too.

## What you can ask

*Cloud and Self-hosted only:* 13 tools: it reads, drafts and runs in the workspaces you choose. It publishes only if you allow it. *Embed only:* What it can do depends on what the product allows: building, or only your published workflows. If Zed lists the server’s commands, try one:

- Build a workflow (when it may write drafts)
- Diagnose a failed run
- Explain a workflow

It can also call your own published workflows.

## For developers

AI apps connect through MCP (Model Context Protocol). Zed adds the server `https://api.gorunner.io/mcp/build` under the name `gorunner` and signs in with [OAuth](https://docs.gorunner.io/mcp/oauth). Self-hosted: your installation’s address, ending in `/mcp/build`.

## Related

- [Choose what an AI app may do](https://docs.gorunner.io/mcp/permissions): Read only, Draft and run, or publish too · 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
- [See and disconnect AI apps](https://docs.gorunner.io/mcp/disconnect): Connected apps, on the MCP page · 2 min

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