Zurück

Verbinde einen KI-Assistenten mit dem Primo MCP-Server.

Der Primo MCP-Server ermöglicht es KI-Assistenten wie ChatGPT, Claude oder Cursor, mit Ihren Factorial IT-Daten zu arbeiten. Verwenden Sie ihn, wenn Sie in einfacher Sprache Fragen zu Ihren Geräten, Mitarbeitenden und Tickets stellen oder diese verwalten möchten, von dem Assistenten, den Sie bereits nutzen.


 

Funktion/Feature

Überblick

MCP (Model Context Protocol) ist ein offener Standard. Er ermöglicht es einem KI-Assistenten, direkt in externe Tools und Daten zu integrieren, einschließlich Factorial IT.

Sobald er verbunden ist, kann Ihr Assistent auf Ihre IT-Infrastruktur zugreifen und darauf reagieren, wenn Sie ihn darum bitten: Geräte auflisten, Mitarbeitende finden, Zubehör verwalten, Tickets öffnen und mehr.

Was Sie benötigen:

  • Ein Factorial IT-Konto mit Zugang zum Arbeitsbereich Ihres Unternehmens.
  • Ein KI-Assistent, der MCP unterstützt, wie ChatGPT, Claude oder Cursor.

Die Anmeldung erfolgt über OAuth. Wenn Sie den Server hinzufügen, wird der Assistent Sie zur Anmeldung mit Ihrem Factorial IT-Konto weiterleiten. Kein API-Schlüssel ist erforderlich.

 

Server-URL

Der Server ist erreichbar unter:

https://api.getprimo.com/mcp

Standardmäßig ist die Verbindung schreibgeschützt: Der Assistent kann Daten einsehen, aber nicht ändern.

Für Schreibzugriff (Tickets öffnen, Zubehör aktualisieren usw.) verwenden Sie stattdessen diese URL:

https://api.getprimo.com/mcp?readOnly=false

 

So verwenden Sie: ChatGPT

  1. Öffnen Sie ChatGPT. Ihr Plan muss benutzerdefinierte MCP-Connectoren unterstützen.
  2. Gehen Sie zu Einstellungen → Verbundene Apps, oder verwenden Sie das "Verbinden"-Menü.
  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 die OAuth-Seite geöffnet wird.
  6. Autorisieren Sie die Verbindung.

Vorschläge zum Ausprobieren:

  • "Liste alle Geräte, die in Factorial IT verwaltet werden"
  • "Zeige mir die Mitarbeitenden, die in diesem Monat beigetreten sind"
  • "Welche Tickets sind derzeit offen?"

 

So verwenden Sie: Claude Desktop

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

 

So verwenden Sie: Cursor

  1. Öffnen Sie die Cursor-Einstellungen.
  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 Cursor-Assistent kann dann die Factorial IT-Tools verwenden.

 

So verwenden Sie: andere Assistenten

Jede App, die dem MCP-Standard folgt, kann sich verbinden. Richten Sie sie auf https://api.getprimo.com/mcp und melden Sie sich mit Ihrem Factorial IT-Konto über OAuth an.

 

Mehrere Unternehmen in einem Konto

Wenn Ihr Konto auf mehr als einen Mandanten zugreifen kann, verwendet der Server das in Standard-MCP-Unternehmen gewählte Unternehmen. Sie finden es im Unternehmen-Tab von Mein Konto, der nur angezeigt wird, wenn Sie zu zwei oder mehr Unternehmen gehören.

Wenn kein Standard festgelegt ist, fügen Sie den Parameter x-company-id zur URL hinzu:

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

Parameter können kombiniert werden:

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

Um Ihre Mandanten-ID zu erhalten, listen Sie Ihre Unternehmen über die API auf oder überprüfen Sie die URL in der Konsole.

 

Was der Assistent tun kann

Der Assistent sieht nur die Tools, die Ihre Rolle erlaubt. Er ist auf Lesevorgänge beschränkt, bis Sie sich mit readOnly=false verbinden.

