Connect Groovy to Claude
Two ways to connect: a one-click desktop plugin that uploads local files from disk, or a hosted MCP server with nothing to install. Either way, Claude can publish HTML/React artifacts live, render markdown as styled docs, and share any file.
Option A — Desktop plugin (.mcpb)
Use the plugin if you work in the Claude Desktop app and want to share local files. It installs in one click, runs on your machine, and uploads PDFs, Word docs and images straight from disk — never base64'd through the chat. Works on macOS, Windows and Linux (not Claude.ai web or mobile).
- 1
Create a Groovy API key
In Groovy, open Connect to Claude Desktop → Desktop bundle and click Create API key. Copy the key it shows once (it starts with grv_live_).
The key authenticates as your account — treat it like a password. It's stored in your OS keychain after install.
- 2
Download and open the bundle
Download groovy.mcpb, then double-click it — or drag it into Claude Desktop → Settings → Extensions. Claude Desktop ships its own runtime, so there's no Node or JSON to set up.
- 3
Paste your API key and install
In the install dialog, paste your Groovy API key and click Install. Then just ask Claude to share a file and it uploads straight from disk.
Option B — Hosted MCP server
Use the MCP server if you want zero install, or you're on Claude.ai web or mobile. Claude connects to Groovy from Anthropic's cloud, so nothing runs locally. Large files are base64-encoded through the chat, so it's best for artifacts and smaller uploads. Also the path for Claude Code.
- 1
Create your Groovy connector link
Every client connects through one hosted URL — no install, no JSON. In Groovy, open Settings → Connectors and click Create connector, then copy the link it shows once. Keep it secret; it authenticates as your account.
https://api.groovy.so/mcp/grv_mcp_… - 2
Add Groovy in Claude Desktop
Open Settings → Connectors → Add custom connector, paste your connector link, and click Connect.
- 3
Using Claude Code? Add it from the terminal
One command registers Groovy as a remote MCP server:
claude mcp add --transport http \ groovy https://api.groovy.so/mcp/grv_mcp_…Then run /mcp inside Claude Code to confirm the connection. Add --scope user to make it available across all your projects.
What you can do once Claude is connected
Create a shareable link
Spin up a polished groovy.so link without leaving the chat.
Publish live artifacts
HTML and React artifacts render live; markdown renders as styled docs.
Share any file
Documents, images, audio and video — all on one beautiful page.
Manage in place
Update titles, set passwords or expiry, and revoke any time.