Claude mit Holzplaner verbinden

Mit dem Holzplaner-Connector arbeitet Claude direkt an deinen Holzplaner-Projekten: Er liest Bauteile, Stückliste und Hinweise, fügt Objekte wie ein Hochbett oder ein Gartenhaus ein, setzt Verbindungen und behebt Probleme. Jede Änderung erscheint sofort in deinem geöffneten Editor und lässt sich dort rückgängig machen.

Was du brauchst

ein Holzplaner-Konto (kostenlos; im Moment mit Einladung, Warteliste),
Claude (claude.ai, die Desktop-App oder Claude Code) mit Connectors.

Einrichten in claude.ai

Öffne in Claude Einstellungen → Connectors. Ist Holzplaner im Verzeichnis gelistet, wähle es dort aus; sonst „Benutzerdefinierten Connector hinzufügen“.
Gib als Namen Holzplaner und als URL https://holzplaner.app/mcp ein und bestätige.
Wähle Verbinden. Es öffnet sich die Anmeldung von Holzplaner: Melde dich mit deinem Holzplaner-Konto an. Bist du in diesem Browser schon in Holzplaner angemeldet, entfällt dieser Schritt. Ein Token musst du nicht kopieren.
Holzplaner fragt, ob Claude auf dein Holzplaner-Konto zugreifen darf (deine Projekte lesen, Projekte anlegen und ändern), und zeigt, wohin es danach zurückgeht (claude.ai). Wähle Zulassen. Danach ist der Connector verbunden; in Holzplaner steht er auf der Kontoseite unter Verbundene Apps (in der App: Menü → Konto).
Aktiviere Holzplaner in einem Chat über das Werkzeug-Menü, falls er nicht schon aktiv ist.

Claude führt lesende Werkzeuge ohne Rückfrage aus. Vor Werkzeugen, die bestehende Daten ändern oder löschen, fragt Claude dich je nach Einstellung um Erlaubnis.

Claude Code

claude mcp add --transport http holzplaner https://holzplaner.app/mcp, dann in Claude Code /mcp → holzplaner → anmelden: Der Browser öffnet die Anmeldung von Holzplaner, dort anmelden und Zulassen wählen (die Seite weist darauf hin, dass die Antwort an ein Programm auf deinem Computer geht). Alternativ geht ein persönliches Zugriffstoken aus Holzplaner (Kontoseite → Zugriffstokens für Agenten) als Header Authorization: Bearer cpt_….

Beispiele

„Welche Projekte habe ich in Holzplaner?“
„Leg ein Projekt ‚Kinderzimmer‘ an und setz ein Hochbett mit 140 cm Liegefläche hinein.“
„Was kostet das Gartenhaus laut Stückliste, und welches Holz muss ich kaufen?“
„Welche Probleme und Hinweise hat das Gartenhaus? Behebe die, die automatisch gehen.“
„Verschraube alle offenen Kontakte im Bücherregal.“
„Leg unter das Gartenhaus eine Betonplatte von 2,4 × 2,2 m.“
„Bau mir ein Regal 80 × 180 mit 5 Böden in Fichte und zeig mir Stückliste und Preis.“
„Mach den Küchenschrank 80 breit, mit 3 Schubkästen statt der Tür.“
„Setz in die Wand ein Fenster, 1 m breit, 1,5 m vom Anfang.“
„Zeig mir das Bett von schräg oben und die Vorderansicht mit Maßen.“
„Zeig mir das Gartenhaus in 3D und heb das Dach hervor.“
„Schick mir den Werkplan vom Gartenhaus als PDF und die Stückliste als CSV.“
„Setz das Gartenhaus auf ‚außen bewittert‘ und sag mir, was sich beim Holzschutz ändert.“

Werkzeuge

liest ändert nichts · fügt hinzu legt Neues an, Bestehendes bleibt · ändert ändert oder löscht Bestehendes (als neue Version, in der App rückgängig zu machen)