Kategorie Lesebetrieb Schreibbetrieb
Zubehör Liste und Ansicht von Zubehör und deren benutzerdefinierten Feldern Erstellen, aktualisieren, zuweisen und archivieren von Zubehör; benutzerdefinierte Feldwerte festlegen
Administratoren Liste der Unternehmensadministratoren Unternehmensadministratoren per E-Mail kontaktieren
KI-Agenten Liste der Agenten und deren Ausführungen; lesen Sie den Bericht und das Transkript einer Ausführung Erstellen Sie einen benutzerdefinierten Agenten; ersetzen Sie die Anweisungen eines Agenten
KI-Dashboards Dashboard und dessen Anweisungen anzeigen Ein Dashboard neu zusammensetzen; dessen Anweisungen ersetzen
KI-Tools Die KI-Tools auf Geräten, die Risikofunde und die Einstellungen der KI-Tools anzeigen KI-Tools genehmigen oder blockieren; die Einstellungen aktualisieren
KI-Nutzung Die Nutzung der KI-Credits des Unternehmens anzeigen —
Abrechnungsprofile Liste der Abrechnungsprofile —
Katalog Durchsuchen des Katalogs und Anzeige von Produkten, Favoriten, Versandländern und Unternehmensadressen; die Ausrüstungs- und Einkaufsrichtlinien anzeigen Favoriten anheften und lösen; die Ausrüstungs- und Einkaufsrichtlinien aktualisieren und veröffentlichen
Unternehmen Das Unternehmen und dessen Metrikbericht anzeigen —
Compliance Liste und Suche von Compliance-Warnungen mit ihrem Kontext zur Behebung; Regeln, Einstellungen und die Richtlinie zur Behebung anzeigen Regeln zur Warnung erstellen und aktualisieren; die Einstellungen aktualisieren; die Richtlinie zur Behebung aktualisieren, veröffentlichen und zurückziehen
Benutzerdefinierte Felder Liste und Ansicht von benutzerdefinierten Feldern Benutzerdefinierte Felder erstellen, aktualisieren und archivieren
Gerätegruppen Liste und Ansicht von Gerätegruppen und deren Nutzungen; überprüfen Sie ein Ziel, bevor Sie eine Gruppe erstellen 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 löschen; sperren, entsperren, löschen (⚠️), neu starten, außer Betrieb nehmen und abmelden; in den Bestand oder in Benutzung verschieben; ein Skript ausführen; ein Profil erneut senden; Tags und benutzerdefinierte Feldwerte festlegen
Mitarbeitende Liste, Suche und Ansicht von Mitarbeitenden und deren benutzerdefinierten Feldern Mitarbeitende erstellen, aktualisieren, ausblenden und wieder einblenden; eine Einschreibungsanfrage senden; benutzerdefinierte Feldwerte festlegen
Wissensdatenbank Liste und Ansicht von Artikeln in der Wissensdatenbank Artikel erstellen, aktualisieren, veröffentlichen, zurückziehen und löschen
MDM-Steuerungen Liste, Ansicht und Durchsuchen des Typkatalogs; die Steuerungen auflisten, die auf ein Gerät zutreffen Tags erstellen, aktualisieren, löschen und aktualisieren
Offboardings Liste und Ansicht von Offboardings —
Onboardings Liste und Ansicht von Onboardings und den Onboarding-Einstellungen Onboardings erstellen, abschließen und ignorieren; die Schritte für Mitarbeitende, E-Mail-Konten, Ausrüstung und SaaS ausführen; die Einstellungen aktualisieren
Bestellungen Liste und Ansicht von Bestellungen und deren benutzerdefinierten Feldern Bestellungen und Ausrüstungsbestellungen erstellen; benutzerdefinierte Feldwerte festlegen
SaaS Liste und Ansicht von SaaS, deren Problemen und den Identitäten jedes Mitarbeitenden; Vorschau, was die Regeln gewähren Identitäten bereitstellen, zurückziehen, erstellen, verlinken, archivieren und löschen; ein Passwort zurücksetzen; Gruppen, Rollen, Lizenzen und Organisationseinheiten verwalten; Verträge, Eigentümer, Genehmigungsstatus und Regeln aktualisieren
Skripte Liste der gespeicherten Skripte und deren Ausführungen, mit dem Ergebnis auf jedem Gerät Ein Skript auf ein Ziel ausführen
Sendungen Liste und Ansicht von Sendungen Eine Sendung erstellen
Software Den Softwarekatalog, die Software auf einem Gerät, den Installationsstatus und Protokolle sowie CVE-Sicherheitsanfälligkeiten anzeigen Software installieren, deinstallieren, aktualisieren und löschen; Installationsskripte aktualisieren; den Katalog oder ein Gerät synchronisieren
Aufgaben Aufgaben auflisten Aufgaben erstellen und planen; deren Status und Zuweisung aktualisieren
Tickets Tickets auflisten, zählen und mit deren Abonnenten 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 vorsichtig im Schreibmodus. Einige Aktionen können nicht rückgängig gemacht werden: das Löschen eines Geräts, das permanente Löschen einer SaaS-Identität mit ihrer Historie oder das Löschen eines Tickets zusammen mit seinen Aufgaben. Wenn Sie die Historie eines Tickets behalten möchten, bitten Sie den Assistenten, es zu schließen, anstatt es zu löschen.


 

