Benutzerhandbuch
Herunterladen
Benutzerhandbuch durchsuchen

Weitere KI-Agenten verbinden

Füge Shotomatic in Cursor, VS Code, Gemini CLI, Zed, Cline, Goose und anderen MCP-Clients mit demselben npx-Befehl hinzu.

Aktualisiert am 15. November 2026

Auf dieser Seite
  1. Amp
  2. Cline
  3. Continue
  4. GitHub Copilot CLI
  5. Cursor
  6. Devin (Windsurf)
  7. Gemini CLI
  8. Goose
  9. JetBrains AI Assistant und Junie
  10. Kiro
  11. LM Studio
  12. OpenCode
  13. Qwen Code
  14. Roo Code
  15. VS Code mit GitHub Copilot
  16. Warp
  17. Zed
  18. Das solltest du wissen
  19. Fehlerbehebung

Getestet mit Claude Code und Codex. Die folgenden Clients nutzen denselben MCP-Standard. Die Schritte folgen der jeweiligen Dokumentation des Clients. Shotomatic wurde mit diesen Clients nicht getestet. Menüs und Dateiformate der Clients ändern sich, schau also in die Dokumentation des Clients, wenn ein Schritt nicht mehr passt.

Jeder Client braucht dieselben drei Werte:

  • Befehl: npx
  • Argumente: -y, shotomatic, mcp
  • Umgebungsvariablen: keine. Es gibt keinen API-Schlüssel.

Schalte vor dem Hinzufügen unter Einstellungen > KI-Agenten Zugriff für KI-Agenten erlauben ein und installiere Node 18.3 oder neuer. Beim ersten Verbinden eines Clients zeigt Shotomatic eine Zulassungskarte. Wähle Erlauben. Den ganzen Ablauf, auch für Claude Code, Claude Desktop und Codex, findest du unter KI-Agenten verbinden.

Unter Windows steht ~ in den folgenden Pfaden für deinen Benutzerordner (%USERPROFILE%). Kann ein Client unter Windows npx nicht starten, trage cmd als Befehl und /c, npx, -y, shotomatic, mcp als Argumente ein.

Jeder Client hat eigene MCP-Einstellungen, und viele fragen vor jedem Werkzeugaufruf nach. Trage Shotomatic dort ein, wo der Client einen lokalen (stdio-)Server erwartet, nicht eine Remote-URL.

Amp

Docs: Amp MCP. Führe aus:

amp mcp add shotomatic -- npx -y shotomatic mcp

Mit amp mcp doctor prüfst du den Server. Laut Handbuch von Amp bündelst du MCP-Server in Skills, wenn du sie nicht in jedem Thread brauchst.

Cline

