Zum Inhalt

MCP-Server

Verbinden Sie einen KI-Assistenten mit EngineHall. Der gehostete Server liest Ihr Konto und Ihre gespeicherten Projekte auf enginehall.com und arbeitet in Ihren Entwicklungsprojekten. Die lokalen Server prüfen Designdateien auf Ihrem eigenen Rechner.

Gehosteter Server

Über den gehosteten Server liest ein Assistent, was Sie auf enginehall.com sehen: Ihr Konto und Ihren Plan, Ihre Arbeitsbereiche und die gespeicherten Projekte bezahlter Arbeitsbereiche mit Berichten und Befunden. Er beantwortet auch Fragen zu den Regeln und zum Befundformat. In Entwicklungsprojekten liest er offene Punkte, Entscheidungen, Besprechungen und Dokumentation und entwirft und aktualisiert sie in den unten beschriebenen Grenzen. Aus einem Repository, das mit einem Entwicklungsprojekt verbunden ist, liest er Textdateien wie Firmware-Quellen. Er empfängt nie Designdateien und liefert nie Binärdateien.

Server-URL
https://enginehall.com/mcp

Vor der Umbenennung mit https://pcbastudio.com/mcp verbunden? Diese Adresse funktioniert bis zum 30. April 2027. Verbinden Sie sich bis dahin neu mit https://enginehall.com/mcp.

Um einen Designordner zu prüfen, nutzen Sie einen lokalen Server: Lokale Server

Assistenten verbinden

Alle Assistenten nutzen dieselbe URL. Der Assistent registriert sich selbst, schickt Sie zur Anmeldung auf enginehall.com und bittet Sie, den Zugriff zu erlauben.

Claude (Web und Desktop)
Einstellungen, Konnektoren, Benutzerdefinierten Konnektor hinzufügen. URL einfügen, dann Verbinden. In Team- und Enterprise-Plänen fügt ein Inhaber den Konnektor einmal unter Organisationseinstellungen, Konnektoren hinzu, und jedes Mitglied verbindet sein eigenes Konto.
Claude Code
Server hinzufügen, dann in Claude Code /mcp ausführen und Authenticate wählen.
claude mcp add --transport http enginehall https://enginehall.com/mcp
ChatGPT
Einstellungen, Apps, Erweiterte Einstellungen. Entwicklermodus einschalten, dann eine App mit der URL und OAuth-Authentifizierung anlegen.
Codex
Server hinzufügen, dann anmelden:
codex mcp add enginehall --url https://enginehall.com/mcp
codex mcp login enginehall
Cursor
Den Server in Ihre MCP-Konfiguration von Cursor eintragen:
~/.cursor/mcp.json
{
  "mcpServers": {
    "enginehall": { "url": "https://enginehall.com/mcp" }
  }
}
VS Code
Den Server in die MCP-Konfiguration Ihres Arbeitsbereichs eintragen:
.vscode/mcp.json
{
  "servers": {
    "enginehall": { "type": "http", "url": "https://enginehall.com/mcp" }
  }
}

Werkzeuge

Lesewerkzeuge lesen nur. Entwurfswerkzeuge legen Einträge an, die nur Ihre Organisation sieht, und Änderungswerkzeuge bearbeiten offene Punkte, die Ihnen zugewiesen sind oder die Sie angelegt haben, sowie interne Seiten. Jedes Entwurfs- und Änderungswerkzeug liefert zuerst eine Vorschau und ändert nichts. Erst wenn der Assistent es nach Ihrer Freigabe der Vorschau mit confirm: true erneut aufruft, wird die Änderung ausgeführt.

Einen Eintrag mit dem ganzen Projekt teilen, seine Sichtbarkeit ändern, einer Entscheidung zustimmen, eine Besprechung bestätigen, freigeben und Personen einladen: Dafür gibt es kein Werkzeug. Der Assistent gibt Ihnen einen Link, und Sie erledigen es selbst im Browser.

