Zurück

Verbinden Sie einen KI-Assistenten mit dem Primo-MCP-Server

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/mcp

Standardmäß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

  1. Öffnen Sie ChatGPT. Ihr Plan muss benutzerdefinierte MCP-Connectors unterstützen.
  2. Gehen Sie zu Einstellungen → Verbundene Apps oder verwenden Sie das Menü Verbinden.
  3. Wählen Sie MCP-Server hinzufügen.
  4. Geben Sie https://api.getprimo.com/mcp ein.
  5. Melden Sie sich mit Ihrem Factorial IT-Konto an, wenn sich die OAuth-Seite öffnet.
  6. 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

  1. Öffnen Sie die App Claude Desktop.
  2. Gehen Sie zu Einstellungen → Entwickler → MCP-Server.
  3. Klicken Sie auf Server hinzufügen.
  4. Geben Sie einen Namen ein (zum Beispiel „Factorial IT“) und tragen Sie https://api.getprimo.com/mcp ein.
  5. Schließen Sie die OAuth-Anmeldung mit Ihrem Factorial IT-Konto ab.
  6. Speichern Sie und verbinden Sie neu. Die Tools von Factorial IT erscheinen dann in den Tools von Claude.

 

Mit Cursor verbinden

  1. Öffnen Sie die Einstellungen von Cursor.
  2. Gehen Sie zu MCP-Server.
  3. Fügen Sie einen Server mit der URL https://api.getprimo.com/mcp hinzu.
  4. 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_ID

Parameter lassen sich kombinieren:

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=false

Ihre 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=false nur 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-id nicht 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-id hinzu.
  • Der Assistent kann nichts ändern. Die Verbindung hat standardmäßig nur Lesezugriff. Stellen Sie die Verbindung mit readOnly=false neu her.

 

FAQ

  1. Brauche ich einen API-Schlüssel?
    Nein. Sie melden sich über OAuth mit Ihrem Factorial IT-Konto an.
     
  2. Kann der Assistent sofort Änderungen vornehmen?
    Nein. Er beginnt mit reinem Lesezugriff. Für Schreibzugriff brauchen Sie die URL mit readOnly=false.
     
  3. Sieht der Assistent alles, was in der Konsole steht?
    Nein. Er sieht nur die Tools, die Ihre Rolle erlaubt.
     
  4. Wo finde ich meine Unternehmens-ID?
    Listen Sie Ihre Unternehmen über die API auf oder prüfen Sie die URL in der Konsole.
     
  5. 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.

War dieser Artikel hilfreich?

Give feedback about this article

Können Sie nicht finden, wonach Sie suchen?

Unser Kundenserviceteam steht Ihnen zur Verfügung.

Kontakt

Knowledge Base Software powered by Helpjuice