In 15 Minuten: Proxy Gateway mit OpenCode verbinden

Diese Anleitung zeigt dir, wie du deine Mycelis-Modelle und Agenten als Provider in OpenCode einrichtest und direkt im Coding-Workflow nutzen kannst.

Voraussetzungen

• Mindestens ein Modell deployed — falls noch nicht geschehen: In 5 Minuten: Dein erstes Modell deployen
• Optional: Ein konfigurierter Agent — falls du einen Agenten statt eines rohen Deployments verwenden möchtest: In 10 Minuten: Deinen ersten Agent bauen

Der gleiche Ansatz funktioniert grundsätzlich auch für andere OpenAI-kompatible Clients wie OpenClaw, LibreChat, Lobe Chat, Kilo Code und ähnliche. Dieser Guide fokussiert sich auf OpenCode.

Da Mycelis aktuell noch nicht nativ in OpenCode integriert ist (wir arbeiten daran), ist ein kleines manuelles Setup nötig — das erledigen wir in wenigen Schritten.

---

Schritt 1 — API Key erstellen

Navigiere in deinem Dashboard zu API Keys in der linken Navigation.

Klicke auf API Key erstellen und vergib einen Namen (z. B. OpenCode). Optional kannst du ein Ablaufdatum festlegen.

Nach der Erstellung wird dir der API Key einmalig angezeigt — kopiere ihn sofort und speichere ihn sicher. Aus Sicherheitsgründen kann er danach nicht erneut eingesehen werden.

Wichtig: Behandle deinen API Key wie ein Passwort. Teile ihn nicht und lege ihn nicht in öffentlichen Repositories ab.

Auf der API Keys-Seite findest du ebenfalls die URLs, die du für die Konfiguration benötigst:

• Gateway Endpoint — die Basis-URL für das Proxy Gateway (wird in opencode.json eingetragen)
• MCP Hub Endpoint — die URL für den MCP Hub (wird für MCP-Tool-Integrationen verwendet)

Derselbe API Key gilt für beide Endpunkte.

---

Schritt 2 — OpenCode installieren

Falls OpenCode noch nicht installiert ist, folge der offiziellen Installationsanleitung: opencode.ai/docs

---

Schritt 3 — opencode.json konfigurieren

Öffne (oder erstelle, falls noch nicht vorhanden) die Datei opencode.json an folgendem Speicherort:

• macOS / Linux: ~/.config/opencode/opencode.json
• Windows: C:\Users\<Benutzername>\AppData\Roaming\opencode\opencode.json

Füge folgenden Provider-Block ein — ersetze dabei die Modell-Slugs durch die tatsächlichen Slugs aus deinem Mycelis-Workspace:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "mycelis": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://app.mycelis.ai/api/proxy/v1"
      },
      "models": {
        "mein-agent": {
          "name": "mein-agent"
        },
        "zweites-modell": {
          "name": "zweites-modell"
        }
      }
    }
  }
}

Wichtige Hinweise zur Konfiguration:

• mycelis ist der Name des Providers — du kannst ihn beliebig umbenennen, musst ihn aber konsistent in auth.json verwenden
• baseURL — den genauen Wert findest du auf der API Keys-Seite unter Gateway Endpoint
• Model-Schlüssel und name müssen exakt dem Slug des Agents oder Modells in Mycelis entsprechen. Der Slug eines Agents ist in den Agent-Einstellungen unter General → Slug (API Model-ID) zu finden

Du kannst beliebig viele Modelle und Agenten unter models eintragen.

---

Schritt 4 — API Key in auth.json hinterlegen

Der API Key wird nicht in der opencode.json gespeichert, sondern in einer separaten auth.json. Öffne oder erstelle diese Datei an folgendem Ort:

• macOS / Linux: ~/.local/share/opencode/auth.json
• Windows: C:\Users\<Benutzername>\AppData\Local\opencode\auth.json

Trage den Provider-Namen und deinen API Key wie folgt ein:

{
  "mycelis": {
    "type": "api",
    "key": "pat_..."
  }
}

Ersetze pat_... durch den API Key, den du in Schritt 1 kopiert hast. Der Property-Key (mycelis) muss mit dem Provider-Namen in deiner opencode.json übereinstimmen.

---

Schritt 5 — Mycelis in OpenCode verwenden

OpenCode ist nun konfiguriert. Starte OpenCode in deinem Projektverzeichnis und wähle den Provider aus:

• /providers — zeigt alle konfigurierten Provider an; wähle mycelis aus
• /models — zeigt die hinterlegten Modelle des aktiven Providers an; wähle das gewünschte Modell oder den gewünschten Agenten

Ab sofort werden alle Anfragen über das Mycelis Proxy Gateway geroutet.

---

Das war's!

Du hast den Mycelis Proxy erfolgreich in OpenCode eingebunden. Jede Anfrage aus OpenCode läuft jetzt über dein konfiguriertes Deployment oder deinen Agenten — inklusive System-Prompt, Knowledge Bases und MCP Tools, falls du einen Agenten verwendest.

Nächste Schritte:

• Ersten Agent bauen — Routing, Knowledge Bases und MCP Tools konfigurieren
• MCP Tools — Externe APIs direkt im Modellkontext nutzen
• API-Referenz — Alle verfügbaren API-Parameter