Einrichtungsanleitung für den MCP-Server
Der MCP-Server (Model Context Protocol) von ISO Mate ermöglicht es KI-Assistenten und IDE-Tools, die gesamte Plattform direkt zu verwalten. Mit 12 Tool-Providern für DevOps, QA, Aufgaben, Vorfälle, Compliance, Helpdesk, Notizen, benutzerdefinierte Objekte, Workflows, Kontakte und Abrechnung können Sie ISO Mate bedienen, ohne Ihre Entwicklungsumgebung zu verlassen.
Schritt 1: API-Token erstellen
- Navigieren Sie zu Profil > API-Tokens in der oberen Navigationsleiste.
- Klicken Sie auf Token erstellen.
- Geben Sie dem Token einen beschreibenden Namen (z.B. “IDE MCP Token”).
- Wählen Sie die Bereiche aus, die Ihr Tool benötigt. Bereiche sind nach Modul organisiert:
- issue.*, sprint.*, release.*, userstory.*, feature.* für DevOps
- testcase.*, testcycle.*, testenvironment.* für QA
- task.*, recurringtask.* für Aufgabenverwaltung
- incident.* für Vorfälle
- compliance.* für Compliance (Frameworks, Anforderungen, Kontrollen, Richtlinien, Verfahren, Nachweise, Bestätigungen)
- ticket.*, cannedresponse.* für Helpdesk
- note.*, notefolder.*, notetag.* für Notizen
- objecttype.*, entry.* für Benutzerdefinierte Objekte
- workflow.* für Workflows
- contact.* für Kontakte
- billing.view für Abrechnung (nur Lesen, standardmäßig von Token-Bereichen ausgeschlossen)
- Klicken Sie auf Speichern und kopieren Sie das Token. Es wird nicht erneut angezeigt.
Schritt 2: MCP-Client konfigurieren
Fügen Sie den ISO Mate MCP-Server zur Konfiguration Ihres Clients hinzu. Das genaue Format hängt von Ihrem Tool ab, aber Sie benötigen:
- Server-URL: Ihr ISO Mate MCP-API-Endpoint
- API-Token: Das Token, das Sie in Schritt 1 erstellt haben
Verfügbare Tool-Provider
Nach der Verbindung stehen die folgenden 12 Tool-Provider zur Verfügung. Jeder Provider verwendet ein Ressource/Operation-Muster (z.B. Ressource: “issues”, Operation: “create”).
1. DevOps
Verwalten Sie Ihren agilen Workflow: Issues (auflisten, abrufen, erstellen, aktualisieren, löschen, Kommentare hinzufügen/auflisten), Sprints (CRUD, starten, schließen), Releases (CRUD, veröffentlichen, archivieren), User Stories (CRUD) und Features (CRUD).
2. Qualitätssicherung
Führen Sie Ihren QA-Prozess aus: Testfälle (CRUD mit Ordner-, Prioritäts- und Typfiltern), Testzyklen (CRUD, schließen), Testausführungen (auflisten, abrufen, starten, abschließen, mit Begründung blockieren) und Testumgebungen (CRUD).
3. Aufgabenverwaltung
Verwalten Sie Arbeitselemente: Aufgaben (CRUD, Erledigung umschalten) mit Priorität, Fälligkeitsdaten und Zugewiesenen. Wiederkehrende Aufgaben (CRUD) mit täglichen, wöchentlichen, monatlichen, jährlichen oder benutzerdefinierten Wiederholungsmustern.
4. Vorfallmanagement
Verfolgen Sie Vorfälle durch ihren Lebenszyklus: CRUD-Operationen, Statusübergänge (Offen, Untersuchung, Eingedämmt, Gelöst, Geschlossen), Benutzerzuweisung mit Rollen, Aufgaben- und Notizenverknüpfung sowie Audit-Protokoll-Einsicht.
5. Compliance
Verwalten Sie Ihr Compliance-Programm: Frameworks (CRUD, archivieren), Anforderungen (CRUD mit Statusverfolgung), Kontrollen (CRUD, Anforderungen/Richtlinien zuordnen, Verfahren verknüpfen), Richtlinien (CRUD, veröffentlichen, versionieren, zur Bestätigung zuweisen), Verfahren (CRUD, veröffentlichen, versionieren, aktiv umschalten), Nachweise (auflisten, abrufen, aktualisieren, löschen, mit Kontrollen verknüpfen) und Bestätigungen (auflisten, Fortschritt).
6. Helpdesk
Bearbeiten Sie Support: Tickets (CRUD, Antworten/Notizen hinzufügen, Antworten auflisten, zusammenführen, Beobachter verwalten, Entitäten verknüpfen, Tags verwalten) und vorgefertigte Antworten (CRUD, Kategorien auflisten).
7. Notizen
Organisieren Sie Dokumentation: Notizen (CRUD, zwischen Ordnern verschieben), Notizordner (CRUD für hierarchische Organisation) und Notiz-Tags (CRUD für Kategorisierung).
8. Benutzerdefinierte Objekte
Arbeiten Sie mit benutzerdefinierten Daten: Objekttypen (CRUD für Schema-Definitionen) und Einträge (CRUD mit automatischer Schema-Validierung).
9. Workflow-Automatisierung
Erstellen Sie Automatisierungen: Workflows (CRUD, aktiviert/deaktiviert umschalten), Workflow-Ausführungen (auflisten, abrufen, Statistiken) und Workflow-Konfiguration (verfügbare Auslöse-Entitäten, Ereignisse, Aktionstypen und Feldschemata entdecken).
10. Kontakte
Verwalten Sie Ihr Kontaktverzeichnis: vollständiges CRUD mit Suche nach E-Mail, Name oder Unternehmen.
11. Abrechnung (Nur Lesen)
Abonnementstatus, Plandetails, Testinformationen und Rechnungsverlauf einsehen. Abrechnungsverwaltungs-Bereiche sind konstruktionsbedingt aus Sicherheitsgründen von API-Tokens ausgeschlossen.
12. Legacy-Issue-Tools
Eigenständige Issue-Tools (list_issues, get_issue, create_issue, update_issue, delete_issue, add_issue_comment, list_issue_comments) sind ebenfalls für die Abwärtskompatibilität mit älteren MCP-Clients verfügbar.
Verwendung von Projektschlüsseln
Sie können Issues über ihren Projektschlüssel statt UUID referenzieren. Übergeben Sie beispielsweise BUG-7 an die Get-Operation, um diesen Bug direkt abzurufen. Verwenden Sie den project_key-Filter, um alle Issues mit einem bestimmten Präfix zu finden.
Sicherheitshinweise
- Jedes Token ist auf ein einzelnes Konto beschränkt. Daten anderer Konten sind niemals zugänglich.
- Gewähren Sie nur die Bereiche, die Ihr Tool benötigt (Prinzip der geringsten Berechtigung).
- Abrechnungsverwaltungs-Bereiche sind konstruktionsbedingt von API-Tokens ausgeschlossen.
- Widerrufen Sie Tokens sofort, wenn sie kompromittiert wurden.