Popcorn MCP Connector

Connect Claude to your Popcorn workspace

What is Popcorn?

Popcorn runs static sites, build-step frontends (React, Vite, Next.js), and apps with a live backend (Node/Express, Python/Flask), alongside built-in messaging and collaboration. The Popcorn MCP connector lets Claude read your channels, send messages, search conversations, and deploy apps to Popcorn app channels — all from within Claude.

Features

  • Read messages — Browse channel history, threads, and DMs
  • Send messages — Post to channels, reply in threads, upload files
  • Search — Find messages, channels, DMs, and users across your workspace
  • React — Add or remove emoji reactions on messages
  • Deploy — Publish apps to Popcorn app channels from local files or a GitHub ref
  • Export — Pull a site's source back to your local machine or push it to GitHub
  • Channel management — View channel details, members, and site deployment status

Setup

Claude.ai (Web)

  1. Go to Settings → Integrations → Add MCP Server
  2. Enter the server URL: https://mcp.popcorn.ai/mcp
  3. Click Connect and sign in with your Popcorn account
  4. Grant the requested permissions (profile and email)

Claude Code (CLI)

Add to your Claude Code settings or run:

                    claude mcp add popcorn --transport streamable-http https://mcp.popcorn.ai/mcp

Claude Desktop

Add to your claude_desktop_config.json:

{`{
  "mcpServers": {
    "popcorn": {
      "url": "https://mcp.popcorn.ai/mcp"
    }
  }
}`}

Authentication

Popcorn uses OAuth 2.0 for authentication. When you connect, you'll be redirected to sign in with your Popcorn account. The connector requests two scopes:

  • profile — Your name and username
  • email — Your email address (used to identify your workspace)

Your session stays active as long as you use it regularly, expiring after 7 days of inactivity. You can revoke access at any time by disconnecting the integration in Claude's settings.

If you belong to multiple Popcorn workspaces, ask Claude to “switch workspace” or call whoami to see all workspaces you have access to. Passing a workspace_id to whoami switches the active workspace for the session.

Usage Examples

Read channel messages

"What's the latest discussion in #design-reviews?"

Claude searches for the channel, reads recent messages, and summarizes the conversation — including who said what and any decisions made.

Post an update

"Send a message to #eng-standup: API migration is complete."

Claude finds the channel, shows you the message for confirmation, then posts it. Channel members receive a notification.

Deploy a project

"Publish my project to Popcorn"

Claude packages your local project files and calls deploy_site to push them to your Popcorn app channel's VM. You get a live site URL and version number. Or pass a git_ref to deploy directly from GitHub instead.

Export a site

"Export my site to a GitHub repo"

Claude calls export_site to pull the current site source off the VM — either back to your local machine as a download or pushed up to a GitHub branch. Useful for forking a live site back into code.

Search across your workspace

"Find any messages mentioning the auth migration"

Claude searches messages across all channels you have access to and presents matches with channel names, authors, and timestamps.

Reply in a thread

"Reply to Ben's message in #backend: Good catch, I'll fix it in the next PR"

Claude finds the message, shows your reply for confirmation, and posts it in the thread. Thread participants are notified.

Available Tools

Tool Description Access
whoami Show current workspace and user, list all workspaces you belong to, and optionally switch active workspace Read / Write
get_channel Channel details, members, and site status Read-only
search Search channels, DMs, users, or messages Read-only
read_messages Read message history and threads Read-only
post_message Post messages, reply in threads, upload files Write
react Add or remove emoji reactions Write
deploy_site Deploy local code or a GitHub ref to a site (auto-creates channel) Write
export_site Export site source from the VM to a local download or push to GitHub Write
update_channel Create or update channels (deprecated — use deploy_site / export_site) Write

Prompts

The connector also exposes MCP prompts — invokable workflows that bundle the right tools and instructions for a common task.

  • pop — Deploy or publish your local project files to a Popcorn app channel. Accepts optional project_name and context arguments and walks Claude through the full deploy flow.

Privacy & Support

The Popcorn connector only accesses channels and conversations your account has permission to view. No data is stored by the connector beyond your authenticated session.