MCP-Integration

Was Sie lernen werden

Überblick über die Model Context Protocol-Integration (MCP) in Verdent for VS Code, einschließlich Einrichtung, Konfiguration und Erweiterbarkeitsoptionen.

Was ist MCP (Model Context Protocol)?

Model Context Protocol (MCP) ist ein Integrationssystem, das die Möglichkeiten von Verdent erweitert, indem es eine Verbindung zu externen Werkzeugen, Datenquellen und Diensten herstellt.

Grundkonzept: MCP ermöglicht es Verdent, mit Systemen zu interagieren, die über den integrierten Werkzeugsatz hinausgehen, und erlaubt eine nahtlose Integration mit:

• Externen APIs und Webdiensten
• Datenbanksystemen
• Cloud-Plattformen (AWS, Azure, GCP)
• Projektmanagement-Werkzeugen
• CI/CD-Pipelines
• Benutzerdefinierten internen Werkzeugen

Architektur: MCP-Server fungieren als Brücken zwischen Verdent und externen Systemen. Jeder MCP-Server stellt bestimmte Fähigkeiten bereit, die Verdent während Coding-Sitzungen aufrufen kann, ähnlich wie bei integrierten Werkzeugen wie file_read oder bash.

Speicherung der Konfiguration: Die Serverkonfigurationen für MCP werden in ~/.verdent/mcp.json gespeichert und über das Einstellungsmenü verwaltet.

Vorteile der MCP-Integration

Erweiterte Möglichkeiten

Zugriff auf externe Systeme: Verbinden Sie Verdent mit Werkzeugen und Diensten, die über die integrierten Funktionen nicht verfügbar sind. Fragen Sie Datenbanken ab, interagieren Sie mit Cloud-Diensten oder integrieren Sie projektspezifische APIs, ohne Ihren Coding-Workflow zu verlassen.

Entwicklung benutzerdefinierter Werkzeuge: Erstellen Sie MCP-Server, die auf die individuellen Anforderungen Ihres Projekts zugeschnitten sind. Entwickeln Sie spezialisierte Integrationen für interne Werkzeuge, proprietäre APIs oder domänenspezifische Systeme.

Interoperabilität

Ökosystem nutzen: Nutzen Sie das wachsende MCP-Ökosystem. Von der Community entwickelte MCP-Server bieten fertige Integrationen für gängige Werkzeuge und Dienste.

Standardisiertes Protokoll: MCP bietet eine einheitliche Schnittstelle für die Werkzeugintegration und stellt sicher, dass neue Funktionen sich reibungslos in das bestehende Werkzeugsystem von Verdent einfügen.

Workflow-Automatisierung

Nahtlose Integration: MCP-Server werden Teil des Werkzeugsatzes von Verdent. Der Agent nutzt MCP-Werkzeuge automatisch, wenn es angebracht ist, oder Sie können sie für bestimmte Aufgaben explizit aufrufen.

Kontextbewusste Vorgänge: MCP-Integrationen verstehen den Kontext Ihrer Codebasis und ermöglichen intelligente Interaktionen mit externen Systemen basierend auf dem aktuellen Entwicklungsstand.

Einrichten von MCP-Servern

Konfigurationsprozess

Zugriff auf MCP-Einstellungen:

1. Öffnen Sie das Einstellungsmenü in Verdent
2. Navigieren Sie zum Abschnitt MCP-Server
3. Zeigen Sie die Konfiguration von ~/.verdent/mcp.json an oder ändern Sie sie

Konfigurationsdatei: MCP-Server werden über die Datei ~/.verdent/mcp.json konfiguriert, die Serververbindungen, Authentifizierung und Integrationsparameter definiert.

Konfigurationsverwaltung

Server hinzufügen: Konfigurieren Sie neue MCP-Server, indem Sie Einträge mit Verbindungsdetails und Authentifizierungsdaten zu mcp.json hinzufügen.

