PixAtlas für Claude und andere KI-Assistenten

Mit dem PixAtlas-Konnektor arbeitet dein KI-Assistent direkt mit deiner digitalen Baustellen- und Gebäudeakte. Er findet Dokumente und Fotos, fasst Regieberichte und Protokolle zusammen, nennt offene Mängel und legt auf Wunsch Ordner an oder sortiert Dateien ein – immer nur mit den Rechten, die du in PixAtlas selbst hast.

An English summary follows at the end of this page.

Was ist PixAtlas?

PixAtlas ist die digitale Baustellen- und Gebäudeakte für Bau-, Handwerks- und Hausverwaltungsbetriebe. Mitarbeitende erfassen auf der Baustelle mit der iPhone-App Fotos, Regieberichte, Protokolle, Scans und 3D-Scans; das Büro arbeitet mit diesen Daten in der Web-App unter atlas.pixgruppe.de.

Die Daten sind so aufgebaut: Organisation › Cluster (z. B. Kunde, Region oder Bestand) › Standort bzw. Gebäude (Baustelle, Objekt) › Projekt. Fast alle Dokumente und Fotos liegen in der Bibliothek des jeweiligen Standorts.

Was der Konnektor kann

Der Konnektor ist ein entfernter MCP-Server (Model Context Protocol) unter

https://api.pixgruppe.de/mcp/pixatlas

Für Fragen über alle Baustellen hinweg nutzt der Assistent organisationsweite Werkzeuge (z. B. find_documents, list_site_reports, find_annotations), statt jede Bibliothek einzeln zu öffnen. Die vollständige technische Beschreibung der Werkzeuge findest du unter PixAtlas MCP agents.

Voraussetzungen

• Ein PixAtlas-Konto mit aktuellem Zugang zu mindestens einer Organisation – als Mitglied oder über eine persönliche Cluster-Freigabe.
• Die Organisation hat einen Pro- oder Unlimited-Tarif. Nur diese Tarife schalten KI-Verbindungen frei; Free, Lite und andere Tarife nicht. Ein Tarif in einer Organisation schaltet keine andere Organisation frei.
• Die Nutzung von KI-Verbindungen (Berechtigung McpUse) ist dir nicht entzogen. Sie ist für berechtigte Nutzer standardmäßig erlaubt; Administratoren deiner Organisation können sie für einzelne Personen sperren.
• Ein KI-Assistent, der entfernte MCP-Server über HTTP mit OAuth-Anmeldung unterstützt, z. B. claude.ai, Claude Desktop oder Claude Code.

Findet die Freigabeseite keine passende Organisation, zeigt sie „Keine passende Organisation gefunden. Erforderlich sind ein Pro- oder Unlimited-Tarif und ein aktueller Zugang.“

Verbinden

claude.ai und Claude Desktop

1. Öffne in Claude die Konnektoren (Einstellungen › Konnektoren).
2. Wähle PixAtlas im Verzeichnis und klicke auf Verbinden. Ist PixAtlas dort (noch) nicht gelistet, füge einen benutzerdefinierten Konnektor hinzu: Name PixAtlas, URL https://api.pixgruppe.de/mcp/pixatlas. Eine Client-ID oder ein Secret brauchst du nicht.
3. Claude öffnet die PixAtlas-Anmeldung. Melde dich mit deinem PixAtlas-Konto an (inklusive Zwei-Faktor-Abfrage, falls aktiv). Die Anmeldung läuft auf der eigenen Adresse auth.atlas.pixgruppe.de; du musst dich dort eventuell auch dann anmelden, wenn die Web-App schon geöffnet ist.
4. Triff deine Auswahl auf der Freigabeseite und klicke auf Verbinden.
5. Aktiviere den Konnektor im Chat (Werkzeug-Menü) und stelle eine erste Frage, z. B. „Welche Standorte gibt es in meiner Organisation?“.