Werkzeug	Art	Was es tut
`list_projects`	liest	Deine Projekte mit Version und letzter Änderung.
`get_project`	liest	Überblick über ein Projekt: Anzahlen, Größe, Gruppen, Materialien, Ebenen.
`list_parts`	liest	Bauteile mit Maßen, Lage und Gruppe; filterbar, seitenweise (50 je Seite).
`get_bom`	liest	Stückliste mit Einkaufsliste, Verbindungsmitteln, Beschlägen, Baustoffen und Preisen.
`get_problems`	liest	Probleme und Hinweise nach Normen, mit automatischer Behebung, wo möglich.
`list_library`	liest	Produkte, Holzarten, Behandlungen, Verbindungsarten, Umgebungen und Beschichtungen.
`list_object_types`	liest	Alles, was sich einfügen lässt, nach Bereich: Möbel (Bett, Hochbett, Tisch, Regal …), Garten (Hochbeet, Zaun, Pergola, Carport, Gartenhaus), Fenster und Türen, Wände, Böden und Decken, Küche, Einrichtung, Beschläge und deine eigenen Objekte – als Überblick mit den wichtigsten Maßen oder ein Typ mit allen Parametern, Einheiten und Auswahlen.
`list_objects`	liest	Die Objekte und Dachflächen eines Projekts mit ihren Parametern, Wand, Öffnungen und Anschlüssen.
`list_fittings`	liest	Beschläge (Topfscharnier, Schubkastenführung, Griff, Bodenträger, Türband) mit Lage und Preis.
`list_catalog`	liest	Die Kataloge: was jede Verbindungsart, jeder Beschlag, jede Dachschicht und jede Bearbeitung tut und welche Parameter sie haben, dazu die Felder der Bibliothek.
`list_profiles`	liest	Deine eigenen Profile (Querschnitte für Stabware) mit Fläche und Gewicht.
`list_drawings`	liest	Die Zeichnungen eines Projekts (Ansichten, Schnitte, Details) mit Maßstab und Einstellungen.
`list_sections`	liest	Die Schnitte eines Projekts mit Lage und Blickrichtung.
`create_project`	fügt hinzu	Legt ein neues, leeres Projekt an, ein Beispielprojekt (Carport, Gartenhaus, Küchenzeile …, wie unter „Neues Projekt“) oder eine Kopie eines vorhandenen (Variante).
`add_part`	fügt hinzu	Fügt ein Bauteil hinzu (Brett, Balken, Platte …).
`draw_surface`	fügt hinzu	Zeichnet eine Fläche (Betonplatte, Estrich, Kies, Pflaster, Dachbahn).
`manage_object`	ändert	Parametrische Objekte: einfügen – Möbel, Carport, Gartenhaus, Küchenschrank, Fenster und alles aus `list_object_types` – (an einem Punkt, eine Wand entlang einer Linie, ein Boden als Umriss, ein Fenster oder eine Tür in einer Wand), Parameter ändern (z. B. Breite und Schubkästen eines Küchenschranks), auflösen, eine Holzrahmenwand mit Fenstern und Türen zeichnen.
`roof`	ändert	Legt eine Dachfläche (Schalung, Lattung, Bahn, Bleche, Rinne) auf Sparren oder ändert sie.
`manage_fitting`	ändert	Setzt, verschiebt oder entfernt Beschläge; ihre Bohrungen entstehen mit.
`edit_parts`	ändert	Verschiebt, dreht, ändert die Maße, löscht, gruppiert Bauteile oder Gruppen oder löst eine Gruppe auf; Ablängen der Enden (Lot-, Traufschnitt); gleichmäßig verteilen; Bearbeitungen an Platten (Bohrung, Lochraster, Nut, Rundnut, Falz, Fase, Ausklinkung). Projekte selbst lassen sich nicht löschen.
`manage_repeat`	ändert	Wiederholungen: anlegen (Anzahl, Abstand, Richtung), ändern, einzelne Plätze auslassen, Kopien als eigene Teile lösen oder die Wiederholung entfernen.
`rename`	ändert	Benennt ein Bauteil, eine Gruppe oder das Projekt um.
`set_properties`	ändert	Setzt Material (Produkt, Holzart, Behandlung, Farbe), Oberfläche, Korrosionsschutz von Stahlteilen, Umgebung oder „tragend“.
`set_connection`	ändert	Setzt die Verbindung zwischen zwei Bauteilen (Schraube, Zapfen, Balkenschuh, Schweißnaht, „Steht auf“ …), auch für alle Kontakte zwischen zwei Gruppen auf einmal; eine abgelehnte Verbindung nennt den Grund.
`manage_drawing`	ändert	Zeichnungen und Pläne: Maße und Texte, Schnitte, Details, Ansichten, Zeichnungen auf Blättern platzieren, eigene Blätter, Planeinstellungen.
`batch`	ändert	Mehrere Änderungen in einem Aufruf, als eine Änderung gespeichert (alles oder nichts).
`fix_problems`	ändert	Wendet die automatischen Behebungen an („Beheben“ in der App).
`manage_library`	ändert	Deine Bibliothek, für alle Projekte: eigene Artikel anlegen, ändern und löschen (z. B. Plattenmaße und Dicken eines Herstellers mit Preisen), eigene Holzarten und Sorten (auch durchgefärbte Werkstoffe), eigene Profile. Rückgängig in der App nimmt Bibliotheksänderungen nicht zurück.
`create_profile`	fügt hinzu	Legt ein eigenes Profil in deiner Bibliothek an (wie `manage_library` `create_profile`).
`send_feedback`	fügt hinzu	Schickt einen Fehlerbericht, Feedback oder eine Idee an das Holzplaner-Team, auf Wunsch mit Modellbild und Projektlink. Claude schickt nur, wenn du es möchtest.
`get_model_image`	liest	Zeigt das Modell als schattiertes 3D-Bild (Blickrichtung wie `set_view`, einzelne Teile oder Gruppen, hervorgehobene Teile).
`get_view_image`	liest	Zeigt eine Ansicht als Strichzeichnung wie im Werkplan: vorne, oben, Seite, Isometrie oder ein Schnitt, mit oder ohne Maße.
`list_sheets`	liest	Listet die Blätter des Werkplans mit Papierformat und Seitenzahl.
`get_sheet_image`	liest	Zeigt ein Blatt des Werkplans als Bild, so wie die App es druckt.
`get_plan_pdf`	liest	Gibt den Werkplan als PDF (alle Blätter oder ausgewählte).
`get_bom_pdf`	liest	Gibt die Stückliste als PDF (A4 hoch).
`get_bom_csv`	liest	Gibt die Stückliste als CSV, wie der CSV-Export der App.
`get_part_dxf`	liest	Gibt Bauteile als DXF für eine CNC oder einen Zuschnittservice: Kontur, Bohrungen, Nuten und Taschen auf eigenen Ebenen.
`show_model`	liest	Zeigt das Projekt als 3D-Modell direkt im Chat (claude.ai, Claude Desktop): drehen, zoomen, Ansichten 3D / Oben / Vorne / Seite, ein Klick auf ein Teil zeigt Name, Maße und Material. Einzelne Teile oder Gruppen lassen sich hervorheben oder allein zeigen.
`get_model_mesh`	liest	Lädt das 3D-Modell für die 3D-Ansicht neu („Neu laden“); nur die 3D-Ansicht ruft es auf.
`set_view`	liest	Ändert die Ansicht im geöffneten Editor (2D/3D, Bestand, Isolieren, Kamera); speichert nichts.
`set_open`	liest	Öffnet oder schließt Türen, Klappen und Schubkästen im geöffneten Editor; speichert nichts.

