> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/cli/de/anleitungen/ai-agents/connect-mcp.md).

# Einen KI-Client mit MCP verbinden

Den MCP-Server von Devolutions CLI zu Claude Code, GitHub Copilot oder einem anderen MCP-Client hinzufügen und verstehen, was das Modell sehen und tun kann.

`devo mcp` macht Devolutions CLI zu einem Model Context Protocol-Server (MCP). Ihr KI-Client startet ihn, und das Modell erhält Tools, um an Ihrem Workspace zu arbeiten: Tresore auflisten, Einträge suchen, Zugriff prüfen, Passwörter generieren und mehr. Es ist derselbe Workspace und dieselben Berechtigungen wie bei den `devo`-Befehlen, die Sie selbst ausführen.

## Bevor Sie beginnen

* Devolutions CLI ist installiert, und der Befehl `devo` steht auf dem `PATH` des KI-Clients.
* Sie sind angemeldet. Der MCP-Server hat kein Anmeldetool: Er verwendet die Kontexte, die Sie mit `devo login` gespeichert haben, beginnend mit dem aktuellen. Siehe [Mit Ihren Workspaces verbinden](/cli/de/anleitungen/connect.md).
* Ihr MCP-Client kann einen lokalen Server über Standardeingabe und -ausgabe (stdio) starten, was die meisten Clients tun.

{% hint style="warning" %}
Der MCP-Server kann einen Geheimniswert an Ihren KI-Client zurückgeben, über das Tool `RDM_resolve_secret_reference`. Alles, was der Client empfängt, kann das Modell und sein Transkript erreichen. Wenn das Modell die Werte nicht braucht, starten Sie den Server mit `--deny-tool RDM_resolve_secret_reference`. Siehe [Einschränken, was ein Agent tun kann](/cli/de/anleitungen/ai-agents/limit-tools.md).
{% endhint %}

## Fügen Sie den Server Ihrem Client hinzu

Die meisten MCP-Clients beschreiben einen lokalen Server mit einem Befehl und seinen Argumenten. Fügen Sie einen Eintrag wie diesen zur MCP-Konfiguration Ihres Clients hinzu:

```json
{
  "mcpServers": {
    "devolutions": {
      "command": "devo",
      "args": ["mcp", "--deny-tool", "RDM_resolve_secret_reference"]
    }
  }
}
```

Der Schlüssel, der die Server enthält (`mcpServers` hier), und die Datei, in die er gehört, hängen von Ihrem Client ab. Sehen Sie in der Dokumentation Ihres Clients nach, wo ein lokaler stdio-Server hinzugefügt wird.

Starten Sie den Client neu oder laden Sie seine MCP-Server neu. Der Client startet `devo mcp` selbst und beendet ihn, wenn die Sitzung endet: Sie führen ihn nicht in einem Terminal aus.

### Optionen, die Sie hinzufügen können

<table><thead><tr><th width="260">OPTION</th><th>WAS ES TUT</th></tr></thead><tbody><tr><td><code>--context &#x3C;context-name></code></td><td>Verwendet diesen gespeicherten Kontext statt Ihres aktuellen. Nützlich, wenn der Agent nur an einem Workspace arbeiten muss.</td></tr><tr><td><code>--read-only</code>, <code>--deny-destructive</code>, <code>--deny-open-world</code>, <code>--allow-tool</code>, <code>--deny-tool</code></td><td>Schränken Sie die Werkzeuge ein, die das Modell erhält. Siehe <a href="/cli/de/anleitungen/ai-agents/limit-tools.md">Einschränken, was ein Agent tun kann</a>.</td></tr><tr><td><code>--server-name &#x3C;name></code></td><td>Servername, der an den Client gesendet wird, wenn er sich verbindet. Der Standard ist <code>Remote Desktop Manager Devo CLI MCP Server</code>.</td></tr></tbody></table>

Zum Beispiel, um einem Agenten nur Lesezugriff auf einen Workspace zu geben:

```json
{
  "mcpServers": {
    "devolutions": {
      "command": "devo",
      "args": ["mcp", "--context", "<context-name>", "--read-only", "--deny-tool", "RDM_resolve_secret_reference"]
    }
  }
}
```

## Was das Modell tun kann

Alle Toolnamen beginnen mit `RDM_`. Sie decken diese Bereiche ab:

