API & MCP

Debug-Server

Der Debug-Server ist ein lokaler TCP-Server (NWListener), der über die Einstellungen aktiviert wird. Er bietet eine JSON-basierte API für externe Automatisierung.

Authentifizierung: Jede Anfrage muss das konfigurierte Token im Authorization: Bearer <token> Header enthalten.

Endpunkt	Beschreibung
`GET /health`	Server-Verfügbarkeit prüfen
`GET /document`	Aktuelles Dokument abrufen
`POST /document`	Dokumentinhalt setzen
`GET /status`	Editor-Status (Wortanzahl, Datei, etc.)

MCP-Server

Der MCP-Server (inkra-mcp-server) wird als eigenständiges CLI-Tool im App-Bundle mitgeliefert. Er implementiert das Model Context Protocol und kommuniziert via XPC mit der Hauptapp. KI-Assistenten wie Claude Code können darüber auf den Editor zugreifen.

Die Konfiguration erfolgt über die MCP-Einstellungen des jeweiligen KI-Clients. Der Server wird automatisch gestartet, wenn ein Client sich verbindet.

Automatisierung

Über den Debug-Server können externe Skripte und Tools auf den Editor zugreifen. Typische Anwendungsfälle:

Dokumentinhalt programmatisch lesen und schreiben
Editor-Status abfragen (geöffnete Datei, Wortanzahl)
Integration in CI/CD-Pipelines oder Dokumentations-Workflows
Steuerung durch KI-Assistenten via MCP