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 / VS Code⌄

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
← PreviousWindsurfNext →Gemini CLI

Connect your agent

Set up VS Code

GitHub Copilot in Agent mode, via mcp.json.

  1. 1

    Open ScreenTap

    The MCP server runs while the ScreenTap app is open. You need GitHub Copilot in VS Code.

  2. 2

    Add ScreenTap

    For one project, create .vscode/mcp.json. For everywhere, run “MCP: Open User Configuration” from the command palette. VS Code uses "servers", not "mcpServers".

    mcp.json
    {
      "servers": {
        "screentap": { "type": "http", "url": "http://127.0.0.1:47811/mcp" }
      }
    }
  3. 3

    Start the server

    Click Start above the screentap entry in mcp.json, or run “MCP: List Servers” and start it there.

  4. 4

    Try it

    Open Copilot Chat, switch to Agent mode, check the tools button lists ScreenTap, and 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.