Connect your agent

Screenie ships with a built-in MCP server. It starts with the app and listens locally at http://127.0.0.1:4319/mcp (Streamable HTTP) — there is nothing to install or run. Any MCP client on your Mac can connect while Screenie is open, and the agent gets Screenie’s design tools: it sets each screen’s HTML, sees a PNG render of its own work after every edit, and iterates live on your canvas.

Inside Screenie (zero setup)

The embedded terminal is pre-wired. Open the Terminal panel and hit ▶ Claude Code (or type claude) — it connects to the app automatically, no configuration at all.

For outside agents, the fastest path is the app itself: click the MCP pill in Screenie’s title bar and hit Connect next to your client — Screenie writes the config for you and shows a live “Connected” check when the agent shakes hands. The sections below are the same setup done by hand.

Claude Code

In any terminal, register Screenie once:

claude mcp add --transport http screenie http://127.0.0.1:4319/mcp

That’s it — every future claude session can use Screenie whenever the app is open. Check with /mcp inside Claude Code.

Cursor

Add Screenie to ~/.cursor/mcp.json (or .cursor/mcp.json inside a project), then enable it under Cursor Settings → MCP:

{
  "mcpServers": {
    "screenie": { "url": "http://127.0.0.1:4319/mcp" }
  }
}

Claude Desktop

Claude Desktop launches local MCP servers over stdio, so it needs the small mcp-remote bridge (requires Node.js). Open Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "screenie": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:4319/mcp"]
    }
  }
}

Restart Claude Desktop and Screenie’s tools appear in the tools menu.

Codex CLI (OpenAI)

Codex also connects through the mcp-remote bridge (requires Node.js). Add this block to ~/.codex/config.toml:

[mcp_servers.screenie]
command = "npx"
args = ["-y", "mcp-remote", "http://127.0.0.1:4319/mcp"]

New codex sessions pick it up automatically while Screenie is open.

Try it

With Screenie open, ask your agent: “Design a home screen for my fitness app in Screenie.” Frames fill in live on the canvas.

Questions? [email protected]