# Reported issues for Word

Pod holds 16 of 27 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [Word](/mcp/word).

## Most discussed

### Release: Erstes NuGet-Release und Eintrag in der MCP-Registry

Der Server ist paketierbar und die Release-Pipeline steht, aber er ist nirgends veröffentlicht. Es fehlen zwei Schritte, die beide **Zugangsdaten des Repo-Eigentümers brauchen** und deshalb nicht automatisiert erledigt werden können.

Die Vorarbeit ist in #52 erledigt: das Manifest entspricht dem Schema `2025-12-11`, die README trägt den `mcp-name`-Marker für die Eigentümer-Verifikation, und beides wird beim Release am gepackten Nupkg geprüft.

## 1. Erstes Release auf nuget.org

`.github/

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/51) · 2026-08-20 · closed · 2 comments

### Service: Generierte Tools ueber die Prozessgrenze fuehren

Letzter Teil von Epic #5. Baut auf #48 auf.

## Das Problem

`ServiceBridge` reicht alle `session.*`-Befehle an den Service durch. Was nicht durchgeht, ist `WordToolsBase.Batch`: es liefert ein `IWordBatch`, also ein lebendes COM-Handle, und genau das brauchen die 14 generierten Tools.

`IWordBatch.Execute` nimmt ein Delegate entgegen. Ein Delegate laesst sich nicht serialisieren, ein Proxy auf Batch-Ebene ist damit ausgeschlossen. Die Naht muss also auf **Befehlsebene** liegen -- so wie bei `se

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/49) · 2026-08-20 · closed · 1 comment

### Service: MCP-Server auf die ServiceBridge umstellen

Teil 3 von Epic #5. Baut auf #43 und dem Pipe-Host auf.

## Ziel

Der MCP-Server fuehrt Befehle nicht mehr direkt aus, sondern ueber die `ServiceBridge`.

## Umfang

- [ ] `ServiceBridge` im MCP-Server, in-process als Standard
- [ ] Betriebsart ueber `WORDMCP_SERVICE_MODE=inprocess|daemon` waehlbar
- [ ] Generierte Tools rufen die Bridge statt `WordServices` direkt
- [ ] `WordFileTool` auf die Bridge umgestellt
- [ ] Bestehende Tests bleiben gruen, Verhalten unveraendert

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/45) · 2026-08-20 · closed · 1 comment

### Service: Named-Pipe-Host und Client mit Auto-Start

Teil 2 von Epic #5. Baut auf #43 auf.

## Ziel

Ein Named-Pipe-Host, der `WordMcpService` als eigenstaendigen Prozess verfuegbar macht,
plus ein `ServiceClient`, der sich verbindet und den Daemon bei Bedarf selbst startet.

## Umfang

- [ ] `ServiceHost` — Annahmeschleife auf der Pipe, mehrere gleichzeitige Verbindungen
- [ ] `Program.cs` — Daemon-Einstiegspunkt (`--daemon`, `--status`, `--stop`)
- [ ] `ServiceClient` — Verbinden, Auto-Start des Daemons, Reconnect nach Neustart
- [ ] Single-Inst

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/44) · 2026-08-20 · closed · 1 comment

### Kommentar- und Revisions-Tool: Review-Workflows

## Ziel

Kommentare und Änderungsverfolgung zugänglich machen — die Grundlage für Review-Workflows, bei denen ein Assistent Feedback verarbeitet.

## Aktionen

### `comment`

| Aktion | Zweck |
|---|---|
| `list` | Kommentare mit Index, Autor, Datum, Text und referenziertem Bereich |
| `add` | Kommentar an einem Absatz oder Zeichenbereich anbringen |
| `resolve` | Kommentar als erledigt markieren |
| `delete` | Kommentar entfernen |

### `revision`

| Aktion | Zweck |
|---|---|
| `list` | Änderu

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/23) · 2026-08-20 · closed · 1 comment

### Feld-Tool: Inhaltsverzeichnis, Seitenzahlen, Feldaktualisierung

Teil von #4

## Ziel

Inhaltsverzeichnis und Seitenzahlen — ohne sie wirkt kein generiertes Dokument fertig.

## Umfang