Tipps und bewährte Praktiken

  • Beginnen Sie im Nur-Lese-Modus. Fügen Sie readOnly=false nur hinzu, wenn Sie tatsächlich möchten, dass der Assistent Änderungen vornimmt.
  • Schließen Sie Tickets, anstatt sie zu löschen. Das Löschen entfernt das Ticket und seine Aufgaben dauerhaft.
  • Überprüfen Sie vor einem Löschen. Der Assistent kann Geräte im Schreibmodus löschen, und ein Löschen kann nicht rückgängig gemacht werden.
  • Setzen Sie ein Standardunternehmen fest, wenn Sie mehrere verwalten. Das spart das Hinzufügen von x-company-id zu jeder URL und vermeidet Antworten vom falschen Mandanten.
  • Geben Sie die richtige Rolle an. Der Assistent erhält nur die Tools, die Ihre Rolle erlaubt, daher ist der Zugriff durch dieselben Regeln wie die Konsole eingeschränkt.

 

Fehlerbehebung und FAQ

Fehlerbehebung

  • Die URL zeigt "404 Not Found" in einem Browser an. Das ist zu erwarten. Der Server ist keine Webseite; es ist ein Endpunkt für KI-Assistenten. Fügen Sie ihn stattdessen als MCP-Server in Ihrem Assistenten hinzu.
  • Die Authentifizierung schlägt fehl. Schließen Sie die OAuth-Anmeldung ab, wenn der Assistent danach fragt. Ihr Factorial IT-Konto muss aktiv sein und Zugang zu dem Unternehmen haben, das Sie abfragen möchten.
  • Der Assistent zeigt Daten vom falschen Unternehmen an. Setzen Sie Standard-MCP-Unternehmen im Unternehmen-Tab von Mein Konto, oder fügen Sie den Parameter x-company-id zur URL hinzu.
  • Der Assistent kann nichts ändern. Die Verbindung ist standardmäßig schreibgeschützt. Stellen Sie die Verbindung mit readOnly=false wieder her.

 

FAQ

  1. Benötige ich einen API-Schlüssel?
    Nein. Sie melden sich mit Ihrem Factorial IT-Konto über OAuth an.
     
  2. Kann der Assistent sofort Änderungen vornehmen?
    Nein. Er beginnt im Nur-Lese-Modus. Schreibzugriff benötigt die readOnly=false URL.
     
  3. Sieht der Assistent alles in der Konsole?
    Nein. Er sieht nur die Tools, die Ihre Rolle erlaubt.
     
  4. Wo finde ich meine Mandanten-ID?
    Listen Sie Ihre Unternehmen über die API auf oder überprüfen Sie die URL in der Konsole.
     
  5. Wen kontaktiere ich für Hilfe bei der Einrichtung?
    Kontaktieren Sie den Factorial IT-Support oder nutzen Sie den In-App-Chat. 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