Verbinden Sie Ihren KI-Assistenten mit Azumuta

Aktualisiert

BETA: Azumuta MCP befindet sich derzeit in der Beta und kann sich noch weiterentwickeln. Sie ist nur auf Opt‑in‑Basis verfügbar. Um an der Beta teilzunehmen oder Fragen zu stellen, kontaktieren Sie support@azumuta.com.

Model Context Protocol (MCP) verbindet Ihren bevorzugten AI‑Assistenten mit den zulässigen Azumuta‑Daten. Sie können Fragen zu Arbeitsanweisungen, Produktaufträgen, Aufzeichnungen und Issues stellen, ohne diese Daten manuell in ein Gespräch kopieren zu müssen.

Die Azumuta MCP‑Tools sind nur lesend. Sie können Ihren Arbeitsbereich nicht verändern. Siehe Azumuta MCP verwenden für Beispiele und Einschränkungen.

Bevor Sie beginnen

  • Aktivieren Sie die MCP‑Beta für Ihren Arbeitsbereich.
  • Verwenden Sie einen von Ihrer Organisation genehmigten AI‑Assistenten. Der Assistent muss Remote‑MCP‑Verbindungen und einen Authorization‑Header unterstützen.
  • Stellen Sie sicher, dass Sie die Berechtigung zum Verwalten von API‑Geräten haben, oder bitten Sie den Administrator Ihres Arbeitsbereichs, den Schlüssel zu erstellen.
  • Prüfen Sie, welche Daten Sie mit dem AI‑Client und dessen Modellanbieter teilen dürfen. Abgerufene Daten werden an diesen Client und Anbieter weitergegeben.

Cursor ist das im Leitfaden illustrierte Beispiel. Andere AI‑Assistenten haben abweichende Einrichtungskontrollen. Sie müssen den Azumuta MCP‑Server nicht auf Ihrem Computer installieren.

Wenn API scopes nicht verfügbar ist oder Sie Hilfe bei der Verbindungsherstellung benötigen, kontaktieren Sie support@azumuta.com.

Erstellen eines Schlüssels mit Lesezugriff

Ein API‑Schlüssel wählt den Arbeitsbereich aus und steuert, auf welche Datenkategorien der Assistent zugreifen kann. Sein Zugriff entspricht nicht zwangsläufig Ihren Web‑App‑Berechtigungen. Bitten Sie Ihren Admin, den Schlüssel vor der Verbindung zu prüfen.

  1. Erstellen Sie ein dediziertes API‑Gerät in dem Arbeitsbereich, den Sie verbinden möchten.
  2. Öffnen Sie Edit device für dieses Gerät.
  3. Öffnen Sie Security.
  4. Unter API scopes wählen Sie Restrict this API key to a subset of operations.
  5. Entfernen Sie die ausgewählten Scopes, die Sie nicht benötigen. Die Anfangsauswahl umfasst alle Scopes.
  6. Wählen Sie nur die erforderlichen Read‑Optionen aus der Tabelle unten.
  7. Speichern Sie das Gerät.
  8. Kopieren Sie den API‑Schlüssel.
Kategorie Lesezugriff Scope‑Bezeichner
Arbeitsanweisungen Arbeitsanweisungen, Inhalte und Versionen workinstructions:read
Aufzeichnungen Aufzeichnungen zu Arbeitsanweisungen und strukturierte Berichtsdaten recordings:read
Produkte Produktaufträge und deren Ausführungsdetails products:read
Issues Issues, Boards, Abläufe und Statusänderungen issues:read
Benutzer Benutzerdetails users:read
Spots Zonen und Stationen spots:read

MCP erfordert explizite Scopes. Ein Schlüssel ohne ausgewählte Scopes gewährt keinen uneingeschränkten MCP‑Zugriff. Manche Fragen benötigen mehrere Scopes, etwa Work instructions und Recordings.

API‑Scopes, gefiltert auf Arbeitsanweisungen, mit ausgewähltem Read und deaktiviertem Write und Delete

Verbinden Sie Ihren bevorzugten AI‑Assistenten

Für einen Arbeitsbereich auf app.azumuta.com verwenden Sie diese Einstellungen:

Einstellung Wert
Connection type Remote MCP using Streamable HTTP
Server URL https://mcp.azumuta.com/mcp
Header name Authorization
Header value Bearer <AZUMUTA_API_KEY>

Ersetzen Sie <AZUMUTA_API_KEY> durch Ihren API‑Schlüssel. Lassen Sie das Leerzeichen nach Bearer stehen. Diese Verbindung verwendet einen API‑Schlüssel, nicht eine Azumuta‑Browseranmeldung.

Verwenden Sie einen Schlüssel aus der passenden Umgebung. Ein Sandbox‑Schlüssel verbindet nicht mit der Produktion. Für eine andere Umgebung verwenden Sie deren bestätigten MCP‑Endpunkt.