Menünamen in Claude können sich ändern; maßgeblich ist die Hilfe von Anthropic zu Konnektoren.

Claude Code

claude mcp add --scope user --transport http pixatlas https://api.pixgruppe.de/mcp/pixatlas

Starte danach Claude Code (neu), gib /mcp ein, wähle pixatlas und starte die Anmeldung. Der Browser öffnet die PixAtlas-Anmeldung und die Freigabeseite; danach stehen die Werkzeuge in der Sitzung zur Verfügung.

Andere MCP-Clients

Trage in deinem Client einen entfernten HTTP-MCP-Server (Streamable HTTP) mit der Adresse https://api.pixgruppe.de/mcp/pixatlas ein. Die Anmeldung erfolgt per OAuth 2.1 mit PKCE; der Client findet alle Anmeldedaten selbst über /.well-known/oauth-protected-resource/mcp/pixatlas und registriert sich automatisch (dynamische Client-Registrierung). Gib niemals dein Passwort, Browser-Cookies oder Zugangstoken in Prompts oder Konfigurationsdateien ein.

Einfacher geht es aus PixAtlas heraus: Einstellungen › KI-Verbindungen › Prompt kopieren erzeugt eine Schritt-für-Schritt-Anleitung, die du deinem Assistenten schickst.

Die Freigabeseite

Bei jeder neuen Verbindung entscheidest du selbst, worauf der Assistent zugreifen darf:

• Organisationen – wähle eine oder mehrere Organisationen aus, für die KI-Verbindungen freigeschaltet sind.
• Zugriff – „Nur lesen“ ist vorausgewählt. „Lesen und schreiben“ erlaubt unterstützte Aktionen im Rahmen deiner aktuellen Berechtigungen. Chats, Kameras und Kommentare bleiben immer schreibgeschützt.
• Zusätzliche Bereiche (optional) – standardmäßig ausgeschaltet; wähle nur, was dein Assistent wirklich braucht:
  • Berichte (Web-App)
  • Kontakte (Adressbuch)
  • Whiteboards
  • Mitglieder und Gruppen
  • Einstellungen und Branding
  • Tarif, Nutzung und Abrechnungsübersicht (nur lesen)
  • Externe Freigabelinks (nur mit „Lesen und schreiben“)
  • Berechtigungsprotokoll (nur lesen)
  • Persönliche Kontaktdaten (E-Mail, Telefon, Adresse, Notizen) – ohne diese Freigabe liefert PixAtlas Namen und Benutzernamen, aber keine E-Mail-Adressen, Telefonnummern, Anschriften von Personen oder Kontaktnotizen.
• Ausführungsmodus – „Mit mir“ (vorausgewählt): Wenn eine Bestätigung nötig ist, fragt der Assistent bei dir nach. „Selbstständig“: Der Assistent hält an, sobald eine Bestätigung nötig wäre; solche Aktionen führt er nie ohne dich aus.

Nie möglich, auch nicht mit zusätzlichen Bereichen: Zahlungsmittel und Abonnement verwalten, Kapazitäten oder Tarifrichtlinien ändern, Berechtigungen verwalten oder weitergeben, persönliche Zugangstokens nutzen, Mitglieder entfernen und Pipeline-Skripte verwalten.

Die Freigabe begrenzt den Zugriff, sie erweitert ihn nie: Der Assistent sieht und tut höchstens, was du in PixAtlas selbst sehen und tun darfst. Jede Anfrage wird live gegen deine aktuellen Berechtigungen, den Tarif und die Freigabe geprüft. Willst du später mehr freigeben (z. B. Schreiben statt Lesen), trennst du die Verbindung und verbindest neu.

Verbindung trennen

1. Öffne in PixAtlas Einstellungen › KI-Verbindungen (direkt öffnen).
2. Unter Deine Verbindungen siehst du jede Verbindung mit Namen. Zugriffsdetails zeigt Organisationen, Lese-/Schreibzugriff und Ablaufdatum.
3. Klicke auf Trennen und bestätige mit Jetzt trennen.

