Mit dem Primo-MCP-Server können KI-Assistenten wie ChatGPT, Claude oder Cursor mit Ihren Daten in Factorial IT arbeiten. Nutzen Sie ihn, wenn Sie direkt in Ihrem gewohnten Assistenten in natürlicher Sprache Fragen zu Ihren Geräten, Mitarbeitenden und Tickets stellen oder diese verwalten möchten.
Funktion
Übersicht
MCP (Model Context Protocol) ist ein offener Standard. Er ermöglicht einem KI-Assistenten, sich direkt mit externen Tools und Daten zu verbinden, auch mit Factorial IT.
Sobald die Verbindung besteht, kann Ihr Assistent auf Anfrage auf Ihre IT-Infrastruktur zugreifen und dort handeln: Geräte auflisten, Mitarbeitende finden, Zubehör verwalten, Tickets öffnen und mehr.
Was Sie benötigen:
- Ein Konto bei Factorial IT mit Zugriff auf den Arbeitsbereich Ihres Unternehmens.
- Einen KI-Assistenten, der MCP unterstützt, zum Beispiel ChatGPT, Claude oder Cursor.
Die Anmeldung erfolgt über OAuth. Wenn Sie den Server hinzufügen, leitet der Assistent Sie zur Anmeldung mit Ihrem Factorial IT-Konto weiter. Ein API-Schlüssel ist nicht erforderlich.
Server-URL
Der Server ist erreichbar unter:
https://api.getprimo.com/mcpStandardmäßig hat die Verbindung nur Lesezugriff: Der Assistent kann Daten ansehen, aber nicht ändern.
Für Schreibzugriff (Tickets öffnen, Zubehör aktualisieren usw.) verwenden Sie stattdessen diese URL:
https://api.getprimo.com/mcp?readOnly=false
Mit ChatGPT verbinden
- Öffnen Sie ChatGPT. Ihr Plan muss benutzerdefinierte MCP-Connectors unterstützen.
- Gehen Sie zu Einstellungen → Verbundene Apps oder verwenden Sie das Menü Verbinden.
- Wählen Sie MCP-Server hinzufügen.
- Geben Sie
https://api.getprimo.com/mcpein. - Melden Sie sich mit Ihrem Factorial IT-Konto an, wenn sich die OAuth-Seite öffnet.
- Autorisieren Sie die Verbindung.
Vorschläge zum Ausprobieren:
- „Liste alle Geräte auf, die in Factorial IT verwaltet werden“
- „Zeige mir die Mitarbeitenden, die diesen Monat angefangen haben“
- „Welche Tickets sind gerade offen?“
Mit Claude Desktop verbinden
- Öffnen Sie die App Claude Desktop.
- Gehen Sie zu Einstellungen → Entwickler → MCP-Server.
- Klicken Sie auf Server hinzufügen.
- Geben Sie einen Namen ein (zum Beispiel „Factorial IT“) und tragen Sie
https://api.getprimo.com/mcpein. - Schließen Sie die OAuth-Anmeldung mit Ihrem Factorial IT-Konto ab.
- Speichern Sie und verbinden Sie neu. Die Tools von Factorial IT erscheinen dann in den Tools von Claude.
Mit Cursor verbinden
- Öffnen Sie die Einstellungen von Cursor.
- Gehen Sie zu MCP-Server.
- Fügen Sie einen Server mit der URL
https://api.getprimo.com/mcphinzu. - Schließen Sie die OAuth-Anmeldung mit Ihrem Factorial IT-Konto ab. Der Assistent von Cursor kann dann die Tools von Factorial IT nutzen.
Mit anderen Assistenten verbinden
Jede App, die den MCP-Standard unterstützt, kann sich verbinden. Geben Sie https://api.getprimo.com/mcp als Server an und melden Sie sich über OAuth mit Ihrem Factorial IT-Konto an.
Mehrere Unternehmen in einem Konto
Wenn Ihr Konto Zugriff auf mehr als ein Unternehmen hat, verwendet der Server das unter Standard-MCP-Unternehmen gewählte Unternehmen. Sie finden diese Einstellung auf der Registerkarte Unternehmen unter Mein Konto. Die Registerkarte wird nur angezeigt, wenn Sie zu zwei oder mehr Unternehmen gehören.
Wenn kein Standard festgelegt ist, fügen Sie der URL den Parameter x-company-id hinzu:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_IDParameter lassen sich kombinieren:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=falseIhre Unternehmens-ID erhalten Sie, indem Sie Ihre Unternehmen über die API auflisten oder die URL in der Konsole prüfen.
Was der Assistent tun kann
Der Assistent sieht nur die Tools, die Ihre Rolle erlaubt. Er kann nur lesen, bis Sie die Verbindung mit readOnly=false herstellen.
| Kategorie | Lesevorgänge | Schreibvorgänge |
|---|---|---|
| Zubehör | Zubehör und seine benutzerdefinierten Felder auflisten und anzeigen | Zubehör erstellen, aktualisieren, zuweisen und archivieren; Werte benutzerdefinierter Felder festlegen |
| Admins | Admins des Unternehmens auflisten | Admins des Unternehmens per E-Mail kontaktieren |
| KI-Agenten | Agenten und ihre Ausführungen auflisten; Bericht und Transkript einer Ausführung lesen | Einen benutzerdefinierten Agenten erstellen; die Anweisungen eines Agenten ersetzen |
| KI-Dashboards | Ein Dashboard und seine Anweisungen anzeigen | Ein Dashboard neu erstellen; seine Anweisungen ersetzen |
| KI-Tools | KI-Tools auf Geräten, Risikobefunde und die Einstellungen für KI-Tools anzeigen | KI-Tools genehmigen oder blockieren; die Einstellungen aktualisieren |
| KI-Nutzung | Den Verbrauch an KI-Credits des Unternehmens anzeigen | — |
| Abrechnungsprofile | Abrechnungsprofile auflisten | — |
| Katalog | Den Katalog durchsuchen und Produkte, Favoriten, Lieferländer und Unternehmensadressen anzeigen; die Ausrüstungs- und Einkaufsrichtlinien anzeigen | Favoriten anheften und lösen; die Ausrüstungs- und Einkaufsrichtlinien aktualisieren und veröffentlichen |
| Unternehmen | Das Unternehmen und seinen Kennzahlenbericht anzeigen | — |
| Konformität | Konformitätswarnungen samt Kontext zur Behebung auflisten und durchsuchen; Regeln, Einstellungen und die Richtlinie zur Behebung anzeigen | Warnregeln erstellen und aktualisieren; die Einstellungen aktualisieren; die Richtlinie zur Behebung aktualisieren, veröffentlichen und zurückziehen |
| Benutzerdefinierte Felder | Benutzerdefinierte Felder auflisten und anzeigen | Benutzerdefinierte Felder erstellen, aktualisieren und archivieren |
| Gerätegruppen | Gerätegruppen und ihre Verwendung auflisten und anzeigen; ein Ziel prüfen, bevor eine Gruppe erstellt wird | Gerätegruppen erstellen, aktualisieren und löschen |
| Geräte | Geräte mit ihren Aktivitäten, MDM-Befehlen, lokalen Konten und benutzerdefinierten Feldern suchen, zählen und anzeigen; Geräte und Inventar als CSV exportieren | Geräte erstellen, aktualisieren und entfernen; sperren, entsperren, löschen (⚠️), neu starten, ausmustern und austragen; in den Bestand oder in Nutzung verschieben; ein Skript ausführen; ein Profil erneut senden; Tags und Werte benutzerdefinierter Felder festlegen |
| Mitarbeitende | Mitarbeitende und ihre benutzerdefinierten Felder auflisten, durchsuchen und anzeigen | Mitarbeitende erstellen, aktualisieren, ausblenden und wieder einblenden; eine Einschreibungsanfrage senden; Werte benutzerdefinierter Felder festlegen |
| Wissensdatenbank | Artikel der Wissensdatenbank auflisten und anzeigen | Artikel erstellen, aktualisieren, veröffentlichen, zurückziehen und löschen |
| MDM-Kontrollen | Kontrollen auflisten, anzeigen und im Typkatalog suchen; die für ein Gerät geltenden Kontrollen auflisten | Kontrollen erstellen, aktualisieren und löschen; ihre Tags aktualisieren |
| Offboardings | Offboardings auflisten und anzeigen | — |
| Onboardings | Onboardings und die Onboarding-Einstellungen auflisten und anzeigen | Onboardings erstellen, abschließen und ignorieren; die Schritte für Mitarbeitende, E-Mail-Konten, Ausrüstung und SaaS ausführen; die Einstellungen aktualisieren |
| Bestellungen | Bestellungen und ihre benutzerdefinierten Felder auflisten und anzeigen | Bestellungen und Ausrüstungsbestellungen erstellen; Werte benutzerdefinierter Felder festlegen |
| SaaS | SaaS-Anwendungen, ihre Probleme und die Identitäten jeder mitarbeitenden Person auflisten und anzeigen; in einer Vorschau sehen, was Regeln gewähren | Identitäten bereitstellen, entziehen, erstellen, verknüpfen, archivieren und löschen; ein Passwort zurücksetzen; Gruppen, Rollen, Lizenzen und Organisationseinheiten verwalten; Verträge, Verantwortliche, Genehmigungsstatus und Regeln aktualisieren |
| Skripte | Gespeicherte Skripte und ihre Ausführungen mit dem Ergebnis auf jedem Gerät auflisten | Ein Skript auf einem Ziel ausführen |
| Sendungen | Sendungen auflisten und anzeigen | Eine Sendung erstellen |
| Software | Den Softwarekatalog, die Software auf einem Gerät, Installationsstatus und Protokolle sowie CVE-Schwachstellen anzeigen | Software installieren, deinstallieren, aktualisieren und löschen; Installationsskripte aktualisieren; den Katalog oder ein Gerät synchronisieren |
| Aufgaben | Aufgaben auflisten | Aufgaben erstellen und planen; ihren Status und ihre Zuweisung aktualisieren |
| Tickets | Tickets mit ihren Abonnenten auflisten, zählen und anzeigen; Ticket-Tags auflisten | Tickets erstellen und löschen; Kommentare hinzufügen; Status, Priorität, Zuweisung und KI-Agent aktualisieren; Abonnenten, verknüpfte Objekte und Ticket-Tags verwalten |
Seien Sie im Schreibmodus vorsichtig. Manche Aktionen lassen sich nicht rückgängig machen: das Entfernen eines Geräts, das endgültige Löschen einer SaaS-Identität samt Verlauf oder das Löschen eines Tickets samt seinen Aufgaben. Wenn Sie den Verlauf eines Tickets behalten möchten, bitten Sie den Assistenten, es zu schließen statt zu löschen.
Tipps und Best Practices
-
Beginnen Sie mit reinem Lesezugriff. Fügen Sie
readOnly=falsenur hinzu, wenn der Assistent wirklich Änderungen vornehmen soll. - Schließen Sie Tickets, statt sie zu löschen. Beim Löschen werden das Ticket und seine Aufgaben endgültig entfernt.
- Prüfen Sie vor jedem Löschvorgang. Der Assistent kann im Schreibmodus Geräte löschen, und das lässt sich nicht rückgängig machen.
-
Legen Sie ein Standardunternehmen fest, wenn Sie mehrere verwalten. So müssen Sie
x-company-idnicht jeder URL hinzufügen und vermeiden Antworten aus dem falschen Unternehmen. - Vergeben Sie die passende Rolle. Der Assistent erhält nur die Tools, die Ihre Rolle erlaubt; für den Zugriff gelten also dieselben Regeln wie in der Konsole.
Fehlerbehebung und FAQ
Fehlerbehebung
- Die URL zeigt im Browser „404 Not Found“ an. Das ist das erwartete Verhalten. Der Server ist keine Webseite, sondern ein Endpunkt für KI-Assistenten. Fügen Sie ihn stattdessen in Ihrem Assistenten als MCP-Server hinzu.
- Die Authentifizierung schlägt fehl. Schließen Sie die OAuth-Anmeldung ab, wenn der Assistent Sie dazu auffordert. Ihr Factorial IT-Konto muss aktiv sein und Zugriff auf das Unternehmen haben, das Sie abfragen möchten.
-
Der Assistent zeigt Daten aus dem falschen Unternehmen an. Legen Sie Standard-MCP-Unternehmen auf der Registerkarte Unternehmen unter Mein Konto fest oder fügen Sie der URL den Parameter
x-company-idhinzu. -
Der Assistent kann nichts ändern. Die Verbindung hat standardmäßig nur Lesezugriff. Stellen Sie die Verbindung mit
readOnly=falseneu her.
FAQ
-
Brauche ich einen API-Schlüssel?
Nein. Sie melden sich über OAuth mit Ihrem Factorial IT-Konto an.
-
Kann der Assistent sofort Änderungen vornehmen?
Nein. Er beginnt mit reinem Lesezugriff. Für Schreibzugriff brauchen Sie die URL mitreadOnly=false.
-
Sieht der Assistent alles, was in der Konsole steht?
Nein. Er sieht nur die Tools, die Ihre Rolle erlaubt.
-
Wo finde ich meine Unternehmens-ID?
Listen Sie Ihre Unternehmen über die API auf oder prüfen Sie die URL in der Konsole.
-
An wen wende ich mich bei Fragen zur Einrichtung?
Wenden Sie sich an den Support von Factorial IT oder nutzen Sie den Chat in der App. Die API-Dokumentation finden Sie unter api.getprimo.com/apidoc.