Mehrere Server: Verdent unterstützt mehrere gleichzeitig aktive MCP-Server und ermöglicht so die Integration mehrerer externer Systeme gleichzeitig.

Verbindungen testen: Überprüfen Sie die Konfigurationen der MCP-Server, um erfolgreiche Verbindungen sicherzustellen, bevor Sie sie in Entwicklungs-Workflows verwenden.

MCP-Plugins und Erweiterungen

Verfügbare Plugins

MCP-Plugins bieten fertige Integrationen für gängige Werkzeuge und Dienste.

Erwartete Plugin-Kategorien:

• Datenbankintegrationen: Abfragewerkzeuge für PostgreSQL, MySQL, MongoDB
• Cloud-Dienste: API-Interaktionen mit AWS, Azure, GCP
• Entwicklerwerkzeuge: Integrationen mit GitHub, GitLab, Jira, Linear
• CI/CD-Plattformen: Jenkins, GitHub Actions, CircleCI
• Monitoring-Dienste: Datadog, New Relic, Sentry
• Kommunikation: Benachrichtigungen für Slack, Discord, Microsoft Teams

Plugin-Installation

Installationsmethoden: Plugins werden über die Einstellungsoberfläche von MCP installiert und konfiguriert, wobei in der Regel Folgendes erforderlich ist:

• Plugin-Kennung oder -Quelle
• Konfigurationsparameter
• Authentifizierungsdaten (falls zutreffend)

Abhängigkeitsverwaltung: MCP-Plugins können Abhängigkeiten von externen Diensten oder Bibliotheken haben. Installationsprozesse übernehmen die Abhängigkeitsauflösung nach Möglichkeit automatisch.

Entwicklung benutzerdefinierter MCP-Server

Erstellen benutzerdefinierter Server

Fortgeschrittene Benutzer können benutzerdefinierte MCP-Server erstellen, um proprietäre Werkzeuge oder domänenspezifische Systeme zu integrieren.

Entwicklungsansatz: Benutzerdefinierte MCP-Server implementieren die Protokollspezifikation von MCP und stellen Werkzeugfunktionen bereit, die Verdent aufrufen kann.

Anwendungsfälle für benutzerdefinierte Server:

• Integration interner APIs: Verbindung zu unternehmensspezifischen APIs und Diensten
• Brücken zu Legacy-Systemen: Ermöglicht Verdent die Interaktion mit veralteter Infrastruktur
• Spezialisierte Datenquellen: Zugriff auf proprietäre Datenbanken oder Data Warehouses
• Workflow-Automatisierung: Auslösen benutzerdefinierter Build-, Deployment- oder Testpipelines

Integrationsmuster

Konfiguration auf Arbeitsbereichsebene: MCP-Server können auf Arbeitsbereichsebene für projektspezifische Integrationen konfiguriert werden, sodass Teams MCP-Konfigurationen über die Versionskontrolle teilen können.

Werkzeug-Interoperabilität: Von MCP bereitgestellte Werkzeuge lassen sich nahtlos mit den integrierten Werkzeugen von Verdent (file_read, bash, spawn_subagent) kombinieren, was komplexe Workflows mit mehreren Werkzeugtypen ermöglicht.

MCP-Workflow-Beispiele

Datenbankabfrage-Integration

Szenario: Abfrage der Produktionsdatenbank zur Fehlersuche bei Datenproblemen.

MCP-Ansatz:

User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
        Results: 3 orders found for customer 12345
        [Displays formatted results]

Der MCP-Datenbankserver übernimmt Authentifizierung, Abfragevalidierung und Ergebnisformatierung.

Cloud-Dienst-Interaktion

Szenario: Überprüfung der AWS-Lambda-Funktionsprotokolle auf Fehler.

MCP-Ansatz:

User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
        [Retrieves CloudWatch logs for specified function]
        [Filters for ERROR level entries]
        [Presents formatted error summaries]