WerkzeugWas es tutZugriffBestätigung nötig
get_accountIhre E-Mail-Adresse, Ihr Anzeigename, Ihre Pläne und die Zahl Ihrer unvollständigen Speicherungen.LesenNein
list_workspacesIhre Arbeitsbereiche mit Plan, Ihrer Rolle, Mitgliederzahl, gespeicherten Projekten und dem, was eine Speicherung enthalten darf.LesenNein
list_saved_projectsGespeicherte Projekte Ihrer Arbeitsbereiche, neueste zuerst, mit Befundzahlen. Filter nach Arbeitsbereich, Name und Status.LesenNein
get_saved_projectEin gespeichertes Projekt: Autor, Optionen, Befundübersicht, Abdeckung sowie Namen und Größen der geprüften Dateien.LesenNein
list_findingsBefunde eines gespeicherten Projekts in Kurzform, gefiltert nach Schweregrad, Regel, Bereich oder Datei.LesenNein
get_findingEin Befund vollständig: Ort, zitierte Belege, Folge und Empfehlung.LesenNein
get_reportDer gespeicherte Bericht als JSON, SARIF, Markdown oder Text.LesenNein
list_rulesDie Prüfregeln mit Schweregrad, Detektor und den Eingaben, die jede braucht.LesenNein
get_ruleEine Regel und warum sie in coverage.skipped stehen kann.LesenNein
get_schemaDas JSON-Schema eines Befunds oder einer Baseline-Datei.LesenNein
get_local_mcp_setupWie Sie die lokalen Server installieren und verbinden.LesenNein
list_projectsIhre Entwicklungsprojekte mit Kürzel, Ihrer Rolle und Organisation.LesenNein
project_overviewEin Entwicklungsprojekt: Organisationen, offene Punkte nach Art und Status, überfällige Punkte, Release-Blocker, Entscheidungen und die letzten Besprechungen.LesenNein
list_open_pointsAufgaben, Fragen und Risiken mit ihren IDs (KEY-A-12), gefiltert nach Art, Status, Verantwortlichem und Sichtbarkeit.LesenNein
get_open_pointEin offener Punkt nach ID: Text, Verantwortlicher, Fälligkeit, Nachweise, Ursprungsbesprechung und Kommentare.LesenNein
list_decisionsEntscheidungen und ADRs mit Status, Datum der Zustimmung und Text.LesenNein
list_meetingsBesprechungen, neueste zuerst, mit Teilnehmenden und Zusammenfassung.LesenNein
get_pageEine Dokumentationsseite als Markdown oder die Liste der Seiten.LesenNein
searchDurchsucht offene Punkte, Entscheidungen, Besprechungen und Seiten eines Projekts.LesenNein
list_repositoriesDie mit einem Projekt verbundenen Repositorys mit Anbieter, URL und Standard-Branch.LesenNein
get_fileEine Textdatei aus einem verbundenen Repository bei einem Branch oder Commit, in der Größe begrenzt.LesenNein
add_open_pointLegt eine Aufgabe, Frage oder ein Risiko an, immer intern für Ihre Organisation.EntwurfJa
commentKommentiert einen offenen Punkt, eine Entscheidung, Besprechung oder Seite. Die Vorschau sagt, wer ihn sieht.EntwurfJa
draft_page_changeFügt einer internen Seite eine Revision hinzu oder legt eine neue interne Seite an. Für eine geteilte Seite liefert es nur einen Vorschlag.EntwurfJa
draft_meeting_summaryLegt eine interne, unbestätigte Besprechung mit Zusammenfassung an.EntwurfJa
propose_decisionLegt eine interne Entscheidung oder ADR mit dem Status vorgeschlagen an.EntwurfJa
update_open_pointÄndert Titel, Text, Verantwortlichen, Fälligkeit oder Status eines offenen Punkts, der Ihnen zugewiesen ist oder den Sie angelegt haben.ÄndernJa
close_open_pointSchließt einen offenen Punkt, der Ihnen zugewiesen ist oder den Sie angelegt haben, mit Abschlussnotiz oder Nachweisen.ÄndernJa
apply_page_changeErsetzt den Text einer internen Seite; abgelehnt, wenn die Seite sich seit dem Lesen geändert hat.ÄndernJa
list_releasesListet die Releases eines Projekts mit Version, Status, Fortschritt der Checkliste und Veröffentlichungsdatum.LesenNein
get_releaseEin Release mit Notes, Commits, Prüflauf, Checkliste, Freigaben je Organisation und dem, was es noch blockiert.LesenNein
draft_releaseLegt einen internen Release-Entwurf auf dem letzten nutzbaren Prüflauf und dessen Commit an, mit der Checkliste des Projekts.EntwurfJa
list_check_runsPrüfläufe eines Entwicklungsprojekts, neueste zuerst: Commit, Quelle, Befunde je Schweregrad und Lücken der Abdeckung.LesenNein
get_check_runEin Prüflauf: Abdeckung und Befunde mit Regel, Schweregrad, Ort und Beleg.LesenNein
list_reviewsDesign-Reviews mit ID, Status, Gegenstand, Urteilen der Prüfer und offenen Diskussionen.LesenNein
get_reviewEin Design-Review: Gegenstand, Prüfer und Urteile, Diskussionen mit ihren Ankern.LesenNein
comment_on_reviewBeginnt eine verankerte Diskussion in einem Design-Review oder antwortet in einer. Kein Urteil; Prüfer geben es auf der Seite.EntwurfJa

