Zed Integration Guide

Connect Zed AI to 2,500+ apps via Mushrooms MCP

Mushrooms is viaSocket's MCP server platform that connects Zed to 2,500+ apps like Google Sheets, Slack, Gmail, and HubSpot via a single secure URL.

This guide covers two parts — setting up your Mushrooms cluster first, then connecting it to Zed's Agent Panel.

Complete these steps first. They are the same regardless of which AI client you are connecting.

Step 1: Go to Mushrooms

Open mushroom.viasocket.com in your browser. Click "+ New Cluster" to begin.

Step 2: Add your desired Apps

You land on the Mushrooms dashboard. Click "+ Plant your first power-up" to open the integration catalogue.

Step 3: Pick an App from the Catalogue

Search or scroll to find the app you need — Google Sheets, Slack, Gmail, HubSpot, and 2,500+ more. Click on it to open its configuration screen.

Step 4: Authorize & Select Actions

After you hit the connect button, the authentication pop-up will appear, and then select the actions you want active. Mushrooms pre-selects sensible defaults based on your previous connections.

Click the “Next”, the authorization pop-up will open — sign in and grant permissions. Once authorized, you’ll be returned to the app’s configuration screen.

Step 5: Configure App Actions

Each app offers two options:

• Enable Everything (AI-Powered) — Zed automatically decides which actions to use.

• Configure Actions manually — pick only the specific actions you want to expose (e.g., Add New Row, Get Row Details, Delete Row).

Once the actions are configured, scroll down and click the "Enable" button.

Step 6: Copy Your MCP Endpoint JSON

Back on the dashboard, your app appears under your Cluster. Scroll down to the Configuration panel at the bottom of the page.

The Configuration panel shows:

• MCP Endpoint URL — a unique HTTPS URL for your cluster.

• JSON config block — the ready-made config to paste directly into Zed.

Security: Keep this URL private. It authorises AI actions on your connected accounts. Do not share it publicly or commit it to version control.

Copy the JSON config block from the panel. You will paste it into Zed in the next steps.

Step 1: Open the Agent Panel

Open Zed. Navigate to the Agent Panel from the sidebar or top menu.

Step 2: Add a Custom MCP Server

Inside the Agent Panel, click "Add Custom Server".

Step 3: Paste the JSON Configuration

Paste the following JSON configuration, replacing the placeholder URL with your MCP Endpoint URL from your Mushrooms cluster dashboard:

{...}{
  "mcpServers": {
    "mushroom": {
      "url": "https://mcp.viasocket.com/mcp/your-unique-id",
      "transport": "sse"
    }
  }
}

Copy your MCP Endpoint URL or the ready-made JSON config directly from your Mushrooms cluster dashboard.

Step 4: Save and Verify

Save the configuration. Zed will connect to your Mushrooms cluster and load all your configured app actions automatically. You will see Mushrooms listed as an active MCP server in the Agent Panel.

⚠️ Caution: Treat your MCP Endpoint URL like a password! It can be used to run tools attached to this server and access your data.