Connect your agent

ScreenTap works with any agent that supports MCP. Pick yours for a step-by-step guide.

Claude Code

HTTP

One terminal command, works in every project.

Setup guide →

Claude Desktop

stdio

Add one entry to the config file, then restart.

Setup guide →

Cursor

HTTP

Add the server URL to mcp.json.

Setup guide →

Codex

stdio

Add a server block to config.toml.

Setup guide →

Windsurf

HTTP

Add the server URL to mcp_config.json.

Setup guide →

VS Code

HTTP

GitHub Copilot in Agent mode, via mcp.json.

Setup guide →

Gemini CLI

HTTP

Add the server URL to settings.json.

Setup guide →

Other clients

HTTP

Anything that speaks MCP, over HTTP or stdio.

Setup guide →

How agents connect

ScreenTap offers two ways in. The guides use the right one for each agent.

HTTP: the agent connects to the running app at http://127.0.0.1:47811/mcp.
stdio: for agents that can only start a program, they run the app with --stdio, which hands everything over to the running app.

Connection details

Streamable HTTP   http://127.0.0.1:47811/mcp
stdio             /Applications/ScreenTap.app/Contents/MacOS/ScreenTap --stdio

Either way, keep the ScreenTap app open. The server only listens on your own Mac, so the agent must run on the same Mac. The same commands and configs are in the app under Connect an agent, ready to copy.

← PreviousFirst-time setup Next →Claude Code