viaSocket Help

Claude Integration Guide

Connect Claude to 2,500+ apps via MCP — Web & Desktop

#

Overview

Mushrooms is viaSocket's MCP (Model Context Protocol) server platform. It connects Claude — and other AI clients like ChatGPT, Cursor, and Windsurf — to over 2,500+ apps through a single secure URL, with no coding required.

There are two ways to connect Claude to your mushrooms (Apps):

  • Claude Web (claude.ai) — add Mushrooms as a custom MCP connector directly in your browser settings. No installation needed.

  • Claude Desktop — paste a JSON config block into the Claude Desktop developer settings file.

Both methods use the same MCP endpoint generated by Mushrooms.

#

Quick Comparison


Claude Web (Browser)

Claude Desktop (App)

Setup method

Add custom MCP connector in Settings

Edit claude_desktop_config.json file

Installation

None — works in browser

Claude Desktop app required

Config format

Paste Remote MCP URL directly

Paste JSON config block

Best for

Quick access, no install

Power users, local workflows

#

Part 1: Set Up Mushrooms

Complete these steps first. They are the same regardless of how you connect Claude.

Step 1: Go to Mushrooms

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



Step 2: Choose Your AI Client

A modal will appear. Select Claude from the list. The selection is highlighted with a border, and "Claude selected" appears at the bottom. Click Done to proceed.


Step 3: Add Mushrooms (Apps)

You land on the Mushrooms dashboard. Click "+ Browse Integrations" to open the integration catalogue.


Step 4: 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 5: Authorize & Select Triggers & Actions

In the authentication pop-up, toggle the triggers and actions you want active. Mushrooms pre-selects sensible defaults based on your previous connections.

Scroll down 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 6: Configure App Actions

Each app offers two options:

  • Select All Actions, enable Everything (AI-Powered) — Claude 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 7: Copy Your MCP Configuration

Back on the dashboard your mushrooms (app) appears under Clusters. Scroll down to the Claude Configuration panel at the bottom of the page.


The Claude Configuration panel shows two items:

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

  • JSON config block — the full JSON for Claude Desktop.

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 MCP Endpoint URL if you are using Claude Web, or copy the JSON config block if you are using Claude Desktop.

#

Part 2: Connect via Claude Web (claude.ai)

Use this method to connect Mushrooms directly in your browser — no desktop app needed.

Method A — Claude Web

Works at claude.ai in any browser. No installation required.

#

Part 3: Connect via Claude Desktop

Use this method if you prefer the native desktop app.

Method B — Claude Desktop

Requires the Claude Desktop app installed on your computer.

Step 1: Open Developer Settings

Open Claude Desktop. Go to Settings → Developer → Edit Config. This opens the claude_desktop_config.json file in your default text editor.

Step 2: Paste the JSON Config

Paste the JSON config block copied from the Mushrooms Claude Configuration panel:

{

  "mcpServers": {

    "mushroom": {

      "url":"https://mcp.viasocket.com/mcp/YOUR_UNIQUE_ID",

"transport": "sse"

    }

  }

}

Save the file.

Step 3: Restart Claude Desktop

Restart the app — press Ctrl + Shift + Esc on Windows, or Quit and relaunch on macOS. When Claude reopens, the viaSocket MCP server will be active and visible in the tools panel.

#

Example Usage

Once connected, type natural language commands directly in Claude:

  • "Add a new row to my Sales sheet with today's date and $5,000 revenue."

  • "Send a Slack message to #general: team standup at 10 am."

  • "Look up the last 5 rows of my Leads spreadsheet."

  • "Create a new HubSpot contact for Ravi Agrawal, [email protected]."

Claude will use your mushrooms (Apps) to perform these actions automatically — no manual app switching needed.

#

Managing Clusters

Mushrooms organises Apps into Clusters. Each cluster has its own MCP endpoint URL. You can:

  • Create multiple clusters for different use cases (e.g., "Sales Automation", "Dev Tools").

  • Add or remove mushrooms (apps) from any cluster at any time.

  • Use one cluster URL across multiple AI clients simultaneously.