huly-mcp-sdk

Der umfassendste MCP-Server für Huly – die Open-Source-Projektmanagement-Plattform.

Verbindet Claude Desktop (und jeden MCP-kompatiblen Client) direkt mit Ihrem Huly-Workspace. Verwalten Sie Projekte, Aufgaben, Meilensteine, Komponenten, Dokumente, Labels und mehr – alles über natürliche Sprache.

Tools (insgesamt 36)

Related MCP server: Huly MCP Server

Voraussetzungen

• Node.js >= 20

• Ein Huly-Konto – huly.app (Cloud) oder selbst gehostet

Schnellstart

npx huly-mcp-sdk setup

Dies führt den interaktiven Einrichtungsassistenten aus – sendet einen Einmalcode an Ihre E-Mail (funktioniert auch für Google/GitHub-SSO-Konten) und schreibt Ihre .env-Datei automatisch.

Ihr Workspace-Slug ist der Teil Ihrer Huly-URL nach der Domain: huly.app/myteam → Slug ist myteam.

Kompatible Clients

Derselbe MCP-Server funktioniert mit allen gängigen KI-Codierungstools. Wählen Sie Ihren Client.

Hinweis zur Authentifizierung: Alle Konfigurationsbeispiele unten verwenden HULY_TOKEN. Wenn Sie Probleme mit dem Ablauf des Tokens haben, verwenden Sie stattdessen E-Mail + Passwort – ersetzen Sie einfach den env-Block durch:

"HULY_EMAIL": "your@email.com",
"HULY_PASSWORD": "yourpassword",
"HULY_WORKSPACE": "your-workspace-slug"

Siehe Manuelle Authentifizierung für Details zu beiden Optionen.

Claude Desktop

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "huly": {
      "command": "npx",
      "args": ["huly-mcp-sdk"],
      "env": {
        "HULY_TOKEN": "your-token",
        "HULY_WORKSPACE": "your-workspace-slug"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu.

Claude Code (CLI)

claude mcp add huly -e HULY_TOKEN=your-token -e HULY_WORKSPACE=your-slug -- npx huly-mcp-sdk

Oder beschränken Sie es auf ein einzelnes Projekt:

claude mcp add huly --scope project -e HULY_TOKEN=your-token -e HULY_WORKSPACE=your-slug -- npx huly-mcp-sdk

Überprüfen Sie die Verbindung: claude mcp list

Cursor

Erstellen oder bearbeiten Sie ~/.cursor/mcp.json:

{
  "mcpServers": {
    "huly": {
      "command": "npx",
      "args": ["huly-mcp-sdk"],
      "env": {
        "HULY_TOKEN": "your-token",
        "HULY_WORKSPACE": "your-workspace-slug"
      }
    }
  }
}

Starten Sie Cursor neu. Die Tools erscheinen im Agent-Panel unter MCP.

Windsurf (Codeium)

Erstellen oder bearbeiten Sie ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "huly": {
      "command": "npx",
      "args": ["huly-mcp-sdk"],
      "env": {
        "HULY_TOKEN": "your-token",
        "HULY_WORKSPACE": "your-workspace-slug"
      }
    }
  }
}

Starten Sie Windsurf neu. MCP-Tools sind für das Cascade-KI-Panel verfügbar.

VS Code – Cline-Erweiterung

1. Installieren Sie die Cline-Erweiterung

2. Öffnen Sie die Cline-Einstellungen → MCP-Server → MCP-Einstellungen bearbeiten

3. Fügen Sie hinzu:

{
  "huly": {
    "command": "npx",
    "args": ["huly-mcp-sdk"],
    "env": {
      "HULY_TOKEN": "your-token",
      "HULY_WORKSPACE": "your-workspace-slug"
    }
  }
}

VS Code – Continue-Erweiterung

1. Installieren Sie die Continue-Erweiterung

2. Bearbeiten Sie ~/.continue/config.json und fügen Sie zum mcpServers-Array hinzu:

{
  "mcpServers": [
    {
      "name": "huly",
      "command": "npx",
      "args": ["huly-mcp-sdk"],
      "env": {
        "HULY_TOKEN": "your-token",
        "HULY_WORKSPACE": "your-workspace-slug"
      }
    }
  ]
}

Zed

Bearbeiten Sie ~/.config/zed/settings.json und fügen Sie einen context_servers-Eintrag hinzu:

{
  "context_servers": {
    "huly": {
      "command": {
        "path": "npx",
        "args": ["huly-mcp-sdk"],
        "env": {
          "HULY_TOKEN": "your-token",
          "HULY_WORKSPACE": "your-workspace-slug"
        }
      }
    }
  }
}

OpenAI Codex CLI

Bearbeiten Sie ~/.codex/config.json und fügen Sie zu mcpServers hinzu:

{
  "mcpServers": {
    "huly": {
      "type": "stdio",
      "command": "npx",
      "args": ["huly-mcp-sdk"],
      "env": {
        "HULY_TOKEN": "your-token",
        "HULY_WORKSPACE": "your-workspace-slug"
      }
    }
  }
}

Jeder andere MCP-kompatible Client

Der Server verwendet standardmäßigen Stdio-Transport. Wenn Ihr Tool MCP unterstützt, ist das Konfigurationsmuster immer dasselbe:

• command: npx

• args: ["huly-mcp-sdk"]

• env: HULY_TOKEN + HULY_WORKSPACE

Konsultieren Sie die MCP-Dokumentation Ihres Tools für den genauen Speicherort der Konfigurationsdatei.

Alternative (npx-Kaltstart vermeiden): Einmal klonen und bauen, dann direkt auf die kompilierte Binärdatei verweisen:

git clone https://github.com/varaprasadreddy9676/huly-mcp.git
cd huly-mcp && npm install && npm run build

Ersetzen Sie "command": "npx", "args": ["huly-mcp-sdk"] durch "command": "node", "args": ["/absolute/path/to/huly-mcp/dist/index.js"] in jeder obigen Konfiguration.

Beispiel-Prompts

Projekte & Aufgaben:

• "Erstellen Sie ein neues Projekt namens 'Mobile App' mit der Kennung MOBILE"

• "Listen Sie alle laufenden Aufgaben im PROJ-Projekt auf"

• "Erstellen Sie eine Aufgabe mit hoher Priorität in PROJ mit dem Titel 'Fix login timeout'"

• "Aktualisieren Sie den Status von PROJ-42 auf Done, weisen Sie es Sarah zu und verschieben Sie es in die Auth-Komponente"

• "Suchen Sie nach Aufgaben im Zusammenhang mit Authentifizierung"

• "Fügen Sie einen Kommentar zu PROJ-15 hinzu, der besagt, dass der Fix bereitgestellt wurde"

• "Listen Sie alle Kommentare zu PROJ-42 auf, um die Diskussion zu sehen"

Meilensteine & Komponenten:

• "Erstellen Sie einen Meilenstein 'v2.0 Launch' in PROJ mit Zieldatum 2026-06-01"

• "Listen Sie Meilensteine für das PROJ-Projekt auf"

• "Erstellen Sie eine Komponente namens 'Auth' in PROJ"

• "Listen Sie alle Komponenten in PROJ auf"

Labels & Beziehungen:

• "Fügen Sie das Label 'bug' zu PROJ-42 hinzu"

• "Erstellen Sie ein Label namens 'backend' mit der Farbe #3b82f6"

• "Markieren Sie PROJ-55 als durch PROJ-12 blockiert"

• "Legen Sie PROJ-42 als Unteraufgabe von PROJ-5 fest"

Zeiterfassung:

• "Protokollieren Sie 2,5 Stunden auf PROJ-42 für das Datenbank-Refactoring"

Dokumente:

• "Listen Sie alle Dokumente im Engineering-Teamspace auf"

• "Erstellen Sie ein Dokument namens 'API Design' im Engineering-Teamspace"

• "Aktualisieren Sie das API-Design-Dokument mit diesem Markdown: ..."

• "Fügen Sie dem EP1-Dokument ein Mermaid-Architekturdiagramm hinzu"

• "Verknüpfen Sie Dokument abc123 mit Aufgabe PROJ-42"

• "Löschen Sie den zweiten Kommentar auf PROJ-15"

Dokumentinhalt

Lesen: get_document

get_document gibt immer vollständige Metadaten zurück (Titel, Teamspace, Kommentare, Snapshots). Um auch den Textinhalt abzurufen und anzuzeigen, setzen Sie die optionale Umgebungsvariable HULY_FRONT_URL:

"env": {
  "HULY_TOKEN": "...",
  "HULY_WORKSPACE": "myteam",
  "HULY_FRONT_URL": "https://front.huly.app"
}

