Dokumentation

KI-Agenten verbinden

Geben Sie Claude, ChatGPT oder einem anderen MCP-Client die Tools für Ihre Bestellungen, Rechnungen und Freigaben – angemeldet mit Ihrem eigenen Konto.

Überblick

Der Pleaxy-MCP-Server gibt einem KI-Agenten wie Claude oder ChatGPT Tools für Ihre Bestellungen, Rechnungen, Wareneingänge und Freigaben. Sie verbinden ihn mit Ihrem eigenen Pleaxy-Konto: Er sieht, was Sie sehen, in den Workspaces, die Sie auswählen, und jede Änderung, die er vornimmt, wird als Ihre erfasst. Entscheidungen bleiben bei Ihnen.

Es gibt zwei Wege, ihn zu verbinden. Eine App, die sich per URL mit MCP-Servern verbindet, etwa claude.ai, die Claude-Apps oder ChatGPT, nutzt den von Pleaxy gehosteten Server – ohne Installation. Ein MCP-Client auf Ihrem Computer, etwa Claude Desktop, Claude Code oder Cursor, kann den Server mit npx selbst ausführen. Beide verbinden sich auf dieselbe Weise: Pleaxy öffnet sich in Ihrem Browser, Sie melden sich an, wählen die Workspaces aus und erlauben den Zugriff.

Eine App per URL verbinden

Fügen Sie in den Connector-Einstellungen Ihrer App einen benutzerdefinierten Connector mit dieser Adresse hinzu. Sie müssen keine Client-ID und keinen Schlüssel eingeben: Die App registriert sich selbst bei Pleaxy.

connector URL
https://mcp.pleaxy.ai/mcp
  1. Verbinden. Die App öffnet Pleaxy in Ihrem Browser. Melden Sie sich wie gewohnt an: mit Passwort, Passkey oder dem Single Sign-on Ihres Unternehmens.
  2. Workspaces auswählen. Pleaxy zeigt, welche App anfragt und wohin sie Sie zurückleitet. Wählen Sie die Workspaces aus, die der Agent nutzen darf, und klicken Sie auf „Erlauben“.
  3. Nutzen. Fragen Sie zurück in der App nach Ihren Bestellungen oder Rechnungen. Die App hält die Verbindung; Sie müssen sich 30 Tage lang nicht erneut anmelden.

Auf Ihrem Computer ausführen

Der Server ist auf npm als pleaxy-mcp verfügbar und benötigt Node.js 22.18 oder neuer. Melden Sie ihn einmal in einem Terminal an: Pleaxy öffnet sich in Ihrem Browser, wo Sie sich anmelden, die Workspaces auswählen und den Zugriff erlauben.

shell
export PLEAXY_API_BASE_URL="https://api.pleaxy.ai"
npx -y pleaxy-mcp login     # opens Pleaxy: sign in, tick the workspaces, Allow
npx -y pleaxy-mcp whoami    # who the server acts as, and its workspaces
npx -y pleaxy-mcp logout    # disconnects it

Fügen Sie ihn dann der Konfiguration Ihres MCP-Clients hinzu. Ohne gesetzten API-Schlüssel handelt der Server in Ihrem Namen. Die Anmeldung wird auf Ihrem Computer gespeichert, nur für Sie lesbar, und jeder MCP-Client dort, der den Server ausführt, nutzt sie gemeinsam.

mcp config · json
{
  "mcpServers": {
    "pleaxy": {
      "command": "npx",
      "args": ["-y", "pleaxy-mcp"],
      "env": {
        "PLEAXY_API_BASE_URL": "https://api.pleaxy.ai"
      }
    }
  }
}

Workspaces

Ein Agent nutzt nur die Workspaces, die Sie beim Verbinden ausgewählt haben. Jedes Tool erwartet einen workspace, und list_workspaces nennt sie, sodass eine Verbindung für alle funktioniert. Ist nur ein Workspace erlaubt, nutzt der Agent diesen.

Um einen Workspace hinzuzufügen oder zu entfernen, verbinden Sie den Agenten erneut und wählen andere Workspaces aus. Verlieren Sie in Pleaxy den Zugriff auf einen Workspace, verliert ihn auch der Agent.

Was ein Agent tun kann

Ein Agent kann alles lesen und entwerfen, was Ihre Rolle erlaubt: Bestellungen und Rechnungen finden, KI-Ausgaben prüfen, eine Rechnung abgleichen, eine Bestellanforderung anlegen. Bei Entscheidungen ist das anders. Eine Rechnung freigeben oder ablehnen, eine Abweichung zur Freigabe weiterleiten, eine Zahlung erfassen, eine Bestellung anlegen oder freigeben, einen Wareneingang bestätigen, über ein Leistungserfassungsblatt entscheiden und das Ausgabenlimit bei einem Anbieter festlegen sowie, für einen Lieferanten, bestätigen, dass eine Zahlung eingegangen ist, oder melden, dass sie nicht eingegangen ist: All das wird Ihnen als Agent-Anfrage vorgelegt. Sie bestätigen oder verwerfen jede davon innerhalb von 24 Stunden in Pleaxy, und nichts geschieht, bevor Sie das tun. Eine Bestellung abzulehnen, deren Freigabeschritt Sie nennt, geschieht sofort, genau wie im Pleaxy Assistant.

Ein Agent bestätigt nie seine eigenen Anfragen und kann weder Ihre Sicherheitseinstellungen noch API-Schlüssel oder Workspace-Mitglieder ändern. Pleaxy protokolliert jede Änderung, die ein Agent vornimmt oder anfragt.

Ihre verbundenen Agenten

Pleaxy benachrichtigt Sie jedes Mal, wenn sich ein Agent mit Ihrem Konto verbindet. Unter Sicherheit & Anmeldung → Agents sehen Sie in Pleaxy jeden verbundenen Agenten mit der App, in der er läuft, seinen Workspaces und dem Zeitpunkt der letzten Nutzung, und können jeden einzeln abmelden.

Eine Verbindung gilt 30 Tage. Sie endet früher, wenn Sie den Agenten abmelden, Ihr Passwort zurücksetzen, die Bestätigung in zwei Schritten ausschalten oder aus Pleaxy ausgesperrt werden. Verbinden Sie ihn dann erneut. Sie können bis zu 20 Agenten verbunden haben.

Integrationen mit API-Schlüssel

Für eine Integration, die ohne Person läuft, kann der Server auf Ihrem Computer statt Ihrer Anmeldung einen Workspace-API-Schlüssel verwenden (siehe KI-Agenten (MCP)). Ein Schlüssel handelt in einem Workspace, und Entscheidungen werden ihm verweigert: Dafür ist eine Person nötig. Der gehostete Server akzeptiert keine API-Schlüssel.

Kontakt aufnehmen