Grenzen

Claude erreicht nur deine eigenen Projekte und deine Bibliothek.
Projekte lassen sich über den Connector nicht löschen.
Je Zugang höchstens 120 Anfragen pro Minute; je Konto höchstens 30 Änderungen pro Minute.
Große Projekte liefert list_parts seitenweise (50 Bauteile je Seite, bis zu 200 auf Wunsch); get_problems höchstens 50 Probleme und 50 Hinweise je Seite.
Maße sind Millimeter; Namen und Meldungen sind deutsch. Preise sind Shoppreise oder Schätzungen, Normhinweise ersetzen keine Fachplanung oder Statik.
Hat jemand das Projekt in der App geändert, während Claude daran arbeitet, wird eine Änderung mit veralteter Version abgelehnt; Claude liest das Projekt dann neu.

Wenn etwas nicht klappt

Die Anmeldung schlägt fehl oder Claude meldet „nicht autorisiert“: Trenne den Connector in den Claude-Einstellungen und verbinde ihn neu. Prüfe, ob du dich auf holzplaner.app mit demselben Konto anmelden kannst.
Der Connector zeigt noch auf carpenter.kitzmann.me: Holzplaner ist auf holzplaner.app umgezogen; die alte Anmeldung gilt dort nicht mehr. Entferne den Connector in den Claude-Einstellungen und füge ihn mit der URL https://holzplaner.app/mcp neu hinzu.
„project … not found“: Der Projektname muss genau passen (Groß-/Kleinschreibung egal). Die Meldung nennt die vorhandenen Projekte. Ein Projekt, das gerade offline bearbeitet wurde, sieht Claude erst, wenn die App es wieder mit dem Server abgeglichen hat.
„version conflict“: Das Projekt wurde zwischendurch in der App geändert. Claude liest es neu und versucht es erneut.
„too many changes; wait a minute“: Mehr als 30 Änderungen pro Minute. Nach einer Minute geht es weiter.
Eine Änderung soll weg: Jede Änderung von Claude ist in der App ein Schritt, den du mit Rückgängig (⌘Z / Strg+Z) zurücknimmst.
Zugriff beenden: Trenne den Connector in Claude, oder in Holzplaner auf der Kontoseite unter Verbundene Apps → Trennen. Claude muss sich danach neu anmelden. Persönliche Zugriffstokens widerrufst du auf derselben Seite.

Datenschutz und Support

Was Claude von deinen Daten erhält, steht in der Datenschutzerklärung (Abschnitt 8). Fragen, Fehler und Ideen schickst du in der App über Hilfe → Feedback senden (⇧F) oder bittest Claude, sie mit send_feedback an uns zu schicken.