Zum Hauptinhalt springen

Erste Schritte mit GitHub Copilot

GitHub Copilot in VS Code kann sich mit mittwald MCP verbinden, sodass du mittwald-Tools direkt aus Copilot Chat ausführen kannst. Diese Anleitung zeigt dir, wie du OAuth (empfohlen) oder einen API-Schlüssel für Headless-Umgebungen einrichtest.

Voraussetzungen​

  • VS Code 1.99 oder neuer (erforderlich für OAuth-Unterstützung)
  • GitHub Copilot-Extension installiert
  • Ein mittwald-Account (zur Authentifizierung)
  • 10 Minuten zum Abschluss des Setups

Schritt 1: MCP-Konfiguration erstellen​

Erstelle eine projektspezifische Konfigurationsdatei unter .vscode/mcp.json. Wähle eine der folgenden Authentifizierungsmethoden.

Verwende OAuth für den sicheren browserbasierten Flow mit automatischer Token-Erneuerung.

{
  "servers": {
    "mittwald": {
      "type": "http",
      "url": "https://mcp.mittwald.de/mcp"
    }
  }
}

1.2 API-Schlüssel (Alternative)​

Verwende diese Option für Headless-Server oder CI-Umgebungen, in denen OAuth nicht praktikabel ist. Input-Variablen halten den Token aus der Versionskontrolle heraus.

{
  "inputs": [
    {
      "id": "mittwald_token",
      "type": "promptString",
      "description": "Enter your mittwald API token",
      "password": true
    }
  ],
  "servers": {
    "mittwald": {
      "type": "http",
      "url": "https://mcp.mittwald.de/mcp",
      "headers": {
        "Authorization": "Bearer ${input:mittwald_token}"
      }
    }
  }
}

Um einen Token zu erstellen, gehe zu mStudio → Benutzereinstellungen → API-Tokens, generiere einen Token und speichere ihn sicher.

Schritt 2: MCP-Server starten​

Öffne .vscode/mcp.json in VS Code. Du solltest einen Start-CodeLens über der Server-Definition sehen. Klicke auf Start, um den Server zu aktivieren.

Falls du keine CodeLens-Buttons siehst, starte VS Code neu und bestätige, dass deine Version 1.99+ ist.

Schritt 3: Authentifizieren​

3.1 OAuth​

Klicke auf den Auth-CodeLens über der Server-Definition:

  1. Ein Browserfenster öffnet sich für die mittwald-Autorisierung
  2. Überprüfe die angeforderten Berechtigungen
  3. Klicke auf Autorisieren

Enterprise-Benutzer müssen möglicherweise ihren Admin bitten, die MCP servers in Copilot-Richtlinie zu aktivieren, bevor Auth erscheint.

3.2 API-Schlüssel​

Wenn du die API-Schlüssel-Konfiguration gewählt hast, fordert VS Code beim Start des Servers den Token an. Füge den Token ein, wenn du dazu aufgefordert wirst.

Schritt 4: Verbindung verifizieren​

Öffne Copilot Chat und führe einen einfachen Test aus:

Use mittwald MCP to list my projects

Du solltest eine Liste von Projekten sehen, die von mittwald MCP zurückgegeben werden.

✅ Erfolg! mittwald MCP ist jetzt mit GitHub Copilot verbunden.

Häufige Aufgaben mit mittwald MCP​

Sobald du authentifiziert bist, kannst du Copilot Chat-Prompts wie diese verwenden:

Deine Projekte auflisten​

Use mittwald MCP to show all my projects

App-Informationen abrufen​

Show apps in my project [project-id]

Datenbankdetails​

Get database connection info for [db-id]

Backup-Status​

Check backup schedules for project [project-id]

Support-Tickets​

List open support conversations for my account

Fehlerbehebung​

Fehler: "No CodeLens Buttons Appearing"​

Symptom: Keine Start- oder Auth-Buttons erscheinen über der Server-Konfiguration.

Ursache: VS Code erkennt die MCP-Konfiguration nicht oder CodeLens ist deaktiviert.

Lösung:

  1. Bestätige, dass der Dateipfad .vscode/mcp.json ist
  2. Starte VS Code neu
  3. Stelle sicher, dass du VS Code 1.99+ verwendest (code --version)

Fehler: "Auth Button Not Working"​

Symptom: Ein Klick auf Auth bewirkt nichts oder schlägt sofort fehl.

Ursache: VS Code ist zu alt für MCP OAuth oder die Richtlinie ist deaktiviert.

Lösung:

  1. Update VS Code auf 1.99 oder neuer
  2. Falls du Copilot Enterprise verwendest, bitte deinen Admin, MCP servers in Copilot zu aktivieren

Fehler: "Configuration Error"​

Symptom: VS Code zeigt JSON-Parse-Fehler oder der MCP-Server lädt nicht.

Ursache: Ungültiges JSON in .vscode/mcp.json.

Lösung:

  1. Validiere die JSON-Syntax
  2. Entferne abschließende Kommas
  3. Vergleiche mit dem Beispiel in dieser Anleitung

Fehler: "Server Connection Failed"​

Symptom: MCP-Server startet nicht oder läuft in ein Timeout.

Ursache: Netzwerkprobleme, Firewall-Regeln oder falsche URL.

Lösung:

  1. Bestätige, dass die URL https://mcp.mittwald.de/mcp ist
  2. Überprüfe ausgehenden Netzwerkzugriff
  3. Versuche es von einem anderen Netzwerk

Fehler: "Token Not Accepted"​

Symptom: Anfragen schlagen mit 401 Unauthorized fehl.

Ursache: Token ist ungültig, abgelaufen oder widerrufen.

Lösung:

  1. Erstelle einen neuen API-Token in mStudio
  2. Starte den MCP-Server neu und gib den neuen Token ein

Fehler: "MCP Policy Disabled"​

Symptom: MCP-Server sind in Copilot Enterprise blockiert.

Ursache: Organisationsrichtlinie deaktiviert MCP-Server.

Lösung:

  1. Bitte deinen Admin, MCP servers in Copilot zu aktivieren
  2. Starte VS Code nach der Richtlinienänderung neu

FAQ​

F: Welche VS Code-Version benötige ich?​

A: Verwende VS Code 1.99 oder neuer für OAuth-Unterstützung.

F: Funktioniert das mit VS Code Insiders?​

A: Ja, solange dein Insiders-Build 1.99+ ist.

F: Wird mein Token sicher gespeichert?​

A: OAuth-Tokens werden von VS Code gespeichert. API-Tokens werden über Input-Variablen eingegeben und nicht in der Konfigurationsdatei gespeichert.

F: Wie aktualisiere ich die MCP-Konfiguration?​

A: Bearbeite .vscode/mcp.json und starte den MCP-Server über den Start-CodeLens neu.

F: Kann ich das mit GitHub Copilot Enterprise verwenden?​

A: Ja, aber deine Organisation muss die MCP servers in Copilot-Richtlinie aktivieren.

F: Wie widerrufe ich MCP-Zugriff?​

A: Entferne den Server aus .vscode/mcp.json und widerrufe Tokens in mStudio.

F: Kann ich meine mcp.json mit meinem Team teilen?​

A: Ja, aber speichere keine API-Tokens in der Datei. Verwende OAuth oder Input-Variablen.

Nächste Schritte​

Offizielle Dokumentation​

Diese Anleitung basiert auf den offiziellen GitHub Copilot-Fähigkeiten:

Brauchst du noch Hilfe?​