Die Verbindung verliert ihren Zugriff sofort, bei der nächsten Anfrage. Das Entfernen des Konnektors in Claude allein widerruft die Freigabe in PixAtlas nicht – trenne die Verbindung zusätzlich in PixAtlas. Eine Verbindung läuft außerdem spätestens 30 Tage nach der Freigabe ab; danach meldest du dich im Assistenten neu an. Auch nach Verlust des Tarifs kannst du deine Verbindungen weiterhin ansehen und trennen.

Beispiel-Prompts

Grenzen

• Keine Zahlungen. Der Konnektor kann weder Geld bewegen noch Zahlungsmittel, Abonnement oder Tarif ändern. Die optionale Abrechnungsübersicht ist rein lesend.
• Löschen nur mit Bestätigung. Löschen und andere folgenreiche Aktionen erfordern deine ausdrückliche Bestätigung im Assistenten. Im Modus „Selbstständig“ oder in Clients ohne Bestätigungsdialog werden solche Aktionen abgelehnt; führe sie dann in PixAtlas selbst aus.
• Ordnen ohne zusätzliche PixAtlas-Bestätigung. Dateien zwischen Ordnern derselben Bibliothek verschieben sowie normale Ordner samt Inhalt umbenennen oder verschieben funktioniert auch im Modus „Selbstständig“. Dateien, Versionen und Inhalte bleiben erhalten; Schreibrechte am Ausgangs- und Zielpfad werden weiterhin geprüft. Geschützte Berechtigungspfade bleiben gesperrt. Die Zuordnung in eine andere Bibliothek und das Löschen benötigen weiterhin eine Bestätigung. Dein Assistent kann aufgrund seiner eigenen Freigabeeinstellungen dennoch nachfragen.
• Immer lesend: Kameras, Chats (keine Nachrichten senden oder bearbeiten), Kommentare, Regieberichte und Protokolle, Berichte aus der Web-App und Kontakte.
• Keine Rechteverwaltung: Berechtigungen, Mitgliederentfernung und Zugangstokens sind nie über den Konnektor erreichbar.
• Kein Zugriff auf Claude: Der Konnektor liest weder deinen Chatverlauf noch Erinnerungen oder Dateien in Claude; er erhält nur die Werkzeugaufrufe, die der Assistent an PixAtlas sendet.
• Anfragelimits: Derzeit gelten standardmäßig bis zu 300 Anfragen pro Minute und 8 gleichzeitige Anfragen je Nutzer bzw. Verbindung, zusätzlich Limits je Organisation; eine einzelne Anfrage darf höchstens 60 Sekunden dauern. Bei Überschreitung antwortet der Server mit HTTP 429 und einem Retry-After-Hinweis. Die Limits können sich ändern.
• Lange Vorgänge (Uploads, Modellberechnungen, Texterkennung, Versionen veröffentlichen) laufen im Hintergrund; der Assistent fragt den Status ab, statt auf das Ergebnis zu warten.
• Verschlüsselte Chats und deren Anhänge kann der Konnektor nicht lesen.

Daten und Datenschutz

