Built with DocStarConnect the Claude Desktop app to 2,500+ apps via MCP
Claude Desktop Method Requires the Claude Desktop app installed on your computer (Windows or macOS). |
Overview
Mushrooms is viaSocket's MCP server platform that connects Claude to 2,500+ apps like Google Sheets, Slack, Gmail, and HubSpot via a single secure URL.
This guide covers connecting Mushrooms to the Claude Desktop app by editing its configuration file.
essential: Download and install Claude Desktop from claude.ai/download before proceeding. |
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 highlights 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 5: Configure App Actions
Each app offers two options:
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 full JSON config block (click the Copy button on the JSON panel inside the Claude Configuration section). You will paste this into Claude Desktop in the next steps.
Part 2: Configure Claude Desktop
Step 1: Open Developer Settings
Open the Claude Desktop app. Navigate to:
Settings → Developer → Edit Config |
This opens the claude_desktop_config.json file in your default text editor (Notepad, VS Code, etc.).
Step 2: Paste the JSON Config
Replace or update the file contents with the JSON config you copied from Mushrooms. It looks like this:
{ "mcpServers": { "mushroom": { "url": "https://mcp.viasocket.com/mcp/YOUR_UNIQUE_ID" "transport": "sse" } } } |
Important: Replace YOUR_UNIQUE_ID with the actual ID from your Mushrooms cluster URL. Copy the config directly from Mushrooms to avoid errors. |
Save the file (Ctrl + S on Windows, Cmd + S on macOS).
Step 3: Restart Claude Desktop
Quit and relaunch Claude Desktop:
Windows: press Ctrl + Shift + Esc to open Task Manager, end the Claude process, then reopen.
macOS: press Cmd + Q to quit, then reopen from Applications.
When Claude restarts, the viaSocket MCP server will be active. You will see it listed in the tools/hammer icon panel inside the chat.
Done! Claude Desktop is now connected to your Mushrooms power-ups. You can add more apps to your Mushrooms cluster at any time without needing to restart again. |
