Für Agents

Screenshots für deinen Coding-Agent

Kestrel enthält einen MCP-Server über stdio. Dein Agent fragt, Kestrel nimmt mit seiner eigenen Bildschirmaufnahme-Berechtigung auf, und du siehst bei jeder Aufnahme eine Mitteilung.

Einschalten

Der Zugriff für Agents ist standardmäßig aus. Öffne Kestrel → Einstellungen → Allgemein und aktiviere „Allow agents (MCP)“. Dort richtest du jeden gefundenen Agent auch mit einem Klick ein.

Claude Code
Codex
Claude Desktop
Cursor
Windsurf
VS Code
Gemini CLI

~/projects/app

$ claude mcp add kestrel -- /Applications/Kestrel.app/Contents/MacOS/kestrel --mcp
Added stdio MCP server kestrel

> Warum sieht die Einstellungsseite kaputt aus?

● kestrel · list_windows {"query":"Safari"}
  ⎿ 1 window · Safari · "Settings – Acme"
● kestrel · capture_window {"window":"Safari"}
  ⎿ image/png 1568 × 980

Safari-Fenster aufgenommen. Die Seitenleiste überdeckt bei 1280 pt das Formular, ich korrigiere das Grid.

Manuell einrichten

Claude Code

$ claude mcp add kestrel -- /Applications/Kestrel.app/Contents/MacOS/kestrel --mcp

Andere Clients

Nutze diesen Befehl mit diesem Argument in jedem MCP-Client, der stdio spricht:

/Applications/Kestrel.app/Contents/MacOS/kestrel --mcp

JSON-Konfiguration (Cursor, Claude Desktop, Windsurf …)

{
  "mcpServers": {
    "kestrel": {
      "command": "/Applications/Kestrel.app/Contents/MacOS/kestrel",
      "args": [
        "--mcp"
      ]
    }
  }
}

Werkzeuge

Bilder werden auf 1568 px an der langen Seite verkleinert. Mit maxSize änderst du das, mit save: true wird zusätzlich die volle Größe in deinem Kestrel-Ordner gesichert.

Werkzeug	Was es tut	Argumente
`list_displays`	Monitore mit ID, Position und Größe in Punkten.	`–`
`list_windows`	Sichtbare Fenster anderer Apps, vorderstes zuerst: ID, App, Titel, Position, Größe.	`query`
`capture_screen`	Screenshot eines ganzen Monitors.	`display, maxSize, save`
`capture_window`	Screenshot eines Fensters, auch wenn es verdeckt ist.	`window, shadow, maxSize, save`
`capture_active_window`	Screenshot des vordersten Fensters einer anderen App.	`maxSize, save`
`capture_area`	Screenshot eines Rechtecks in globalen Punkten.	`x, y, width, height, maxSize, save`
`recognize_text`	Text- und QR-Erkennung auf dem Gerät für ein Fenster, einen Monitor oder ein Rechteck.	`window, display, x, y, width, height`

Warum das sicher bleibt

kestrel --mcp leitet nur an die laufende App weiter, über einen Socket, den nur dein Benutzer öffnen kann.
Läuft Kestrel nicht, startet die Brücke die App.
Aufgenommen wird in Kestrel, mit Kestrels Berechtigung, nicht mit der deines Terminals.
Ist „Allow agents“ aus, schlägt jeder Werkzeugaufruf mit einer klaren Meldung fehl.

~/Library/Application Support/de.pixelandprocess.kestrel/mcp.sock