Sicherheitsmodell

  • Die App handelt als Sie. Jede Abfrage läuft mit Ihren eigenen Rechten auf enginehall.com. Sie sieht genau die Arbeitsbereiche und gespeicherten Projekte, die Sie im Browser öffnen können, und nichts von anderen Kunden.
  • Die Werkzeuge für gespeicherte Projekte lesen nur. Projekte speichern, erneut prüfen und löschen, Mitglieder einladen und die Abrechnung bleiben im Browser.
  • Was ein Assistent in Entwicklungsprojekten anlegt, bleibt intern für Ihre Organisation, und nichts ändert sich, bevor Sie seine Vorschau freigeben. Ihre Projektrolle gilt weiter: Wer nur lesen darf, kann nichts schreiben, und Prüfende aktualisieren nur offene Punkte, die ihnen zugewiesen sind.
  • Designdateien laufen nie über den gehosteten Server. Ein gespeichertes Projekt wird mit Namen und Größen seiner Dateien beschrieben, nie mit ihrem Inhalt. Einen Designordner prüft ein lokaler Server. get_file liefert nur Textdateien eines verbundenen Repositorys, gelesen mit dessen gespeichertem Token, nachdem Ihr eigener Zugriff geprüft wurde; Binärdateien wie Schaltpläne werden abgelehnt.
  • Das Token, das die App erhält, trägt die Rechte Ihres Kontos auf enginehall.com, nicht nur die der MCP-Werkzeuge. Erlauben Sie den Zugriff nur Apps, denen Sie vertrauen, und widerrufen Sie ihn für Apps, die Sie nicht mehr nutzen.
  • Jeder Werkzeugaufruf wird mit Ihrer Konto-ID, der Client-ID der App und dem Werkzeugnamen protokolliert. Argumente und Ergebnisse werden nicht protokolliert.

Zugriff widerrufen

Ihre Kontoseite listet jede App, der Sie den Zugriff erlaubt haben. Ein Widerruf beendet sofort ihre Sitzungen und Refresh-Tokens, und die App muss Sie erneut fragen, um sich wieder zu verbinden. Verbundene Apps

Grenzen

  • Etwa 120 Werkzeugaufrufe pro Minute je Konto und App. Ein Aufruf über der Grenze liefert einen Fehler, der sagt, wie lange zu warten ist.
  • Listen liefern höchstens 100 Einträge je Aufruf. Mit offset holen Sie die nächste Seite.
  • get_report liefert Darstellungen bis 1.000.000 Zeichen. Größere Berichte lesen Sie mit list_findings und get_finding.
  • get_file liefert Textdateien bis 200.000 Zeichen, aus Dateien von höchstens 5 MB.
  • Zugriffstokens gelten eine Stunde. Die App erneuert sie, solange der Zugriff erlaubt bleibt.

Technische Details

  • Transport: Streamable HTTP, zustandslos. Jede Anfrage erhält eine JSON-Antwort. Es gibt keinen Ereignisstrom, daher antwortet ein GET mit 405.
  • Autorisierung: OAuth 2.1 mit PKCE und dynamischer Client-Registrierung. Discovery: https://enginehall.com/.well-known/oauth-protected-resource/mcp.
  • Protokollversionen: 2025-11-25, 2025-06-18 und 2025-03-26.

Lokale Server

Schaltpläne, CubeMX-Dateien und Firmware werden auf Ihrem Rechner geprüft. Kommandozeile und VS-Code-Erweiterung senden keine Designinhalte. Ihre MCP-Server sind Programme, die Ihr Assistent auf Ihrem Rechner startet. Installieren Sie zuerst enginehall und aktivieren Sie die virtuelle Umgebung, oder geben Sie dem Client den vollständigen Pfad zum Programm enginehall. Installation

enginehall mcpmacOS, Linux, Windows
Prüft einen Projektordner: findet Schaltplan, .ioc und Firmware, führt alle Regeln aus und liefert Befunde mit Belegen und Abdeckung. Werkzeuge: pcba_project_inspect, pcba_review_run, pcba_review_get_finding, pcba_altium_pinmap, pcba_cubemx_inspect, pcba_cubemx_validate.
.mcp.json
{
  "mcpServers": {
    "enginehall": { "command": "enginehall", "args": ["mcp"] }
  }
}
enginehall altium mcpWindows, mit laufendem Altium Designer
Legt Altium-Projekte mit typisierten Operationen an und bearbeitet sie. Jede Änderung wird geplant und vorab gezeigt, nach Ihrer Freigabe mit dem Hash des Plans ausgeführt und gegen die Netzliste geprüft.
.mcp.json
{
  "mcpServers": {
    "enginehall-altium": { "command": "enginehall", "args": ["altium", "mcp"] }
  }
}
enginehall-extensionVS Code und Cursor
Kommt mit der VS-Code-Erweiterung. Liest ein .SchDoc-Blatt (Werkzeuge schdoc_*) und pflegt das Markdown-Projekttagebuch (Werkzeuge tracker_*). Registrieren Sie ihn mit dem Befehl „EngineHall: Set up MCP server for AI chat“.

In Claude Code fügen Sie den Prüfserver so hinzu:

Claude Code
claude mcp add enginehall -- enginehall mcp

Agent-Skills zeigen einem Assistenten, welchen pcba-Befehl er ausführt und wie er das Ergebnis liest. Sie finden sie auf diesen Seiten: Altium, Fusion

Support

Bei Fragen oder wenn eine Verbindung nicht funktioniert, schreiben Sie uns. Senden Sie nie ein Zugriffstoken oder Designdateien. software@newmatik.com