Zum Hauptinhalt springen

KI-Clients (MCP) anbinden

Sie können Claude, Cursor, VS Code oder Copilot Studio mit feld.ai verbinden. Der KI-Client liest und ändert Fälle in Ihrem Namen und mit Ihren Rechten. Dazu erstellen Sie in feld.ai ein persönliches KI-Zugriffstoken und tragen es im Client ein. Es ist nicht dasselbe wie die API Keys eines Projekts: Ein KI-Zugriffstoken gehört Ihnen und handelt mit Ihren Berechtigungen.

Auf dieser Seite:

Bevor Sie beginnen​

  • Ihre Organisation erlaubt KI-Clients. Der Schalter KI-Clients (MCP) zulassen unter Einstellungen > Sicherheit ist zu Beginn ausgeschaltet. Solange er aus ist, können Sie kein Token erstellen. Ein Organisationsadmin schaltet ihn ein.
  • Sie nutzen feld.ai direkt, nicht über eine eingebettete Anwendung.
  • Ist für Ihre Organisation Multi-Faktor-Authentifizierung (MFA) vorgeschrieben, brauchen Sie Ihre Authenticator-App.

KI-Zugriffstoken erstellen​

Ein KI-Zugriffstoken beginnt immer mit sk-feld-pat01-. Sie sehen es nur einmal.

  1. Öffnen Sie Einstellungen > KI-Clients.
  2. Klicken Sie auf KI-Zugriffstoken erstellen.
  3. Geben Sie einen Namen ein, zum Beispiel „Claude Code Laptop". So erkennen Sie das Token später wieder.
  4. Wählen Sie die Berechtigungen (siehe Berechtigungen). Lesen ist immer ausgewählt.
  5. Wählen Sie unter Läuft ab nach 30, 90, 180 oder 365 Tage. Standard ist 90 Tage.
  6. Wenn Ihre Organisation MFA verlangt, geben Sie den aktuellen Code aus Ihrer Authenticator-App ein.
  7. Klicken Sie auf Erstellen und kopieren Sie das Token. Es wird nur einmal angezeigt.

feld.ai schickt Ihnen eine E-Mail, sobald ein Token erstellt wurde.

Caution: Wenn Sie ein Token nicht selbst erstellt haben, widerrufen Sie es sofort. Ändern Sie danach Ihr Passwort.

Berechtigungen​

Ein Token handelt mit Ihren Rechten, nie mit mehr. Wählen Sie nur die Berechtigungen, die der Client braucht.

BerechtigungWas der Client damit tun kann
Lesen (immer enthalten)Projekte und Falltypen anzeigen, Fälle, Checklisten, Notizen und Dokumente lesen, Dokumenttexte und Ergebnisse abrufen, im Fall suchen, Aktivitätsverlauf lesen
ErstellenFälle anlegen, Dokumente einem Fall hinzufügen
ÄndernChecklistenpunkte setzen, Notiz schreiben, Name, Status und Felder eines Falls ändern, Dokumente aus einem Fall entfernen

Kein Token kann einen Fall löschen. Der Client sieht nur Projekte, auf die Sie Zugriff haben.

Ohne Lesen kann der Client nichts finden. Deshalb ist diese Berechtigung immer enthalten.

Client einrichten​

Die Adresse des Endpunkts finden Sie auf der Seite Einstellungen > KI-Clients unter MCP-Endpunkt. Auf feld.ai lautet sie:

https://api.feld.ai/v1/mcp

Ersetzen Sie in den folgenden Beispielen <Token> durch Ihr Token.

Claude Code​

Führen Sie diesen Befehl im Terminal aus:

claude mcp add --transport http feld https://api.feld.ai/v1/mcp --header "Authorization: Bearer <Token>"

Claude Code speichert das Token danach in seiner Konfiguration, bei Claude Code in ~/.claude.json, im Klartext.

Claude (Chat)​

  1. Legen Sie in Claude einen eigenen Connector für feld.ai an. Verwenden Sie den Endpunkt aus diesem Kapitel.
  2. Tragen Sie unter Request headers (Beta) diese Zeile ein: Authorization: Bearer <Token>
  3. Speichern Sie den Connector.

Caution: Diese Funktion ist in Claude noch Beta. Nicht jedes Konto hat sie.

