---
title: "OpenCode verbinden"
description: "Den Bauhow MCP-Server global oder pro Projekt in OpenCode einrichten."
---

OpenCode unterstützt entfernte MCP-Server und führt den OAuth-Ablauf automatisch aus. Sie benötigen keine feste Client-ID und kein Client-Secret.

## Konfiguration

Legen Sie den Eintrag entweder global in `~/.config/opencode/opencode.json` oder projektbezogen in der `opencode.json` im Projektstamm an:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bauhow": {
      "type": "remote",
      "url": "https://mcp.bauhow.com/mcp",
      "enabled": true
    }
  }
}
```

Die URL finden Sie auch unter **Bauhow → Einstellungen → Workspace → MCP-Server**. Der MCP-Server muss dort für Ihren Workspace aktiviert sein.

## Autorisieren

Starten Sie die Anmeldung im Terminal:

```bash
opencode mcp auth bauhow
```

OpenCode öffnet den Browser. Melden Sie sich bei Bauhow an, wählen Sie auf der Seite **Zugriff erlauben** den Workspace und bestätigen Sie. OpenCode speichert die Zugangsdaten lokal und erneuert sie automatisch.

Prüfen Sie anschließend den Status:

```bash
opencode mcp auth list
```

## Verwenden

```text
Nutze den MCP-Server "bauhow". Zeige für das Projekt <PROJEKT-ID> den
Status aller Planungsmodule. Ändere keine Daten.
```

OpenCode stellt MCP-Werkzeuge zusammen mit seinen eingebauten Coding-Werkzeugen bereit. Nennen Sie `bauhow` im Prompt, wenn mehrere Server ähnliche Werkzeuge anbieten.

## Fehlerbehebung

```bash
opencode mcp debug bauhow
```

Der Befehl prüft Erreichbarkeit, OAuth-Metadaten und den gespeicherten Anmeldestatus. Mit `opencode mcp logout bauhow` entfernen Sie die lokalen Zugangsdaten und können die Verbindung neu autorisieren, zum Beispiel um einen anderen Workspace zu wählen.

:::info
Eine projektbezogene `opencode.json` kann von Teammitgliedern eingecheckt werden. Sie enthält nur die Server-URL, keine Zugangsdaten. Jede Person führt `opencode mcp auth bauhow` selbst aus und wählt dabei ihren Workspace.
:::

Quelle: [MCP servers in OpenCode](https://opencode.ai/docs/mcp-servers/)
