Skip to main content
Claude connects to Popcorn in two ways. Claude on the web, desktop and mobile uses a custom connector (or a button, where Popcorn’s directory listing is available). Claude Code uses one command. Either way you approve access once in your browser, and from then on Claude can work in your workspace.

​
Before you start

  • A Popcorn role with API keys view access, so you can open Settings → AI assistants. Owner, Admin and Manager have it.
  • For the connector: a Claude plan that can add custom connectors. Where that option lives is Claude’s own interface; the Claude card says to use Customize, Connectors, Add custom connector. For Claude Code: Claude Code installed on your computer.
  • A Popcorn account with a phone number that has finished setup, for the connector. If it has not, Popcorn takes you through that first and then returns you to the approval screen.
  • If you belong to more than one workspace, switch to the one you want first. The connection belongs to the workspace you approve it in.

​
Connect

1

Copy the connector URL

In Popcorn, go to Settings → AI assistants. Under Connect an assistant, find the Claude card (labelled Custom connector) and click Copy connector URL. The value is:
If the card shows a Claude connector label and a Connect in Claude button instead, click it: it opens Popcorn AI in Claude’s connectors directory. Select Connect, sign in to your Popcorn AI account, review the access it asks for, and skip to the last step.
2

Add it in Claude

Click Open Claude (it opens Claude’s connectors page), or open Claude yourself. Under Customize, Connectors, choose Add custom connector, paste the URL and continue. There is no token or key to enter.
3

Approve access in your browser

Popcorn opens “Connect assistant to Popcorn AI” (“This will let assistant do the following in workspace.”). If you are not signed in, you are sent to sign in first and then brought back.The screen shows the App, the Workspace (with your email), when the Request expires, the Connection address and Requested access. Check that the workspace is the one you intend, then click Allow access.
4

Try a request

Ask Claude something read-only first, for example “Give me an overview of my Popcorn workspace” or “List my WhatsApp templates and their approval status.”
The approval request is valid for 10 minutes. If the page says Authorization request was not found., ask Claude to use Popcorn again to get a fresh approval screen. For the connector, a request that lapsed while you were signing in or finishing account setup is renewed when you come back, for up to 24 hours after the connection started.

​
What the approval screen means

  • Requested access lists each area Claude asked for, in the form “Campaigns: Read”, with a short description and the access code beside it. A description that says “after you confirm the action” means Claude must show you a preview and get your go-ahead each time before Popcorn carries it out.
  • The connector asks for every area at once, and Popcorn grants only what your role allows. If your role allows none of them, approval is refused. Claude Code chooses what it asks for. If it asks for more than your role can grant, the page shows Authorization request expired. instead of the approval screen. If Claude does not ask for specific areas, Popcorn grants read-only access to every area your role can view.
  • Deny cancels the request. Nothing is connected.
See Permissions and safety for the full model.

​
What is different between the two

​
First requests to try

​
Built-in workflows

Popcorn publishes four ready-made workflows that Claude can list and run: Safely prepare and launch a campaign, Triage the Popcorn inbox, Review and publish an agent version, and Connect a commerce or messaging integration. Each walks Claude through reading first, showing you a preview, and waiting for your confirmation. See What you can do.

​
Troubleshooting