Skip to content
Cask Manual

Turn on Agent Access

This turns on the MCP server inside the app. While it is off, nothing is listening and no client can connect. Cask Film has it on from the first launch, so there you need these steps only if you turned it off. Each app has its own switch: turning it on in one does not turn it on in the other.

You need:

  • Cask Film or Cask Flow, open.

Steps

Section titled “Steps”

In Cask Film:

  1. Open Settings from the Cask Studio menu.
  2. Go to the General tab.
  3. Scroll to Agent Access.
  4. Turn on the switch next to Allow AI agents to control this app via MCP (localhost only).

In Cask Flow:

  1. Open Settings, from the account control in the editor’s title bar or the Settings button on the projects screen.
  2. Go to the Agent access section.
  3. Turn on Allow agent access.

Result

Section titled “Result”

Cask Film expands the Agent Access section to show the connect surface, reading Connect an agent once. Its tools work whenever Cask Studio is open. with a Connect Agent button.

Cask Flow’s Agent access section reads Listening for MCP clients via cask-mcp. and lists the clients it knows about.

The app is now serving MCP on the loopback interface. It picks a fresh port and mints a fresh token on every launch, and neither is anything you have to handle: the bridge your client talks to reads them for itself.

Next, connect a client: Claude Code, Claude Desktop, Codex, or any other MCP client.

If it doesn’t work

Section titled “If it doesn’t work”
Symptom Cause Fix
No Agent Access section in Cask Film’s General tab You are looking at a different Settings tab It is below Updates in General; scroll down
The switch turns itself back off The preference did not apply, which is a bug rather than a setting Quit and reopen the app, then set it again
The client list shows a client as not installed The app cannot find that client’s app or CLI on this Mac Install the client first, then reopen the list
Your client still sees no tools after enabling The client connects to the app, and the app has to be running Leave the app open. The tools appear on their own within a few seconds, with no client restart
You cannot reach the window at all, for example on a headless runner There is no way to click the switch In Cask Flow, run defaults write studio.cask.flow cask.flow.agent.mcpEnabled -bool YES