Für selbst gehostetes Huly setzen Sie HULY_FRONT_URL auf Ihre eigene Front-Service-URL (z. B. http://localhost:8083).

Schreiben: update_document

update_document akzeptiert eine documentId und einen markdown-String und schreibt reichhaltigen strukturierten Inhalt direkt in das Dokument – keine manuelle Bearbeitung erforderlich.

Unterstütztes Markdown:

Beispiel:

update_document({
  documentId: "abc123",
  markdown: `# Service Flow\n\n` +
    `## Architecture\n\n` +
    "```mermaid\n" +
    "flowchart TD\n" +
    "  A([User]) --> B[Browse Catalogue]\n" +
    "  B --> C[Pay via Razorpay]\n" +
    "  C --> D[Order Confirmed]\n" +
    "```\n\n" +
    "## Business Rules\n\n" +
    "- Payment required before confirmation\n" +
    "- All orders synced to HIS\n"
})

Der Mermaid-Block wird als live interaktives Diagramm im Dokumenteditor von Huly gerendert – nicht als Codeblock.

Massen-CSV-Import

Importieren Sie viele Aufgaben auf einmal aus einer CSV-Datei – nützlich für die Migration von anderen Tools:

node scripts/import-csv.js tasks.csv PROJ

CSV-Format:

title,priority,status,dueDate
Fix login bug,High,In Progress,2025-04-01
Add dark mode,Medium,,
Improve performance,Urgent,,2025-05-01

Erforderliche Spalte: title. Optional: priority (Urgent/High/Medium/Low), status (muss einem Statusnamen im Projekt entsprechen), dueDate (JJJJ-MM-TT).

Manuelle Authentifizierung

Erstellen Sie eine .env-Datei im Projektstamm (oder übergeben Sie sie über env in Ihrer Client-Konfiguration):

Option A – E-Mail + Passwort (empfohlen):

Funktioniert, wenn Sie ein Passwort für Ihr Huly-Konto festgelegt haben (Profil → Sicherheit → Passwort ändern).

HULY_EMAIL=your@email.com
HULY_PASSWORD=yourpassword
HULY_WORKSPACE=your-workspace-slug

Option B – Token:

HULY_WORKSPACE=your-workspace-slug
HULY_TOKEN=your-token-here

So erhalten Sie ein Token: Gehen Sie zu huly.app → öffnen Sie die Browser-DevTools → Anwendung → Lokaler Speicher → https://huly.app → kopieren Sie den token-Wert.

Tokens laufen nach einiger Zeit ab. Wenn Sie einen Authentifizierungsfehler erhalten, wechseln Sie zur E-Mail-+ Passwort-Authentifizierung oder aktualisieren Sie das Token über die DevTools.

Selbst gehostetes Huly:

HULY_ACCOUNTS_URL=https://your-huly-instance.com/account
HULY_FRONT_URL=https://your-huly-instance.com

Architektur

• Einzelne langlebige WebSocket-Verbindung – verbindet sich einmal pro Prozess über @hcengineering/server-client, nicht pro Tool-Aufruf (Modell laden dauert 1–3 s, daher bleiben die Tools schnell)

• Lazy-Initialisierung – verbindet sich beim ersten Tool-Aufruf, sodass Authentifizierungsfehler in Claude deutlich sichtbar werden

• Duale Authentifizierung – OTP-Token (funktioniert für Google/GitHub-SSO) oder E-Mail + Passwort

• Stdio-Transport – standardmäßiger MCP-Transport, kompatibel mit Claude Desktop und jedem MCP-Client

Änderungsprotokoll

v0.5.6 — delete_document

• Neu: delete_document — Dokument dauerhaft anhand der ID löschen

v0.5.5 — create_teamspace

• Neu: create_teamspace — einen neuen Dokument-Teamspace erstellen (Top-Level-Ordner zum Organisieren von Dokumenten nach Projekt oder Team)

v0.5.2 — delete_comment + link_document

• Neu: delete_comment — einen bestimmten Kommentar eines Issues anhand der ID löschen; list_comments enthält jetzt Kommentar-IDs in der Ausgabe

• Neu: link_document — ein Huly-Dokument mit einem Issue verknüpfen; das Dokument erscheint im Bereich „Beziehungen“ des Issues

v0.5.0 — Dokument schreiben + Fehlerbehebungen

• Neu: update_document — Markdown programmatisch in ein beliebiges Huly-Dokument schreiben; \``mermaid`-Blöcke verwenden den nativen Knotentyp von Huly und werden als interaktive Diagramme gerendert

• Behoben: IssueStatus-Abfragen — Status werden in Huly global gespeichert (core:space:Model), nicht pro Projekt; falschen Raumfilter entfernt, der "no statuses found"-Fehler bei create_issue, update_issue und list_issues verursachte

• Behoben: create_project — setzt members: [currentUser], sodass neu erstellte Projekte sofort in der Huly-Benutzeroberfläche sichtbar sind

v0.4.0

• log_time, list_comments, Komponenten-/Meilenstein-Zuweisung bei update_issue

v0.3.1

• get_document, create_document

v0.3.0

• create_project, create_milestone, Assignee-Unterstützung bei Issues

Links

• npm: https://www.npmjs.com/package/huly-mcp-sdk

• GitHub: https://github.com/varaprasadreddy9676/huly-mcp

• MCP Registry: https://registry.modelcontextprotocol.io (Suche "huly-mcp")

Lizenz

Eclipse Public License 2.0