@myhero/mcp-server

MCP-Server für HERO — ermöglicht KI-Tools wie Claude Desktop, Cursor, Claude Code und jedem stdio-MCP-Client das Lesen und Schreiben Ihrer HERO-Dokumente, -Projekte und -Tabellen.

Schnellstart

Fügen Sie ihn zur MCP-Konfiguration Ihres KI-Tools hinzu:

{
  "mcpServers": {
    "hero": {
      "command": "npx",
      "args": ["-y", "@myhero/mcp-server"],
      "env": {
        "HERO_API_KEY": "hero_at_your_token_here"
      }
    }
  }
}

Generieren Sie das Token unter app.myhero.so → Settings → MCP Tokens.

Für eine Schritt-für-Schritt-Anleitung zur Einrichtung mit Claude Desktop, Cursor, Claude Code und anderen, siehe den vollständigen Leitfaden unter myhero.so/mcp-setup.

Was er kann

Dokumente

• Jedes Dokument lesen — vollständiger Inhalt, reiner Text, Metadaten oder nur die Abschnittsüberschriften

• Über alle Ihre Arbeitsbereiche und Projekte hinweg suchen

• Neue Dokumente erstellen, umbenennen, verschieben, duplizieren oder löschen

• Snapshots erstellen, jeden Block in einem Dokument auflisten, zu einem Abschnitt anhand seiner Nummerierung springen

• Chirurgische Bearbeitungen: Ändern Sie einen einzelnen Absatz, eine Überschrift, ein Listenelement oder eine Tabelle, ohne den Rest mit dem vollständigen HERO-Block-Schema neu schreiben zu müssen.

Klauseln & rechtliche Struktur

• Klauseln, Unterklauseln und Definitionen in Verträgen und Vereinbarungen lesen, auflisten und bearbeiten

• Jedes Dokument finden, das auf eine bestimmte Klausel oder einen definierten Begriff verweist

• Die Erklärung einer Definition direkt aus dem Dokument abrufen, zu dem sie gehört

Projekte, Ordner und Arbeitsbereiche

• Ihre Arbeitsbereiche, Projekte, Ordner und die darin enthaltenen Dokumente auflisten

• Projekte erstellen, umbenennen, Dokumente in Ordnern organisieren

• Dokumente massenhaft zwischen Projekten verschieben oder kopieren

Tabellen

• Tabellen erstellen, Spalten und Zeilen hinzufügen oder entfernen, dynamische Werte festlegen.

• Ganze Tabellen lesen, bestimmte Zeilen, Spalten oder Zellen nach Namen nachschlagen

• Zellen einzeln oder stapelweise aktualisieren

• Zeilen aus Dokumenten heraus referenzieren, damit das Dokument mit der Tabelle synchron bleibt

Vorlagen & Platzhalter

• Wiederverwendbare Dokumentvorlagen mit Live-Platzhaltern erstellen, die Daten aus Ihren Tabellen beziehen

• Wenn sich die zugrunde liegenden Tabellendaten ändern, wird jedes Dokument, das darauf verweist, automatisch aktualisiert

Authentifizierung

Zwei Möglichkeiten zur Authentifizierung:

1. Persönliches Zugriffstoken (HERO_API_KEY Umgebungsvariable) — empfohlen für Headless-Setups.

2. OAuth-Login — lassen Sie die Umgebungsvariable weg und die Bridge öffnet bei der ersten Verwendung Ihren Browser. Tokens werden unter ~/.hero/credentials.json gespeichert.

Verwalten und widerrufen Sie Tokens oder Sitzungen unter app.myhero.so → Settings → MCP Tokens.

Umgebungsvariablen

Quelle

Der Quellcode befindet sich unter github.com/Unwynd-io/hero-mcp. Probleme und Pull Requests sind willkommen.