• Was PixAtlas verarbeitet: dein PixAtlas-Konto, die Verbindung (Name des Assistenten, gewählte Organisationen, Zugriff, zusätzliche Bereiche, Ausführungsmodus, Erstellungs-, Ablauf- und Trennungszeitpunkt), OAuth-Token sowie die Werkzeugaufrufe. Zugangstoken gelten 5 Minuten, Verbindungen höchstens 30 Tage.
• Protokolle: Betriebsprotokolle und Metriken enthalten keine Werkzeug-Argumente, Dokumentinhalte, Zugangstoken oder Download-Links. Bei einem Fehler erhält der Assistent eine Fehler-ID (correlationId), die im Serverprotokoll mit dem Fehlercode verknüpft ist – nenne sie dem Support. Schreibende Aktionen werden mit deinem Benutzer und der Verbindung als Urheber nachvollziehbar gespeichert.
• Weitergabe an deinen KI-Anbieter: Alles, was der Assistent über den Konnektor abruft, wird an den von dir gewählten KI-Anbieter (z. B. Anthropic) übermittelt und dort nach dessen Bedingungen verarbeitet. Auf diese Verarbeitung hat die PixGruppe keinen Einfluss.
• Persönliche Kontaktdaten werden nur übermittelt, wenn du „Persönliche Kontaktdaten“ ausdrücklich freigibst.
• Speicherort: PixAtlas wird auf eigener Infrastruktur in einem deutschen Rechenzentrum betrieben.
• Widerruf: jederzeit unter Einstellungen › KI-Verbindungen › Trennen.

Die vollständige Datenschutzerklärung findest du unter pixgruppe.de/datenschutz.

Support

Fragen und Probleme mit dem Konnektor: info@pixgruppe.de – weitere Kontaktwege unter pixgruppe.de/kontakt. Gib bei Fehlern bitte an: verwendeter Assistent und Version, ungefähre Uhrzeit, den Prompt und – falls angezeigt – die Fehler-ID (correlationId). Schicke niemals Passwörter oder Zugangstoken.

English summary

The PixAtlas connector lets Claude and other MCP clients work with PixAtlas, the digital construction-site and building record used by construction, trades and property-management companies. Server URL: https://api.pixgruppe.de/mcp/pixatlas (remote MCP over HTTP, OAuth 2.1 with PKCE and dynamic client registration – no client ID needed).

Requirements: a PixAtlas account with current access to an organization on the Pro or Unlimited plan (only these plans enable AI connections), and a client that supports remote MCP servers with OAuth.

Connect: in claude.ai or Claude Desktop, open Settings › Connectors, choose PixAtlas and click Connect (or add a custom connector with the URL above). In Claude Code run claude mcp add --scope user --transport http pixatlas https://api.pixgruppe.de/mcp/pixatlas, then /mcp to sign in. Sign in with your PixAtlas account (including MFA) on auth.atlas.pixgruppe.de.

Consent page: choose organizations; read-only is preselected, read and write is optional; optional areas (reports, contacts, whiteboards, members, settings, usage, external share links, permission audit, personal contact details) are off by default; execution mode “with me” (default) or “autonomous” (stops whenever confirmation is needed). Payments, subscriptions, permission management, access tokens and removing members can never be delegated. The assistant never gets more than your own live PixAtlas permissions.

Disconnect: PixAtlas Settings › KI-Verbindungen › Trennen. Revocation takes effect on the next request. Connections expire after at most 30 days; access tokens after 5 minutes.

Example prompts: “Show me the document tree of building Musterstraße 12” (get_document_tree), “Who filed the latest time-and-material report?” (list_site_reports), “Which defects are still open at site Lindenhof?” (find_annotations), “Read the photo documentation from 2 October” (find_documents, read_document_text), “Create a folder ‘Abnahme’ at site Lindenhof” (create_library_folder, write).

Limits: no payments; deletions and other consequential actions always require your confirmation in the client; cameras, chats, comments, site reports and contacts are read-only; default limits of 300 requests per minute and 8 concurrent requests per user/connection, 60-second request deadline (HTTP 429 with Retry-After).

Privacy: PixAtlas stores connection metadata, OAuth tokens and attributed write receipts; operational logs exclude tool arguments, content and tokens. Everything the assistant reads is sent to the AI provider you chose (e.g. Anthropic) and processed under that provider's terms. Personal contact details are shared only with explicit opt-in. PixAtlas runs on its own infrastructure in a German data center. Privacy policy: pixgruppe.de/datenschutz.

Support: info@pixgruppe.de. Include the client and version, the time, the prompt and any correlationId – never passwords or tokens.