ScreenTapDocs
PricingSupportBack to site

Getting started

  • How it works
  • Installation
  • First-time setup

Connect your agent

  • Overview
  • Claude Code
  • Claude Desktop
  • Cursor
  • Codex
  • Windsurf
  • VS Code
  • Gemini CLI
  • Other clients

Using ScreenTap

  • Giving tasks
  • Tools

Account

  • License & billing
  • Privacy

Help

  • Troubleshooting
Docs / Windsurf⌄

Getting started

  • How it works
  • Installation
  • First-time setup

Connect your agent

  • Overview
  • Claude Code
  • Claude Desktop
  • Cursor
  • Codex
  • Windsurf
  • VS Code
  • Gemini CLI
  • Other clients

Using ScreenTap

  • Giving tasks
  • Tools

Account

  • License & billing
  • Privacy

Help

  • Troubleshooting
← PreviousCodexNext →VS Code

Connect your agent

Set up Windsurf

Add the server URL to mcp_config.json.

  1. 1

    Open ScreenTap

    The MCP server runs while the ScreenTap app is open.

  2. 2

    Open the MCP config

    In Windsurf, open Settings › Cascade › MCP Servers and choose View raw config. This opens ~/.codeium/windsurf/mcp_config.json.

  3. 3

    Add ScreenTap

    Paste this in. If the file already has servers, add only the "screentap" entry. Note that Windsurf calls the field serverUrl.

    mcp_config.json
    {
      "mcpServers": {
        "screentap": { "serverUrl": "http://127.0.0.1:47811/mcp" }
      }
    }
  4. 4

    Refresh and try it

    Refresh the MCP servers in Cascade, then ask:

    Prompt
    Take a screenshot of my iPhone and tell me what's on screen.

Not working?

Check that the ScreenTap app is open and your iPhone is connected, then restart your agent or start a new session. More fixes in Troubleshooting.