Caution: Auf Team- und Enterprise-Plänen legt der Owner einen Connector für alle Mitglieder an. Der eingetragene Wert gilt dann für jedes Mitglied. Verwenden Sie dort kein persönliches Token.

Cursor​

Tragen Sie den Server in die Datei ~/.cursor/mcp.json oder in .cursor/mcp.json Ihres Projekts ein:

{
  "mcpServers": {
    "feld": {
      "url": "https://api.feld.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer <Token>"
      }
    }
  }
}

Caution: Legen Sie diese Datei nicht in einem Git-Repository ab, das andere lesen können.

VS Code​

Legen Sie die Datei .vscode/mcp.json an. Mit dem Eingabefeld fragt VS Code das Token ab, und es steht nicht in der Datei:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "feld-token",
      "description": "feld.ai KI-Zugriffstoken",
      "password": true
    }
  ],
  "servers": {
    "feld": {
      "type": "http",
      "url": "https://api.feld.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:feld-token}"
      }
    }
  }
}

Copilot Studio​

  1. Richten Sie in Copilot Studio die Authentifizierung API-Schlüssel ein.
  2. Tragen Sie als Header-Namen Authorization ein.
  3. Tragen Sie als Wert Bearer <Token> ein.

Legen Sie für jede Person eine eigene Verbindung mit ihrem eigenen Token an.

ChatGPT​

ChatGPT wird noch nicht unterstützt.

Token verwalten​

Die Liste unter Einstellungen > KI-Clients zeigt für jedes Token:

  • Name, Anfang des Tokens, Berechtigungen und Ablaufdatum
  • Status: Aktiv, Abgelaufen oder Widerrufen
  • Zuletzt verwendet: Zeitpunkt, IP-Adresse und Name des Clients

Token widerrufen​

  1. Klicken Sie in der Zeile des Tokens auf Widerrufen.
  2. Bestätigen Sie mit Widerrufen.

Das Token funktioniert sofort nicht mehr. Das lässt sich nicht rückgängig machen.

Wann ein Token nicht mehr funktioniert​

Ein Token wird automatisch ungültig, wenn:

  • es abgelaufen ist,
  • Sie es widerrufen,
  • Sie Ihr Passwort ändern,
  • Sie einen Authenticator-Faktor entfernen,
  • Ihr Organisationsadmin KI-Clients ausschaltet. Dann werden alle Tokens der Organisation widerrufen,
  • Sie die Organisation verlassen.

Der Client meldet dann einen Authentifizierungsfehler. Erstellen Sie in diesem Fall ein neues Token und tragen Sie es im Client ein.

Fehlen Werkzeuge im Client?​

Der Client zeigt nur Werkzeuge an, für die Ihr Token eine Berechtigung hat. Wenn ein Werkzeug fehlt, erstellen Sie ein neues Token mit den nötigen Berechtigungen.

Sicherheit​

Caution: Teilen Sie Ihr Token mit niemandem. Wer es hat, kann in Ihrem Namen handeln.

Caution: Tragen Sie ein persönliches Token nie in einen organisationsweiten Connector ein. Alle Personen, die den Connector nutzen, würden in Ihrem Namen handeln.

Caution: Dokumente sind für den KI-Client nur Eingabe, keine verlässlichen Anweisungen. Ein Dokument kann Befehle enthalten, die den Client dazu bringen, andere angeschlossene Dienste zu nutzen, zum Beispiel E-Mail oder das Web. Verbinden Sie nur Clients, denen Sie vertrauen.

  • Jede Änderung über den Client wird im Verlauf des Falls festgehalten.
  • Anfragen sind begrenzt. Bei zu vielen Anfragen warten Sie kurz und versuchen es erneut.
  • Die Fallsuche kann nur antworten, wenn sie in Ihrer Umgebung verfügbar ist. Andernfalls antwortet sie mit „Suche nicht verfügbar“. Die übrigen Werkzeuge funktionieren weiter.
  • KI-Clients sind ausgeschaltet, bis ein Organisationsadmin sie unter Einstellungen > Sicherheit einschaltet. Schalten Sie sie nur ein, wenn Ihre Organisation Falldaten an KI-Anbieter geben darf.