AI-Client verbinden

Pural betreibt einen MCP-Server. Jeder Client, der das Model Context Protocol spricht — Claude Code, Claude Desktop oder ein anderer MCP-Client — kann sich mit deinem Workspace verbinden und darin an Angeboten arbeiten.

Der Endpunkt

Trage Pural in deinem Client als MCP-Server mit dem Endpunkt /api/mcp deiner Pural-Installation ein, zum Beispiel https://app.pural.io/api/mcp.

Dein Client öffnet ein Browserfenster, du meldest dich wie gewohnt bei Pural an, und eine Zustimmungsseite nennt die Anwendung und die angefragten Berechtigungen. Nach dem Bestätigen landest du verbunden im Client.

Berechtigungen

Berechtigungen werden pro Ressource vergeben, und die Zustimmungsseite nennt die angefragten:

Berechtigung	Erlaubt
Angebote lesen	Angebote, Abschnitte, Vorlagen und Blöcke auflisten und lesen
Angebote schreiben	Angebote anlegen sowie Abschnitte hinzufügen, ändern, umsortieren und entfernen — auch Preis- und Annahme-Abschnitte
Kunden lesen	Die Kundenliste durchsuchen und einen Kundendatensatz lesen
Kunden schreiben	Einen neuen Kunden anlegen

Kundenkontakte — die einzelnen Personen und ihre Daten — sind über MCP auf keiner Berechtigungsstufe erreichbar. Ein Assistent kann ein Unternehmen an ein Angebot hängen, aber nicht die Personen dort lesen.

Was eine KI nie kann

Manches ist über MCP bewusst unerreichbar, egal was der Assistent versucht und welche Berechtigungen erteilt wurden:

• E-Mails senden. Der Versand bleibt eine Entscheidung, die du in der App triffst. Ein Assistent liest Dokumente, die er nicht selbst geschrieben hat — er soll sie deshalb nicht auch an deinen Kunden schicken können.
• Dateien hochladen. Er kann ein Stockfoto oder ein vorhandenes Asset platzieren, aber keine Datei in deinen Workspace legen.
• Kunden ändern oder löschen. Anlegen ist erlaubt; deine bestehenden CRM-Daten zu verändern nicht.
• Platzhalter einfügen. Siehe Platzhalter.

Die vollständige Liste dessen, was ein Assistent aufrufen kann, steht unter Was ein Assistent kann.

Welchen Workspace sie erreicht

Die Verbindung ist an die Organisation gebunden, in der du bei der Bestätigung angemeldet warst. Gehörst du zu mehreren, verbinde dich aus der richtigen heraus — und verlässt du diese Organisation später, erreicht die Verbindung deren Daten nicht mehr.

Schreibzugriffe brauchen außerdem ein aktives Abo, genau wie in der App: Nach Ablauf der Testphase kann ein Assistent keine Angebote schreiben.

Trennen

Verbundene Anwendungen sind in den Kontoeinstellungen aufgelistet und können dort entzogen werden. Der Entzug verhindert, dass der Client neuen Zugriff bekommt; an dem, was der Assistent bereits geschrieben hat, ändert er nichts.

Achtung: Ein Access-Token, das der Client bereits hält, funktioniert bis zu seinem Ablauf weiter — das kann bis zu eine Stunde nach dem Entzug sein. Wenn eine Verbindung sofort keine Daten mehr erreichen darf, reicht der Entzug allein nicht.