MCP-Server

Was der MCP-Server tut

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Assistenten ermöglicht, Tools in anderen Systemen aufzurufen. Der Nomid-MCP-Server ermöglicht es Assistenten wie claude.ai, ChatGPT, Claude Code, Codex oder Cursor, Fragen zu Ihrer Flotte in natürlicher Sprache zu beantworten – beispielsweise wie viele Geräte eine bestimmte Richtlinie verwenden oder welche Geräte seit einem bestimmten Datum nicht mehr erreichbar waren –, ohne dass jemand das Portal öffnen muss. Er kann außerdem diagnostizieren, warum ein Gerät nicht remote erreicht werden kann, auf ein Gerät, eine Richtlinie oder eine App im Portal verlinken und die öffentlichen Tarife sowie Listenpreise von Nomid abrufen. Mit einer zusätzlichen Berechtigung kann er Befehle an jeweils ein Gerät senden, z. B. Sperren, Neustarten oder Ändern der Richtlinie, oder QR-Codes für die Bereitstellung erstellen. Eine separate Berechtigung erlaubt destruktive Befehle wie das Zurücksetzen auf Werkseinstellungen (Wipe).

Endpunkt und Transport

POST https://api.nomid.tech/emm/api/mcp

Der Server verwendet MCP Streamable HTTP im zustandslosen Modus. Jeder JSON-RPC-Aufruf ist eine unabhängige HTTPS-Anfrage, sodass keine Sitzung aufrechterhalten und kein Event-Stream offengehalten werden muss.

Verbinden Sie sich über „Sign in with Nomid“ (OAuth) oder mit einem API-Schlüssel. Senden Sie einen API-Schlüssel als Bearer-Token oder im X-API-Key-Header. Die meisten MCP-Clients unterstützen nur das Bearer-Format. Ein fehlender, ungültiger oder abgelaufener Schlüssel bzw. Token gibt 401 zurück.

Der API-Schlüssel oder die Verbindung über „Sign in with Nomid“ legt das Unternehmen fest. Kein Tool akzeptiert ein Tenant- oder Unternehmensargument, und eine Verbindung kann nur die Geräte und Richtlinien des eigenen Unternehmens einsehen.

Sign in with Nomid

„Sign in with Nomid“ ist OAuth für MCP-Clients, offen für jedes Unternehmen. Anstatt einen Schlüssel zu verwenden, meldet sich der Benutzer im Browser bei Nomid an und genehmigt, was der Assistent tun darf. Der Assistent agiert dann als dieser Benutzer in diesem Unternehmen und sieht nur die Geräte und Richtlinien, die die Rolle und der Richtlinienzugriff des Benutzers zulassen.

claude.ai, ChatGPT und Claude Code verbinden sich über „Sign in with Nomid“: Fügen Sie die obige Endpunkt-URL als benutzerdefinierten Connector oder MCP-Server ohne Schlüssel hinzu und melden Sie sich an, wenn der Client dazu auffordert. Die folgenden Beispiele für Codex und Cursor verwenden einen API-Schlüssel.

Fügen Sie den Server in Claude Code ohne Header hinzu, führen Sie dann /mcp in Claude Code aus und wählen Sie den Server aus, um sich anzumelden.

claude mcp add --transport http nomid-mdm https://api.nomid.tech/emm/api/mcp

Eine Verbindung enthält OAuth-Berechtigungsbereiche (Scopes), die an die Stelle von API-Schlüssel-Berechtigungen treten.

Clients fragen standardmäßig nach mcp:read, mcp:devices:command und mcp:provisioning. mcp:devices:destructive und mcp:policies:write werden niemals automatisch angefordert: Ein Client muss diese explizit anfordern.

Auf der Zustimmungsseite kann der Benutzer Scopes abwählen, und Nomid entfernt alle Scopes, die die Rolle des Benutzers oder die Einstellungen für den Zugriff von KI-Agenten des Unternehmens nicht zulassen. Die Genehmigung eines Befehls-, destruktiven oder Richtlinienänderungs-Scopes erfordert eine kürzlich erfolgte Anmeldung.

Jede Anfrage überprüft die Verbindung erneut. Wenn der Benutzer den Zugriff auf das Unternehmen oder die für ein Tool erforderlichen Rollenberechtigungen verliert oder das Unternehmen den Zugriff von KI-Agenten deaktiviert, werden Anfragen abgelehnt, solange dies andauert.

Einen API-Schlüssel erstellen

