Verbindung zu mittwald MCP herstellen
Willkommen! Diese Anleitung hilft dir, die Authentifizierung für mittwald MCP mit deinem bevorzugten Agentic Coding Tool einzurichten.
Warum Authentifizierung erforderlich ist: mittwald MCP erfordert authentifizierten Zugriff auf deine mittwald-Ressourcen. OAuth 2.1 ist die empfohlene Methode für interaktive Nutzung, und API-Tokens sind für Headless/CI-Workflows verfügbar.
Wähle dein Tool
mittwald MCP funktioniert mit 6 beliebten KI-Tools. Wähle dasjenige, das du verwendest:
Claude Desktop
Am besten für: Nutzer der Claude Desktop App oder des Claude.ai Web-Interface
- Typ: Desktop App / Web App
- OAuth-Muster: Browser-basiert (Connector-Einstellungen UI)
- Setup-Zeit: ~5 Minuten
- Komplexität: ⭐ (Sehr einfach - nur Einstellungs-UI)
ChatGPT
Am besten für: Nutzer von ChatGPT Plus, Team, Enterprise oder Education
- Typ: Web App / Mobile App
- OAuth-Muster: Browser-basiert (Connector-Einstellungen UI)
- Setup-Zeit: ~5 Minuten
- Komplexität: ⭐ (Sehr einfach - nur Einstellungs-UI)
Claude Code
Am besten für: Entwickler, die Anthropics Claude Code CLI verwenden
- Typ: Command-line Interface
- OAuth-Muster: Browser-basiert (Standard-Web-Flow)
- Setup-Zeit: ~10 Minuten
- Komplexität: ⭐⭐ (Einfach - unkomplizierte CLI-Befehle)
GitHub Copilot
Am besten für: Entwickler, die GitHub Copilot in VS Code, Visual Studio, JetBrains IDEs oder Xcode verwenden
- Typ: IDE Extension (mehrere Plattformen)
- OAuth-Muster: IDE-basiert (Dynamic Client Registration)
- Setup-Zeit: ~10 Minuten
- Komplexität: ⭐⭐ (Einfach - IDE-Einstellungen-basiert)
Cursor
Am besten für: Entwickler, die Cursor IDE verwenden (VS Code Fork mit KI-Features)
- Typ: IDE (Desktop Application)
- OAuth-Muster: IDE-basiert (Konfigurationsdatei oder Einstellungs-UI)
- Setup-Zeit: ~10 Minuten
- Komplexität: ⭐⭐ (Einfach - JSON-Konfiguration)
Codex CLI
Am besten für: Entwickler, die OpenAIs Codex CLI für terminalbasierte KI-Workflows verwenden
- Typ: Command-line Interface
- OAuth-Muster: RFC 8252 Loopback (Native App Pattern)
- Setup-Zeit: ~10 Minuten
- Komplexität: ⭐⭐ (Einfach - CLI-Befehle, Browser für Auth)
Zwei Authentifizierungsoptionen
Option 1: OAuth 2.1 (Empfohlen)
Am besten für: Interaktive Nutzung in IDEs, Desktop Apps und Web-Interfaces
Wie es funktioniert:
- Dein Tool leitet dich zur mittwald-Autorisierung um
- Du meldest dich mit deinem mittwald-Account an
- Du genehmigst Berechtigungen
- mittwald gibt ein Token an dein Tool zurück
- Dein Tool nutzt das Token automatisch
Vorteile:
- Sicher: Keine Passwörter in Konfigurationsdateien
- Bequem: Einmaliges Setup, automatische Token-Erneuerung
- Granulare Kontrolle: Widerrufe den Zugriff jederzeit
Nachteile:
- Erfordert Browser-Zugriff (nicht für Headless-Umgebungen geeignet)
- Benötigt interaktive Authentifizierung
| Tool | OAuth-Implementierung |
|---|---|
| Claude Desktop | Settings UI (Beta-Feature) |
| ChatGPT | Settings UI |
| Claude Code | Standard Web Flow |
| GitHub Copilot | Dynamic Client Registration (DCR) |
| Cursor | Settings UI oder JSON-Konfiguration |
| Codex CLI | RFC 8252 Loopback Flow |
Option 2: API Token
Am besten für: CI/CD-Pipelines, Headless-Server, automatisierte Skripte
Wie es funktioniert:
- Gehe zu mStudio → Benutzereinstellungen → API Tokens
- Generiere ein neues Token
- Speichere das Token sicher
- Füge das Token der Konfiguration deines Tools hinzu
Vorteile:
- Headless-kompatibel: Keine Browser-Interaktion erforderlich
- Skript-freundlich: Für Automatisierung geeignet
- Einfach: Keine OAuth-Flows
Nachteile:
- Manuelle Rotation erforderlich
- Token muss sicher gespeichert werden
- Keine automatische Erneuerung
Setup-Anleitung für jedes Tool:
| Tool | Unterstützt API Token |
|---|---|
| Claude Desktop | Nein (nur OAuth) |
| ChatGPT | Nein (nur OAuth) |
| Claude Code | Ja (über Umgebungsvariable) |
| GitHub Copilot | Ja (über Terraform-Variablen) |
| Cursor | Ja (über JSON-Konfiguration) |
| Codex CLI | Ja (über Konfigurationsdatei) |
Schrittweise Setup-Anleitungen
Wähle dein Tool oben aus, um detaillierte Setup-Anweisungen zu erhalten.
Jede Anleitung enthält:
- Voraussetzungen
- Schritt-für-Schritt-Anweisungen
- Beispielkonfigurationen
- Verifizierungs-Prompts
- Fehlerbehebung
Autorisierungsbereiche
Wenn du mittwald MCP mit OAuth verbindest, wirst du aufgefordert, Berechtigungen zu genehmigen. Der MCP-Server fordert:
| Bereich | Beschreibung | Zweck |
|---|---|---|
read:projects | Projekte anzeigen | Projekte auflisten, Details abrufen |
write:projects | Projekte erstellen/aktualisieren | Neue Projekte erstellen, Einstellungen ändern |
read:apps | Anwendungen anzeigen | Installierte Apps auflisten |
write:apps | Apps verwalten | Apps installieren/aktualisieren/entfernen |
read:databases | Datenbanken anzeigen | Datenbank-Verbindungsdetails abrufen |
write:databases | Datenbanken verwalten | Datenbanken erstellen/löschen |
read:containers | Container anzeigen | Container-Status abrufen |
write:containers | Container verwalten | Container starten/stoppen/erstellen |
read:backups | Backups anzeigen | Backup-Zeitpläne anzeigen |
write:backups | Backups verwalten | Backup-Richtlinien konfigurieren |
Sicherheit und Best Practices
OAuth-Best-Practices
✅ Empfohlen:
- Verwende OAuth für interaktive Tools (IDEs, Desktop Apps)
- Überprüfe die Berechtigungen, bevor du autorisierst
- Widerrufe den Zugriff für nicht genutzte Tools regelmäßig
❌ Vermeide:
- OAuth-Tokens mit anderen teilen
- Dieselbe OAuth-Sitzung auf mehreren Geräten verwenden
- Berechtigungen genehmigen, ohne sie zu lesen
API-Token-Best-Practices
✅ Empfohlen:
- Verwende Umgebungsvariablen oder Secret Manager
- Rotiere Tokens regelmäßig (alle 90 Tage)
- Erstelle separate Tokens für verschiedene Zwecke
- Setze Ablaufdaten für Tokens
❌ Vermeide:
- Tokens in Konfigurationsdateien hartcodieren
- Tokens in Versionskontrollsystemen committen
- Tokens in Logs oder Fehlermeldungen teilen
Nach der Verbindung
Sobald die Authentifizierung abgeschlossen ist:
- Teste die Verbindung: Verwende einen einfachen Prompt wie "List my mittwald projects"
- Probiere Tutorials aus: Sieh dir Tutorials für End-to-End-Workflows an
- Lies How-To Guides: Lerne spezifische Aufgaben in How-To Playbooks
Häufig gestellte Fragen
F: Kann ich mehrere Tools mit demselben mittwald-Account verbinden?
A: Ja. Jedes Tool erhält seine eigene OAuth-Sitzung oder du kannst separate API-Tokens verwenden.
F: Was passiert, wenn mein Token abläuft?
A: OAuth-Tokens werden automatisch erneuert. API-Tokens erfordern manuelle Erneuerung.
F: Kann ich den Zugriff für ein Tool widerrufen?
A: Ja. Um den Zugriff vollständig zu widerrufen, widerrufe zunächst die OAuth-Autorisierung für dieses Tool in mStudio (z. B. unter den verbundenen Apps oder API-Zugriff-Einstellungen deines Accounts). Dies macht die ausgegebenen Tokens sofort ungültig. Entferne anschließend die MCP-Server-Konfiguration aus deinem Tool, damit es keine Tokens mehr verwenden oder erneuern kann, um auf mittwald zuzugreifen.
F: Sind meine Daten sicher?
A: Ja. mittwald MCP verwendet branchenübliche OAuth 2.1 mit PKCE. Tokens sind verschlüsselt gespeichert.
F: Welche Pläne unterstützen mittwald MCP?
A: mittwald MCP ist für alle mittwald-Pläne verfügbar. Einige Tools (z. B. Claude Desktop) erfordern einen kostenpflichtigen Plan des Tool-Anbieters.
Weitere Ressourcen
Learn more: mittwald API Authentication - Offizielle Dokumentation zu API-Tokens und Authentifizierungsmethoden.