> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/overview/de/mit-ki-tools-arbeiten/connect-via-mcp.md).

# Über MCP verbinden

VergeOS Docs veröffentlicht einen gehosteten **MCP-(Model Context Protocol-)Server**. Verbinden Sie ihn mit einem KI-Assistenten — Claude, Cursor, VS Code Copilot, Codex und anderen — und dieser Assistent kann diese Dokumentation direkt durchsuchen und lesen, während er Ihnen hilft, statt zu raten oder sich auf veraltete Trainingsdaten zu stützen.

{% hint style="info" %}
Sie benötigen einen Client, der **entfernte MCP-Server über HTTP unterstützt**. Der Server ist öffentlich, daher ist kein API-Schlüssel oder Anmelden erforderlich.
{% endhint %}

## Der Server

|                       |                                      |
| --------------------- | ------------------------------------ |
| **URL**               | `https://docs.verge.io/~gitbook/mcp` |
| **Transport**         | Streamable HTTP                      |
| **Authentifizierung** | Keine (öffentlich)                   |

## Server hinzufügen

{% tabs %}
{% tab title="Claude Code" %}
Führen Sie den CLI-Befehl aus, um ihn für Ihr Benutzerkonto hinzuzufügen:

```bash
claude mcp add vergeos-docs --scope user --transport http https://docs.verge.io/~gitbook/mcp
```

Bestätigen Sie dann, dass die Verbindung hergestellt wurde:

```bash
claude mcp list
```

{% endtab %}

{% tab title="Claude Desktop" %}

1. Öffnen **Einstellungen → Connectors**.
2. Wählen Sie **Benutzerdefinierten Connector hinzufügen**.
3. Benennen Sie ihn `VergeOS Docs` und legen Sie die URL fest auf:

   ```
   https://docs.verge.io/~gitbook/mcp
   ```
4. Speichern Sie und aktivieren Sie dann den Connector in einem neuen Chat.
   {% endtab %}

{% tab title="Cursor" %}
Fügen Sie den Server hinzu zu `~/.cursor/mcp.json` (global) oder `.cursor/mcp.json` (pro Projekt):

```json
{
  "mcpServers": {
    "vergeos-docs": {
      "url": "https://docs.verge.io/~gitbook/mcp"
    }
  }
}
```

{% endtab %}

{% tab title="VS Code" %}
Verwenden Sie den Ein-Klick-Installationslink:

```
vscode:mcp/install?%7B%22name%22%3A%22VergeOS%20Docs%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.verge.io%2F~gitbook%2Fmcp%22%7D
```

Oder fügen Sie ihn manuell zu `.vscode/mcp.json`:

```json
{
  "servers": {
    "VergeOS Docs": {
      "url": "https://docs.verge.io/~gitbook/mcp"
    }
  }
}
```

{% endtab %}

{% tab title="Codex" %}
Führen Sie den CLI-Befehl aus:

```bash
codex mcp add vergeos-docs --url https://docs.verge.io/~gitbook/mcp
```

{% endtab %}
{% endtabs %}

## Was Sie erhalten

Sobald die Verbindung hergestellt ist, erhält der Assistent zwei Tools:

* **`searchDocumentation`** — durchsucht alle VergeOS-Dokumente und gibt passende Inhalte mit direkten Seitenlinks zurück.
* **`getPage`** — ruft das vollständige Markdown einer bestimmten Dokumentationsseite ab.

## Probieren Sie es aus

Stellen Sie Ihrem Assistenten etwas, das aus der Dokumentation gezogen werden sollte, zum Beispiel:

{% hint style="success" %}

* "Durchsuche die VergeOS-Dokumentation nach der Konfiguration einer Site-Synchronisierung."
* "Fasse anhand der VergeOS-Dokumentation die Schritte zusammen, um eine VM von VMware zu migrieren."
* "Was sagt die VergeOS-Dokumentation über die Dimensionierung von Knoten für eine Edge-Bereitstellung?"
  {% endhint %}

Wenn die Tools verfügbar sind und die Antworten auf VergeOS-Dokumentationsseiten verweisen, funktioniert die Verbindung.

## Gehen Sie mit Agent-Fähigkeiten weiter

Der MCP-Server gewährt einem Assistenten Lesezugriff auf die Dokumentation. Wenn Sie **Claude Code** oder **Codex**, die [VergeOS-Agent-Fähigkeiten](/overview/de/mit-ki-tools-arbeiten/agent-skills.md) Paket fügt obenauf aufgabenorientierte Workflows hinzu — Fehlerbehebung, Diagnose, Schulung und Infrastrukturverwaltung über die `vrg` CLI — und bündelt denselben Docs-MCP-Server für Sie.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/overview/de/mit-ki-tools-arbeiten/connect-via-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.