Beispiel: Verbindung in Cursor

  1. Öffnen Sie Cursor Settings.
  2. Öffnen Sie Customize.
  3. Wählen Sie MCPs.
  4. Wählen Sie New MCP Server. Cursor öffnet die benutzerbezogene mcp.json‑Konfigurationsdatei.
  5. Fügen Sie den Eintrag azumuta unten innerhalb von mcpServers hinzu. Belassen Sie vorhandene Servereinträge.
  6. Ersetzen Sie <AZUMUTA_API_KEY> durch Ihren dedizierten Schlüssel.
  7. Speichern Sie die Datei.
  8. Kehren Sie zu Customize → MCPs zurück.
  9. Öffnen Sie die Azumuta‑Servereinstellungen.
  10. Falls die Verbindung deaktiviert ist, aktivieren Sie sie.
  11. Prüfen Sie, ob die Verbindung Connected anzeigt und die erwarteten Tools auflistet.
{
  "mcpServers": {
    "azumuta": {
      "url": "https://mcp.azumuta.com/mcp",
      "headers": {
        "Authorization": "Bearer <AZUMUTA_API_KEY>"
      }
    }
  }
}

Die benutzerbezogene Datei ist ~/.cursor/mcp.json. Sie kann diese Verbindung projektübergreifend verfügbar machen. Geben Sie keinen echten Schlüssel in einer freigegebenen Projektkonfiguration, einem Repository, Prompt oder Screenshot an. Cursor unterstützt außerdem Verweise auf Umgebungsvariablen in Header‑Werten; siehe Cursor’s MCP documentation.

Cursor zeigt die Azumuta‑Verbindung als Verbunden an und listet die Lese‑Tools auf

Verbindung überprüfen

In der abgebildeten Cursor‑Version erlaubt der Agent‑Modus diese MCP‑Aufrufe. Der Ask‑Modus kann sie blockieren. Beschränken Sie die Anfrage auf Azumuta MCP und prüfen Sie die verwendeten Tools. Andere Agent‑Tools können Schreibzugriff haben.

  1. Starten Sie ein neues Gespräch mit Ihrem AI‑Assistenten.
  2. Geben Sie ein: Verwenden Sie Azumuta MCP, um fünf Arbeitsanweisungen aufzulisten. Geben Sie deren Namen und IDs an.
  3. Falls der Client um Freigabe bittet, prüfen Sie das Tool und seine Argumente, bevor Sie das Lesen genehmigen.
  4. Vergleichen Sie die zurückgegebenen Arbeitsanweisungen mit dem ausgewählten Azumuta‑Arbeitsbereich.

Diese Überprüfung erfordert Work instructions: Read. Eine leere Liste bedeutet nicht zwangsläufig, dass die Verbindung fehlgeschlagen ist. Prüfen Sie die Tool‑Antwort und ob der Arbeitsbereich zugängliche Arbeitsanweisungen enthält.

Fahren Sie fort mit Beispiel‑Fragen und Einschränkungen.

Verbindungsprobleme

Symptom Prüfen
Authentication error Prüfen Sie Endpunkt, passende Umgebung, API‑Schlüssel und den Bearer‑Header. Geben Sie den Schlüssel niemals in einer Support‑Nachricht an.
Access denied or no expected tools Prüfen Sie den Beta‑Zugang und die expliziten Read‑Scopes des Schlüssels. Nach Änderungen an den Scopes erneut verbinden oder die Tool‑Liste aktualisieren.
A record cannot be found Prüfen Sie Namen oder ID und den vom Schlüssel ausgewählten Arbeitsbereich.
The response is too large or incomplete Eingrenzen Sie die Anfrage. Geben Sie einen Datensatz, Filter oder eine kleine Anzahl an Ergebnissen an. Fragen Sie, ob weitere Seiten vorhanden sind.

Verbindung trennen oder Zugang widerrufen

Um die Verbindung in einem Client zu beenden, deaktivieren oder entfernen Sie dort den Azumuta MCP‑Eintrag. Dies macht den API‑Schlüssel nicht ungültig.

Um den Schlüssel zu widerrufen:

  1. Gehen Sie in Azumuta zu Management → Devices → API.
  2. Öffnen Sie das Zeilenmenü für das dedizierte API‑Gerät.
  3. Wählen Sie Delete device.
  4. Bestätigen Sie die Löschung.

Die Löschung des Geräts macht dessen Schlüssel für alle Integrationen, die ihn verwenden, ungültig. Stellen Sie sicher, dass das Gerät nicht geteilt wird, bevor Sie es löschen. Der Widerruf entfernt nicht die bereits an ein AI‑Gespräch weitergegebenen Daten.

Auf dieser Seite