Der MCP-Server verwendet dieselben API-Schlüssel wie die REST-API. Erstellen Sie einen dedizierten Schlüssel für jeden Assistenten, damit Sie ihn widerrufen können, ohne andere Integrationen zu beeinträchtigen.

1. 1

   Öffnen Sie im Nomid-Portal die Einstellungen und wählen Sie den Tab „API“.

2. 2

   Klicken Sie auf „API-Schlüssel erstellen“ und geben Sie einen Namen ein, der den Assistenten identifiziert, z. B. Claude Code schreibgeschützt.

3. 3

   Wählen Sie die unten beschriebenen Berechtigungen aus. Wenn der Schlüssel ab einem bestimmten Datum nicht mehr funktionieren soll, legen Sie ein Ablaufdatum fest.

4. 4

   Kopieren Sie den Schlüssel, sobald er angezeigt wird. Er wird nur einmal angezeigt.

Ihren Assistenten verbinden

Speichern Sie den Schlüssel in einer Umgebungsvariable namens NOMID_API_KEY und übertragen Sie ihn niemals in ein Repository. Die URL in jedem Beispiel ist der Produktionsendpunkt.

claude mcp add --transport http nomid-mdm https://api.nomid.tech/emm/api/mcp \
  --header "Authorization: Bearer ${NOMID_API_KEY}"

[mcp_servers.nomid]
url = "https://api.nomid.tech/emm/api/mcp"
bearer_token_env_var = "NOMID_API_KEY"

{
  "mcpServers": {
    "nomid-mdm": {
      "url": "https://api.nomid.tech/emm/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NOMID_API_KEY}"
      }
    }
  }
}

Verfügbare Tools

Jedes Tool ist auf das Unternehmen des Schlüssels oder der Verbindung beschränkt. Ein Gerät wird durch seine assetId identifiziert, welche der von search_devices und get_device zurückgegebene pathName ist. Eine Richtlinie wird durch ihre policyId identifiziert, welche der von list_policies zurückgegebene pathName ist.

Lese-Tools

Lese-Tools ändern niemals etwas. Die meisten geben dieselben Daten wie die entsprechenden REST-Endpunkte zurück. diagnose_device, get_portal_link, search_nomid_site und das Argument query von search_devices haben keine REST-Entsprechung.

Befehls-Tools

Befehls-Tools wirken sich pro Aufruf auf genau ein physisches Gerät aus. Es gibt keine Massenoption. Jedes Tool erfordert DEVICES_COMMAND, und change_device_policy erfordert zusätzlich POLICIES_READ.

Werkzeuge für destruktive Befehle

MCP-Clients, die sich über „Sign in with Nomid“ statt über einen API-Schlüssel verbinden, benötigen den Scope mcp:devices:destructive für diese Tools und mcp:devices:command für die Befehls-Tools.

Welche Geräte können Befehle empfangen

• Nur registrierte Geräte können Befehle empfangen (Status ACTIVE, INACTIVE oder SYNCHRONIZING). Gelöschte, neu bereitgestellte und abgemeldete Assets werden abgelehnt.
• Einige Befehle funktionieren nur auf einem bestimmten Gerätetyp. Lock, lost mode, clear_app_data, reset_screen_lock und change_screen_lock_password erfordern ein Gerät mit Android Management (von Google verwaltet). sync_policy, shutdown_device und launch_app erfordern ein vom Nomid-Agenten verwaltetes Gerät (AOSP). Andere Geräte erhalten einen Tool-Fehler.
• Eine Nachricht ist eine Push-Benachrichtigung an den Nomid-Agenten auf dem Gerät, daher benötigt das Gerät ein registriertes Push-Token.
• Ein Asset, das zu einem anderen Unternehmen gehört, verhält sich genau wie ein Asset, das nicht existiert.

Nicht über MCP oder die REST-API verfügbar: Starten von Fernzugriffssitzungen sowie Auflisten oder Widerrufen von Registrierungs-Tokens. Ein Bereitstellungs-QR-Code erstellt sein eigenes Registrierungs-Token. Richtlinienänderungen haben ihren eigenen Vorschlags- und Anwendungsablauf.

Bereitstellungstool

Jeder Aufruf erstellt ein neues Registrierungstoken, daher sollte der Assistent nur dann einen QR-Code erstellen, wenn der Benutzer danach fragt, und niemals einen älteren wiederverwenden.

