Einrichtungsanleitung für den MCP-Server
Der MCP-Server (Model Context Protocol) von ISO Mate erlaubt KI-Assistenten und IDE-Werkzeugen, Ihre gesamte Plattform direkt zu verwalten. Mit 15 Tool-Providern für DevOps, QA, Aufgaben, Vorfälle, Compliance, Helpdesk, Notizen, benutzerdefinierte Objekte, Workflows, Berichte, Editor-KI, Kontakte und Abrechnung können Sie ISO Mate bedienen, ohne Ihre Entwicklungsumgebung zu verlassen.
Schritt 1: API-Token erstellen
- Gehen Sie zu Profil > API-Tokens in der oberen Navigationsleiste.
- Klicken Sie auf Token erstellen.
- Geben Sie dem Token einen aussagekräftigen Namen (z. B. “IDE MCP Token”).
- Wählen Sie die Geltungsbereiche, die Ihr Werkzeug benötigt. Die Geltungsbereiche sind nach Modul gegliedert:
- issue.*, sprint.*, release.*, userstory.*, feature.* für DevOps
- testcase.*, testcycle.*, testenvironment.* für QA
- task.*, recurringtask.* für die Aufgabenverwaltung
- incident.* für Vorfälle
- compliance.* für Compliance (Frameworks, Anforderungen, Kontrollen, Richtlinien, Verfahren, Nachweise, Bestätigungen)
- compliance_ai.search, compliance_ai.generate für die Compliance-KI-Werkzeuge (Suche, Vorlage generieren, Abschnitt vervollständigen)
- ticket.*, cannedresponse.* für den Helpdesk
- note.*, notefolder.*, notetag.* für Notizen
- objecttype.*, entry.* für benutzerdefinierte Objekte
- workflow.* für Workflows (einschließlich Metriken, Vorlagen, Versionen und Import/Export)
- compliance.reports, sales.reports, feedback.reports, calendar.reports für die Berichtswerkzeuge
- editor_ai.assist für die Editor-KI-Werkzeuge
- contact.* für Kontakte
- billing.view für Abrechnung (nur Lesen, standardmäßig von Token-Geltungsbereichen ausgeschlossen)
- Klicken Sie auf Speichern und kopieren Sie den Token. Er 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 Werkzeug ab, aber Sie benötigen:
- Server-URL: Der Endpunkt Ihrer ISO Mate MCP-API
- API-Token: Der in Schritt 1 erstellte Token
Verfügbare Tool-Provider
Nach der Verbindung stehen die folgenden 15 Tool-Provider zur Verfügung. Jeder Provider nutzt 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, freigeben, 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 Grund blockieren) und Testumgebungen (CRUD).
3. Aufgabenverwaltung
Verwalten Sie Arbeitsobjekte: Aufgaben (CRUD, Erledigung umschalten) mit Priorität, Fälligkeitsdaten und Zuständigen. Wiederkehrende Aufgaben (CRUD) mit täglichen, wöchentlichen, monatlichen, jährlichen oder benutzerdefinierten Wiederholungsmustern.
4. Vorfallmanagement
Verfolgen Sie Vorfälle über ihren Lebenszyklus: CRUD-Operationen, Statusübergänge (Offen, In Untersuchung, Eingedämmt, Gelöst, Geschlossen), Benutzerzuweisung mit Rollen, Verknüpfung von Aufgaben und Notizen sowie Einsicht in das Audit-Protokoll.
5. Compliance
Verwalten Sie Ihr Compliance-Programm: Frameworks (CRUD, archivieren), Anforderungen (CRUD mit Statusverfolgung), Kontrollen (CRUD, mit Anforderungen/Richtlinien verknüpfen, 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), Bestätigungen (auflisten, Fortschritt) und Compliance-KI (veröffentlichte Richtlinien und Verfahren durchsuchen, Vorlagen generieren, Abschnitte vervollständigen).
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 zur Kategorisierung).
8. Benutzerdefinierte Objekte
Arbeiten Sie mit benutzerdefinierten Daten: Objekttypen (CRUD für Schemadefinitionen) und Einträge (CRUD mit automatischer Schemavalidierung).
9. Workflow-Automatisierung
Erstellen und steuern Sie Automatisierungen: Workflows (CRUD, umschalten, massenweise aktivieren/deaktivieren/löschen, Webhook-Schlüssel rotieren, Probelauf, manuelle Ausführungen ermitteln und auslösen, Audits), Ausführungen (auflisten, abrufen, Statistiken, erneut versuchen), Metriken (je Workflow und Kontoübersicht), Vorlagen (Galerie durchsuchen, instanziieren), Versionen (Verlauf, wiederherstellen), Import und Export (portables JSON) sowie Konfigurationsermittlung (Auslöser-Entitäten, Ereignisse, Quellen, Aktionstypen, Feldschemata, Relationszulasslisten, Objekttypen, Postfächer, Formulare und Platzhaltervalidierung).
10. Berichte
Holen Sie diagrammfertige Berichtsdaten, die die Berichtsseiten der Konsole widerspiegeln. Compliance-Berichte (Verteilung und Trends), Vertriebsberichte (Verteilung und Trends), Feedback-Berichte (Verteilung und Trends) und Kalenderberichte (Verteilung und Trends). Jedes akzeptiert Datumsbereichsfilter, und Trends akzeptieren ein Gruppierungsintervall von Tag, Woche, Monat oder Jahr. Jeder Bericht erfordert die zugehörige Berichtsberechtigung.
11. Editor-KI
Generieren und verfeinern Sie Rich-Text-Inhalte für unterstützte Editor-Kontexte wie Richtlinien, Verfahren, Issues, Notizen, Tickets und E-Mails.
12. Kontakte
Verwalten Sie Ihr Kontaktverzeichnis: vollständiges CRUD mit Suche nach E-Mail, Name oder Unternehmen.
13. Abrechnung (Nur Lesen)
Sehen Sie Abonnementstatus, Plandetails, Testphaseninfos und Rechnungsverlauf ein. Geltungsbereiche zur Abrechnungsverwaltung sind aus Sicherheitsgründen grundsätzlich von API-Tokens ausgeschlossen.
Ältere Issue-Werkzeuge
Eigenständige Issue-Werkzeuge (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.
Projektschlüssel verwenden
Sie können Issues über ihren Projektschlüssel statt über die UUID referenzieren. Übergeben Sie zum Beispiel BUG-7 an die Get-Operation, um diesen Bug direkt abzurufen. Nutzen Sie den Filter project_key, um alle Issues mit einem bestimmten Präfix zu finden.
Sicherheitshinweise
- Jeder Token ist auf ein einzelnes Konto beschränkt. Daten anderer Konten sind nie zugänglich.
- Gewähren Sie nur die Geltungsbereiche, die Ihr Werkzeug benötigt (Prinzip der geringsten Rechte).
- Geltungsbereiche zur Abrechnungsverwaltung sind grundsätzlich von API-Tokens ausgeschlossen.
- Widerrufen Sie Tokens sofort, wenn sie kompromittiert werden.