<table><thead><tr><th width="200">BEREICH</th><th>BEISPIELE</th></tr></thead><tbody><tr><td><strong>Workspaces</strong></td><td>Listet die Workspaces auf, die die Sitzung verwenden kann (lokales Profil und jeder gespeicherte Devolutions Cloud- oder Devolutions Server-Kontext), und wechselt für den Rest der Sitzung zwischen ihnen.</td></tr><tr><td><strong>Tresore und Einträge</strong></td><td>Tresore auflisten, Einträge suchen, einen Eintrag abrufen, seine Metadaten, Anhänge, Berechtigungen und Protokolle auflisten; Tresore erstellen, aktualisieren oder löschen; Einträge aktualisieren, verschieben oder löschen; Aktivitätsprotokolle in eine lokale Datei exportieren.</td></tr><tr><td><strong>Benutzer und Zugriff</strong></td><td>Benutzer und Gruppen auflisten, Gruppen erstellen oder löschen, Benutzer löschen, Tresorzugriff auflisten, eine Tresorrolle gewähren oder entziehen, Sicherheitsrollen und Berechtigungssätze auflisten.</td></tr><tr><td><strong>Passwörter</strong></td><td>Erzeugen Sie lokal starke, lesbare, Passphrase- oder Musterpasswörter.</td></tr><tr><td><strong>Geheimnisse</strong></td><td>Löst eine <code>devo://</code>-Referenz zu ihrem Wert auf (<code>RDM_resolve_secret_reference</code>). Die Antwort enthält das Geheimnis.</td></tr><tr><td><strong>Hintergrundprozess</strong></td><td>Prüft, startet, lädt neu, startet neu oder stoppt den Hintergrundprozess von Devolutions CLI.</td></tr></tbody></table>

Tools, die Tresore, Einträge, Gruppen, Benutzer oder Zugriff erstellen, ändern oder löschen, verlangen eine ausdrückliche Bestätigung in der Anfrage. Das Modell gibt diese Bestätigung, nicht Sie: Um das Modell von Änderungen fernzuhalten, verwenden Sie `--read-only`.

Der MCP-Server kann keine Programme mit Geheimnissen starten: Damit ein Agent ein Tool mit einer Anmeldeinformation ausführt, verwenden Sie `devo secret run`. Siehe [Einem Agenten eine Anmeldeinformation geben, ohne sie offenzulegen](/cli/de/anleitungen/ai-agents/run-an-agent.md).

## Die Werkzeugliste anzeigen

Um zu sehen, welche Werkzeuge der Server bereitstellt, ohne ihn zu starten:

```bash
devo mcp catalog --json
```

Im JSON-Ergebnis haben die Werkzeuge, die der Server bereitstellen würde, `"visible": true`. Die Textausgabe zeigt nur die ersten 25. `devo mcp catalog` akzeptiert dieselben Einschränkungsoptionen wie `devo mcp`, sodass Sie eine Konfiguration in der Vorschau prüfen können, bevor Sie sie Ihrem Client geben. Eine Ausnahme: Die Vorschau markiert `RDM_resolve_secret_reference` immer als ausgeblendet, auch wenn `devo mcp` es bereitstellen würde. Siehe [Einschränken, was ein Agent tun kann](/cli/de/anleitungen/ai-agents/limit-tools.md#preview-your-configuration).

## Gut zu wissen

* **Der Hintergrundprozess startet von selbst.** Wenn der Server Ihren Workspace braucht, startet `devo mcp` den Hintergrundprozess von Devolutions CLI, bevor er dem Client antwortet, sofern Sie den Server nicht mit `--daemon require`, `--daemon never` oder `--no-daemon-autostart` starten. Wenn Werkzeuge melden, dass der Prozess nicht verfügbar ist, siehe [Der Hintergrundprozess startet nicht](/cli/de/hilfe/troubleshooting/daemon-wont-start.md).
* **Der Workspace der Sitzung kann sich ändern.** Wenn Sie den Server nicht mit `--read-only` starten, kann das Modell den Workspace für den Rest der Sitzung wechseln, unter dem lokalen Profil und den Kontexten, die Sie gespeichert haben. Die Tools, die ihn wechseln, sind nicht schreibgeschützt, daher blendet `--read-only` sie aus.
* **Der Server läuft als Sie.** Jedes Programm, das `devo mcp` unter Ihrem Benutzerkonto starten kann, erhält denselben Zugriff auf Ihre Tresore.

## Weiter

* [Limit what an agent can do](/cli/de/anleitungen/ai-agents/limit-tools.md)
* [Give an agent a credential without exposing it](/cli/de/anleitungen/ai-agents/run-an-agent.md)
* [What stays hidden, and what doesn't](/cli/de/anleitungen/understand/security-model.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/cli/de/anleitungen/ai-agents/connect-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.