- [ ] `IFieldCommands` + Implementierung
  - [ ] `insert-toc` — Inhaltsverzeichnis an Position, Ebenen konfigurierbar
  - [ ] `update-toc` / `update-all` — Felder aktualisieren
  - [ ] `insert-page-number` — in Kopf- oder Fußzeile, mit Ausrichtung und Format
  - [ ] `list` — alle Felder mit Typ und Ergebnis
- [ ] MCP-Tool `field`
- [ ] Integrationstests

## Fallstricke

- Ein 

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/14) · 2026-08-18 · closed · 1 comment

### Bild-Tool: einfügen, auflisten, skalieren, ersetzen, löschen

Teil von #4

## Ziel

Bilder in Dokumente einfügen und verwalten — die am häufigsten gebrauchte fehlende Funktion nach Phase 1.

## Umfang

- [ ] `IImageCommands` + Implementierung
  - [ ] `insert` — Bild an Position oder ans Ende, mit Breite/Höhe und optionaler Beschriftung
  - [ ] `list` — alle `InlineShapes` mit Index, Größe, Alternativtext
  - [ ] `resize` — Größe in Punkt oder Prozent, Seitenverhältnis wahlweise beibehalten
  - [ ] `replace` — Bilddatei austauschen, Position und Größe behal

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/16) · 2026-08-18 · closed · 1 comment

### Ersten Stand committen und PR gegen main öffnen

Teil von #1

## Ziel

Den bisher nur lokal existierenden Stand als PR nach `main` bringen.

## Umfang

- [ ] Alles auf `trsdn-refactored-guacamole` committen (bislang **kein einziger Commit** — alle Dateien sind untracked)
- [ ] Sinnvoll aufteilen: Build-Dateien / ComInterop / Core / McpServer / Tests / Doku
- [ ] Release-Build zusätzlich zum Debug-Build prüfen
- [ ] `dotnet pack` einmal probeweise laufen lassen — die `PackAsTool`-Workarounds sind ungetestet
- [ ] PR gegen `main` mit Verweis auf

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/11) · 2026-08-18 · closed · 1 comment

## Most recent

### Backlog: fehlende Word-Funktionen (Content Controls, Fussnoten, Hyperlinks, Serienbrief)

## Stand

15 Werkzeuge, 62 Aktionen:

| Werkzeug | Aktionen |
|---|---|
| `bookmark` | list, add, get-text, delete |
| `comment` | list, add, resolve, delete |
| `document` | get-info, get-properties, set-properties, export-pdf, save-as |
| `field` | list, insert-toc, update-toc, update-all, insert-page-number |
| `header-footer` | get, set, clear |
| `image` | list, insert, resize, replace, delete, set-alt-text |
| `list` | get, apply, set-level, restart, remove |
| `paragraph` | l

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/61) · 2026-08-24 · closed · 0 comments

### Epic: word-cli — Generator und CLI-Tool nachziehen

## Was fehlt

Epic #2 wurde geschlossen, obwohl zwei Punkte seiner Liste nie umgesetzt wurden:

- [ ] `WordMcp.Generators.Cli` — erzeugt Spectre.Console-Settings und Command-Klassen aus denselben `[ServiceAction]`-Attributen, aus denen heute schon die MCP-Tools entstehen
- [ ] `WordMcp.CLI` — `word-cli` als eigenes .NET-Tool, gleiche Kommandos wie über MCP

Der MCP-Generator (`WordMcp.Generators.Mcp`) steht und deckt 15 Werkzeuge mit 62 Aktionen ab. Die Attribute, aus denen ein CLI-Genera

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/60) · 2026-08-24 · open · 0 comments

### Service: WordMcp.Service mit Session-Haltung und Befehlsdispatch

Teil 1 von Epic #5.

## Ziel

Ein eigenes Projekt `WordMcp.Service`, das den `SessionManager` haelt und Befehle
ueber eine schmale, prozessunabhaengige Schnittstelle ausfuehrt. Damit wird die
Session-Haltung vom MCP-Server-Prozess entkoppelt.

## Warum die Trennung an dieser Stelle