Der QR-Code wird als MCP-Bildblock neben dem Textergebnis zurückgegeben, damit der Client ihn dem Benutzer anzeigen kann. Das Textergebnis enthält policyId, policyName, personalUsage, expiresAt und, falls ein Netzwerk angegeben wurde, wifiSsid. Es enthält niemals das Registrierungstoken oder das WLAN-Passwort.

Verbindungen über „Sign in with Nomid“ erfordern den Scope mcp:provisioning und die Bereitstellungseinstellung des Unternehmens unter Zugriff von KI-Agenten. Ein API-Schlüssel mit PROVISIONING benötigt diese Einstellung nicht.

Bereitstellungs-QR-Codes-API

Sicherheit und Audit

Ein Befehl ändert etwas an einem Gerät, das eine Person in der Hand hält. Behandeln Sie jeden einzelnen als eine Aktion, die eine menschliche Entscheidung erfordert.

• Holen Sie vor jedem Befehl immer die Bestätigung des Benutzers ein. Die Tool-Beschreibungen fordern das Modell dazu auf, dies zu tun, aber serverseitig wird dies nicht erzwungen. Behalten Sie die Genehmigung pro Tool Ihres Clients für Befehls-Tools aktiviert, anstatt sie automatisch zu genehmigen.
• Senden Sie einen Befehl nach einem unbestätigten Ergebnis niemals erneut. Wenn das Ergebnis unbekannt ist, prüfen Sie list_device_commands, nachdem das Gerät Zeit zum Antworten hatte, und fragen Sie den Benutzer vor dem erneuten Senden. Ein erneutes Senden kann einen bereits zugestellten Befehl duplizieren, und eine Nachricht zeigt eine zweite Benachrichtigung an.
• Ein Ergebnis, das besagt, dass der Befehl nicht gesendet wurde, kann sicher wiederholt werden. Der Befehl hat Nomid nie verlassen.
• Jeder Befehl wird im Befehlsverlauf des Geräts im Nomid-Portal aufgezeichnet. Ein mit einem API-Schlüssel gesendeter Befehl wird dem Schlüssel zugeordnet, nicht einer Person: Der Eintrag zeigt api-key, die Schlüssel-ID und das Schlüsselpräfix. Ein über eine Verbindung mit „Sign in with Nomid“ gesendeter Befehl wird dem Benutzer zugeordnet, der sich angemeldet hat. Der Verlauf, den list_device_commands zurückgibt, enthält nur Typ, Status, Zeitstempel und Ergebnis, nicht jedoch, wer den Befehl gesendet hat.
• Wenn ein Computer oder eine Konfigurationsdatei kompromittiert ist, widerrufen Sie den Schlüssel unter „Einstellungen, API“. Widerrufene Schlüssel können nicht wiederhergestellt werden. Um eine Verbindung mit „Sign in with Nomid“ zu beenden, widerrufen Sie sie in der Verbindungsliste der Seite „KI-Agenten“ im Portal oder trennen Sie sie in einem Client, der seine Tokens beim Trennen widerruft. In beiden Fällen funktionieren die Verbindung und alle ihre Tokens sofort nicht mehr. Jeder Benutzer kann seine eigenen Verbindungen widerrufen, und ein Benutzer, der API-Schlüssel verwalten kann, kann jede Verbindung des Unternehmens widerrufen.

Ratenbegrenzungen

Begrenzungen werden pro API-Schlüssel oder pro Verbindung mit „Sign in with Nomid“ in festen Ein-Minuten-Fenstern gezählt. Wenn Sie das MCP-Anfragelimit überschreiten, antwortet der Server mit HTTP 429 Too Many Requests und einem Retry-After-Header, der die Sekunden angibt, bis das Fenster zurückgesetzt wird.

Ein Befehlswerkzeug-Aufruf, jeder propose- oder apply-Aufruf eines Richtlinienänderungswerkzeugs sowie jeder create_provisioning_qr_code-Aufruf zählen für beide Limits. Wenn ein solcher Aufruf das gemeinsame Schreiblimit überschreitet, gibt der Server anstelle eines HTTP 429 einen Tool-Fehler zurück. Es handelt sich um eine normale Antwort, die als Fehler gekennzeichnet ist, und deren Text angibt, wie viele Sekunden gewartet werden muss. Die REST-Lese-Endpunkte verwenden das MCP-Limit nicht.

Fehlerbehebung

Zugehörige Dokumentation

• API-Schlüssel-Authentifizierung
• Gerätebefehle-API-Referenz
• API für Richtlinienänderungen
• Bereitstellungs-QR-Codes-API