Docs: Configuring MCP servers. Wähle im Cline-Bereich das Symbol „MCP Servers“, öffne Configure und wähle Configure MCP Servers. Füge dies in die JSON-Datei ein, die sich öffnet (die Cline-CLI verwendet ~/.cline/data/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Die Liste autoApprove von Cline ist standardmäßig leer, deshalb fragt Cline vor jedem Werkzeugaufruf nach.

Continue

Docs: Set up MCP in Continue. MCP funktioniert nur im Agent-Modus. Lege in deinem Workspace die Datei .continue/mcpServers/shotomatic.yaml an:

name: Shotomatic
version: 0.0.1
schema: v1
mcpServers:
  - name: Shotomatic
    type: stdio
    command: npx
    args:
      - "-y"
      - "shotomatic"
      - "mcp"

GitHub Copilot CLI

Docs: Adding MCP servers to Copilot CLI. Führe aus:

copilot mcp add shotomatic -- npx -y shotomatic mcp

Das schreibt nach ~/.copilot/mcp-config.json. Gib in einer Sitzung /mcp ein, um die Übersicht der MCP-Server zu öffnen.

Cursor

Docs: Model Context Protocol in Cursor. Füge dies in ~/.cursor/mcp.json für alle Projekte ein oder in .cursor/mcp.json innerhalb eines Projekts:

{
  "mcpServers": {
    "shotomatic": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Prüfe unter Customize, ob der Server aktiviert ist. Startfehler zeigt Cursor in Output (Cmd + Shift + U, unter Windows Ctrl + Shift + U) unter MCP Logs. Cursor fragt standardmäßig nach, bevor es MCP-Werkzeuge verwendet.

Devin (Windsurf)

Docs: Devin CLI MCP configuration und Devin Desktop customizations. Die eigene Dokumentationsadresse von Windsurf leitet jetzt auf die Devin-Desktop-Dokumentation um. Führe aus:

devin mcp add -s user shotomatic -- npx -y shotomatic mcp

Oder füge dasselbe JSON wie oben (ohne type) in ~/.config/devin/mcp_config.json ein. Führe devin mcp list aus oder öffne in Devin Desktop Customize > MCPs und sieh unter This computer nach. Der Agent fragt standardmäßig nach, bevor er ein MCP-Werkzeug aufruft.

Gemini CLI

Docs: MCP servers with Gemini CLI. Füge dies in ~/.gemini/settings.json ein (oder in .gemini/settings.json in einem Projekt):

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Führe gemini mcp list in einer Shell aus oder /mcp in einer Sitzung. Stdio-Server erscheinen nur als verbunden, wenn der aktuelle Ordner als vertrauenswürdig gilt. Lass trust auf dem Standardwert (false), damit Gemini CLI vor jedem Werkzeugaufruf weiter nachfragt.

Goose

Docs: Using extensions. Öffne in Goose Desktop Extensions, wähle Add custom extension und gib ein:

  • Type: Standard IO
  • ID: shotomatic
  • Name: Shotomatic
  • Command: npx -y shotomatic mcp

Führe in der CLI goose configure aus, wähle Add Extension und Command-line Extension und gib denselben Befehl ein. Für eine einzelne Sitzung führst du goose session --with-extension "npx -y shotomatic mcp" aus.

JetBrains AI Assistant und Junie

Docs: AI Assistant MCP und Junie CLI MCP configuration.

AI Assistant: Öffne Settings | Tools | AI Assistant | Model Context Protocol (MCP), wähle Add, füge das JSON unten ein und wähle Apply. Die Spalte Status zeigt die Verbindung.

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Junie: Füge dasselbe JSON in ~/.junie/mcp/mcp.json ein (oder in .junie/mcp/mcp.json in einem Projekt) und führe dann /mcp aus, um zu prüfen, ob der Server aktiv ist.

Kiro

Docs: Kiro MCP configuration. Führe in der Command Palette Kiro: Open user MCP config (JSON) aus oder bearbeite ~/.kiro/settings/mcp.json (.kiro/settings/mcp.json für einen Workspace). Achte darauf, dass die Einstellung für MCP-Unterstützung eingeschaltet ist, und füge dann hinzu:

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Beim Speichern der Datei verbinden sich die Server neu.

LM Studio

Docs: Use MCP servers in LM Studio. LM Studio unterstützt lokale MCP-Server und folgt der mcp.json-Notation von Cursor. Öffne in der rechten Seitenleiste den Tab Program und wähle Install > Edit mcp.json. Füge hinzu:

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Die Dokumentation von LM Studio rät davon ab, MCP-Server aus Quellen zu installieren, denen du nicht vertraust, und warnt, dass manche Server viele Tokens verbrauchen und so den Kontext eines lokalen Modells überlaufen lassen können.

OpenCode

Docs: OpenCode MCP servers. Führe dies in dem Projekt aus, das den Server verwenden soll, und ergänze --global, damit er überall verfügbar ist:

opencode mcp add shotomatic -- npx -y shotomatic mcp
opencode mcp list

Um die Konfiguration nach der aktuellen Dokumentation (V2) von Hand zu bearbeiten, füge dies in opencode.jsonc ein. Das V1-Format sieht anders aus. Nimm den CLI-Befehl, wenn du nicht sicher bist, welche Version du hast.

{
  "mcp": {
    "servers": {
      "shotomatic": {
        "type": "local",
        "command": ["npx", "-y", "shotomatic", "mcp"]
      }
    }
  }
}

Qwen Code

Docs: Connect Qwen Code to tools via MCP. Füge dies in ~/.qwen/settings.json (Benutzer) oder .qwen/settings.json (Projekt) ein:

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Starte Qwen Code im selben Projekt neu und gib dann /mcp ein, um den Server zu sehen.

Roo Code

Docs: Using MCP in Roo Code. Öffne die MCP-Einstellungen über das Symbol oben im Roo-Code-Bereich, scrolle nach unten und wähle Edit Global MCP (mcp_settings.json) oder Edit Project MCP (.roo/mcp.json). Füge hinzu:

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

VS Code mit GitHub Copilot

Docs: MCP configuration reference und Manage MCP servers. VS Code verwendet servers statt mcpServers und verlangt type. Füge dies in .vscode/mcp.json eines Workspace ein:

{
  "servers": {
    "shotomatic": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Um den Server stattdessen deinem Benutzerprofil hinzuzufügen, führe aus:

code --add-mcp '{"name":"shotomatic","type":"stdio","command":"npx","args":["-y","shotomatic","mcp"]}'

Führe in der Command Palette MCP: List Servers aus, um den Server zu sehen und zu starten oder neu zu starten. VS Code bittet dich möglicherweise, dem Server beim ersten Start zu vertrauen.

Warp

Docs: Model Context Protocol in Warp. Öffne Settings > Agents > MCP servers, wähle + Add und füge ein:

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Die Seite „MCP servers“ listet jeden Server und zeigt, ob er läuft. Der Agent von Warp fragt vor Aufrufen von MCP-Servern nach, solange du einen Server nicht im Agentenprofil erlaubst.

Zed

Docs: Model Context Protocol in Zed. Zed nennt sie Context Server und verwendet context_servers. Führe in der Command Palette zed: open settings file aus und füge hinzu:

{
  "context_servers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"],
      "env": {}
    }
  }
}

Öffne Settings > AI > MCP Servers: Ein grüner Punkt mit dem Tooltip „Server is active“ bedeutet, dass der Server verbunden ist. Zed fragt standardmäßig vor Werkzeugaufrufen nach.

Das solltest du wissen

  • Shotomatic liefert Screenshots als Bilder innerhalb der Werkzeugergebnisse. Cursor und Gemini CLI dokumentieren die Unterstützung von Bildern in MCP-Werkzeugergebnissen. Bei den übrigen Clients oben sagt die Dokumentation dazu nichts, der Agent erhält womöglich nur Text.
  • Mehrere Clients fragen standardmäßig bei jedem Werkzeugaufruf nach. Bei einer langen Aufnahme kann das viele Rückfragen bedeuten. Wie du die Werkzeuge eines Servers freigibst, steht in der Dokumentation des jeweiligen Clients. Was Shotomatic selbst Agenten erlaubt, steht unter Grenzen und Sicherheit.

Fehlerbehebung

  • Der Client sieht den Server nicht. Speichere die Konfigurationsdatei und starte den Client neu oder lade seine MCP-Liste neu. Prüfe, ob der Eintrag unter dem Schlüssel steht, den der Client erwartet (mcpServers, servers oder context_servers), und ob das JSON oder YAML gültig ist.
  • „MCP access is turned off.“ Öffne Shotomatic, gehe zu Einstellungen > KI-Agenten, schalte Zugriff für KI-Agenten erlauben ein und starte den Client neu.
  • Es erscheint keine Zulassungskarte. Öffne Shotomatic und suche die Karte. Auf dem Mac hüpft das Dock-Symbol, wenn sie erscheint. Bis du zulässt, kann der Agent nur den Status lesen. Entfernst du den Agenten unter Einstellungen > KI-Agenten, erscheint die Karte beim nächsten Verbinden wieder.
  • Der Client findet npx oder Node nicht. Auf dem Mac starten Apps, die du über das Dock oder den Finder öffnest, oft mit einem kürzeren PATH als das Terminal. Laut Dokumentation von Cursor muss der Befehl im Systempfad liegen oder als vollständiger Pfad angegeben werden, und die Dokumentation von Qwen Code empfiehlt einen absoluten Befehlspfad, wenn ein Server nicht startet. Führe im Terminal which npx aus und verwende diesen vollständigen Pfad als Befehl, zum Beispiel /opt/homebrew/bin/npx. npx braucht außerdem node in seinem PATH. Klappt es trotzdem nicht, trage den Ordner aus which node in einen PATH-Eintrag unter env des Servers ein (wo der Client env unterstützt). Versionsmanager wie mise oder asdf brauchen unter Umständen dasselbe.

Zurück zu KI-Agenten verbinden.

Weitere KI-Agenten verbinden | Benutzerhandbuch | Shotomatic