`IWordBatch.Execute` nimmt ein Delegate entgegen und laesst sich deshalb nicht ueber
eine Prozessgrenze reichen. Die einzige sinnvolle Naht ist die Befehlsebene:
`{ command, sessionId, argsJson } -> jsonResult`.

## 

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/43) · 2026-08-20 · closed · 0 comments

### Textmarken-Tool und Seiten-Rendering

## Ziel

Textmarken verwalten und eine Seite als Bild rendern. Das Rendering gibt einem Assistenten die Möglichkeit, das Layout visuell zu prüfen, statt es aus Zahlen zu erschließen.

## Aktionen

### `bookmark`

| Aktion | Zweck |
|---|---|
| `list` | Textmarken mit Name und Position |
| `add` | Textmarke an einem Absatz oder Bereich setzen |
| `delete` | Textmarke entfernen |
| `get-text` | Text einer Textmarke lesen |

### `screenshot`

| Aktion | Zweck |
|---|---|
| `page` | Eine Seite als P

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/24) · 2026-08-20 · closed · 0 comments

### Listen-Tool: Aufzählungen, Nummerierungen, Ebenen

## Ziel

Aufzählungen und Nummerierungen setzen — inklusive mehrstufiger Listen und Neustart der Nummerierung.

## Aktionen

| Aktion | Zweck |
|---|---|
| `apply` | Absatzbereich als Aufzählung (`bullet`) oder Nummerierung (`number`) formatieren |
| `set-level` | Gliederungsebene eines Absatzes setzen (1–9) |
| `restart` | Nummerierung ab einem Absatz neu beginnen |
| `remove` | Listenformatierung entfernen |

## Hinweise zur Umsetzung

- `ListFormat.ApplyListTemplateWithLevel` mit `ListGalleri

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/22) · 2026-08-20 · closed · 0 comments

### Style-Tool: Formatvorlagen auflisten, anlegen, ändern

## Ziel

Formatvorlagen auflisten, anlegen und ändern, damit Dokumente konsistent formatiert werden können, ohne jede Textstelle einzeln anzufassen.

## Aktionen

| Aktion | Zweck |
|---|---|
| `list` | Stile mit Name, Typ (Absatz/Zeichen/Tabelle) und Verwendung im Dokument |
| `create` | Neuen Stil anlegen, optional basierend auf einem vorhandenen |
| `modify` | Schrift, Größe, Farbe, Fett/Kursiv, Abstände und Ausrichtung ändern |
| `delete` | Benutzerdefinierten Stil entfernen |

## Hinweise z

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/21) · 2026-08-20 · closed · 0 comments

### Kopf-/Fußzeilen-Tool: lesen, setzen, pro Sektion und Seitentyp

## Ziel

Kopf- und Fußzeilen lesen und schreiben — pro Sektion und pro Typ (Standard, erste Seite, gerade Seiten).

## Aktionen

| Aktion | Zweck |
|---|---|
| `get` | Text einer Kopf-/Fußzeile lesen |
| `set` | Text setzen, optional mit Ausrichtung |
| `clear` | Inhalt entfernen |

## Parameter

- `kind`: `header` oder `footer`
- `section_index`: 1-basiert, ohne Angabe alle Sektionen
- `type`: `primary`, `first-page` oder `even-pages`

## Hinweise zur Umsetzung

- `first-page` und `even-pages` 

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/20) · 2026-08-20 · closed · 0 comments

### Sektions-Tool: auflisten, hinzufügen, Seiteneinrichtung

## Ziel

Sektionen und deren Seiteneinrichtung über MCP steuerbar machen. Grundlage für `header-footer`, weil Kopf- und Fußzeilen in Word immer an einer Sektion hängen.

## Aktionen

| Aktion | Zweck |
|---|---|
| `list` | Sektionen mit Index, Start-Typ, Seitenformat, Ausrichtung und Rändern |
| `add` | Sektionsumbruch einfügen (`next-page`, `continuous`, `even-page`, `odd-page`) |
| `page-setup` | Ränder, Ausrichtung (`portrait`/`landscape`), Papierformat setzen — für eine Sektion oder das ganz

[Read the thread](https://github.com/trsdn/mcp-server-word/issues/19) · 2026-08-20 · closed · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/trsdn/mcp-server-word/issues).