Skip to content

Alle Artikel

MCP-Agentenzugriff

Emperor hat einen MCP-Server (Model Context Protocol). Ein KI-Agent wie Cursor oder ein anderer MCP-Client kann darüber Daten des Workspace lesen und ändern. Adminrechte sind nicht nötig: Jeder Benutzer richtet das im eigenen Profile ein.

Token erstellen

  1. Benutzermenü → Profile → MCP Agent Access.
  2. Unter Create token einen Name eingeben (z. B. Cursor laptop).
  3. Scopes wählen (siehe unten). Standard ist nur Lesen.
  4. Create token klicken.
  5. Token kopieren. Er hat die Form emp_<id>.<secret> und wird nur einmal angezeigt. Wie ein Passwort aufbewahren.

Ein Token:

  • handelt als Sie, mit nicht mehr Rechten als Ihr Konto im Workspace;
  • gilt nur im Workspace, der beim Erstellen aktiv war;
  • läuft nach 90 Tagen ab (Spalte Expires);
  • funktioniert nicht mehr nach Revoke oder ohne Zugriff auf den Workspace.

Edit scopes ändert die Scopes eines bestehenden Tokens. Das Secret bleibt gleich, der Client funktioniert weiter.

Scopes

Lese-Scopes sind standardmäßig aktiv. Schreib-Scopes nur aktivieren, wenn der Agent Einträge anlegen oder ändern soll.

  • signals:read — Marketing-Signale
  • calendar:read / calendar:write — Content-Kalender
  • content-marketing:read / content-marketing:write — Kampagnen, Pläne, Aufgaben, Sales-Funnels
  • content-optimization:read / content-optimization:write — SEO-Keywords, Search Console, Site-Scans, Optimierungsberichte
  • development:read / development:write — Projekte, Repositories, Geschäftsmodelle
  • youtrack:read / youtrack:write — YouTrack-Gantt
  • crm:read / crm:write — Leads, Opportunities, Kontakte, Organisationen
  • crm:delete — endgültige CRM-Löschung (getrennt von crm:write)
  • finance:read / finance:write — Budgets und Transaktionen
  • facilities:read / facilities:write — Facilities und Sicherheitsberichte
  • settings:read — Einstellungen lesen (kein Schreib-Scope)

Secrets, OAuth-Zugangsdaten, Token-Verwaltung und Projektlöschung sind über MCP nie verfügbar.

Client verbinden

Der MCP-Endpunkt ist der Emperor-MCP-Server unter /mcp (Port 4477 auf dem Emperor-Host, sofern Ihr Administrator keine andere Adresse veröffentlicht hat). MCP Agent Access zeigt die Adresse Ihrer Installation.

Token als Bearer-Header senden. Beispiel für Cursor (.cursor/mcp.json oder globale MCP-Einstellungen) und andere Clients mit mcpServers:

{
  "mcpServers": {
    "emperor": {
      "url": "https://<emperor-host>:4477/mcp",
      "headers": {
        "Authorization": "Bearer emp_<id>.<secret>"
      }
    }
  }
}

<emperor-host> und Token ersetzen. 401 bedeutet: Token falsch, widerrufen oder abgelaufen. 403 von einem Tool: Scope fehlt oder Ihre Rolle erlaubt die Aktion nicht.

CRM-Einträge löschen

Diese Werkzeuge erwarten die UUID des Eintrags als id:

  • delete_crm_lead löscht den Lead, seine Kontakte, Interaktionen, Opportunities und deren Positionen. Verknüpfte Projekte bleiben erhalten.
  • delete_crm_contact löscht nur den Kontakt, nicht dessen Eigentümer.
  • delete_crm_opportunity löscht die Opportunity samt Positionen; Lead und verknüpftes Projekt bleiben erhalten.
  • delete_crm_person löscht die Person und ihre Kontakte. Verknüpfte Anwendungsidentitäten bleiben ohne Personenverknüpfung erhalten.
  • delete_crm_organization und delete_crm_counterparty löschen auch Kontakte (bei Geschäftspartnern zusätzlich Rollen). Organisationen mit Projekten, Geschäftspartnern oder Workspace-Abrechnung können nicht gelöscht werden. Geschäftspartner mit Leads oder Partnerverknüpfungen in Geschäftsmodellen können ebenfalls nicht gelöscht werden.

Die Löschung ist endgültig. Erforderlich sind crm:delete und das Löschrecht Ihres Kontos im Workspace. crm:write allein erlaubt nur Anlegen und Ändern. Neue Tokens sind standardmäßig schreibgeschützt; aktivieren Sie crm:delete bei Bedarf unter Edit scopes. Bei der Einführung erhalten nur vorhandene Tokens mit crm:write automatisch crm:delete. Reine Lese-Tokens und Tokens mit Schreibrechten nur in anderen Bereichen bleiben unverändert. Secret, Ablaufdatum und Widerrufsstatus bleiben gleich. Entfernen Sie den Scope später, wird er nicht automatisch erneut hinzugefügt.

Die Antwort enthält success: true, data.id und die Zähler in data.deleted: contacts, interactions, opportunities, lineItems und roles. Fehlende Einträge (auch außerhalb des Workspace) liefern 404 / not found, blockierende Verknüpfungen 409. Bei Fehlern wird keine Teillöschung gespeichert; erfolgreiche Löschungen werden im Audit protokolliert.

Artikel