Der MCP-AWS-Server verwaltet Authentifizierung, API-Aufrufe und Protokollanalyse.

CI/CD-Pipeline-Überwachung

Szenario: Überprüfung des Build-Status vor der Bereitstellung von Änderungen.

MCP-Ansatz:

User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
        Build #245: ✓ Passed (2 minutes ago)
        All tests passed, ready for deployment

Der MCP-CI/CD-Server verfolgt den Pipeline-Status und liefert Echtzeit-Feedback.

Sicherheitsaspekte

Authentifizierung und Autorisierung

Verwaltung von Zugangsdaten: MCP-Server übernehmen die Authentifizierung bei externen Diensten. Zugangsdaten werden sicher in der Konfiguration von MCP gespeichert und niemals im Chat-Verlauf oder im Code offengelegt.

Berechtigungsumfang: Konfigurieren Sie MCP-Server mit den minimal notwendigen Berechtigungen. Verwenden Sie, wo möglich, einen reinen Lesezugriff und schränken Sie destruktive Vorgänge ein.

Sichere Vorgänge

Überprüfung von Befehlen: Vorgänge, die MCP-Werkzeuge betreffen, können vor der Ausführung in Manual Accept Mode überprüft werden, was Transparenz und Kontrolle bietet.

Audit-Protokollierung: Serveroperationen von MCP erscheinen im Chat-Verlauf von Verdent und erzeugen so eine Nachverfolgung der Interaktionen mit externen Systemen.

Fehlerbehebung bei der MCP-Integration

Häufige Probleme

Verbindungsfehler:

• Überprüfen Sie die Netzwerkverbindung zum MCP-Server
• Prüfen Sie die Authentifizierungsdaten in mcp.json
• Stellen Sie sicher, dass der MCP-Server läuft und erreichbar ist
• Validieren Sie die Syntax der Konfigurationsdatei

Berechtigungsfehler:

• Bestätigen Sie, dass API-Schlüssel oder Zugangsdaten die erforderlichen Berechtigungen besitzen
• Überprüfen Sie Dienstkontingente oder Ratenbegrenzungen
• Stellen Sie sicher, dass Firewall-Regeln MCP-Datenverkehr zulassen

Probleme beim Werkzeugaufruf:

• Stellen Sie sicher, dass der MCP-Server die erwarteten Werkzeuge korrekt bereitstellt
• Prüfen Sie, ob die Werkzeugparameterformate den Erwartungen des Servers entsprechen
• Überprüfen Sie die Serverprotokolle von MCP auf Fehlerdetails

Hilfe erhalten

Support-Kanäle:

• Verdent-Support: support@verdent.ai
• Protokolldokumentation zu MCP
• Verdent-Discord-Community für Echtzeit-Support

Diagnoseinformationen: Geben Sie bei der Meldung von MCP-Problemen Folgendes an:

• Typ und Version des MCP-Servers
• Konfigurationsdetails (ohne Zugangsdaten)
• Fehlermeldungen aus dem Chat-Verlauf
• Protokolle des MCP-Servers (falls zugänglich)

Dokumentationsressourcen zu MCP

Offizielle Dokumentation

In Kürze verfügbar:

• Schrittweise Einrichtungsanleitungen für MCP-Server
• Anleitungen zur Plugin-Installation und -Konfiguration
• Tutorials zur Entwicklung benutzerdefinierter Server
• Best Practices für die Integration von MCP
• Leistungsoptimierung für MCP-Workflows

Übergangsressourcen

Aktuelle Informationen zu MCP:

• Protokollspezifikation von MCP (extern)
• Von der Community entwickelte MCP-Server und Beispiele
• GitHub-Repositories des MCP-Ökosystems

Kontakt für Details: Für sofortige Unterstützung bei der Integration von MCP wenden Sie sich mit Ihrem spezifischen Anwendungsfall und Ihren Integrationsanforderungen an support@verdent.ai.

Siehe auch