humantone-mcp

Offizieller Model Context Protocol-Server für HumanTone. Nutzen Sie die Humanize- und KI-Erkennungs-Tools von HumanTone direkt aus Claude Desktop, Cursor, Cline und anderen MCP-Clients. Ein API-Schlüssel, dieselben Credits, die Sie bereits in der HumanTone-Web-App verwenden.

HumanTone ist ein KI-Texthumanisierer, der KI-generierte Inhalte so umschreibt, dass sie natürlicher klingen. Dieser MCP-Server bringt diese Tools in Ihren KI-Assistenten.

Frühe Version (v0.0.x). Verfolgen Sie Updates auf GitHub.

Anforderungen

• Node.js 18 oder neuer.

• Ein kostenpflichtiger HumanTone-Plan mit API-Zugriff. Kostenlose Testkonten können die API nicht nutzen.

• Ein API-Schlüssel von app.humantone.io/settings/api.

Related MCP server: PostIdentity MCP Server

Installation

Es gibt keinen Installationsschritt. Der MCP-Client lädt das Paket beim ersten Start über npx humantone-mcp herunter. Fügen Sie einfach den Konfigurations-Snippet für Ihren Client unten ein.

Konfiguration

Claude Desktop

Speicherort der Konfigurationsdatei:

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

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

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Bearbeiten der Datei neu.

Cursor

Konfiguration über Einstellungen und dann MCP, oder durch direktes Bearbeiten von ~/.cursor/mcp.json.

{
  "mcpServers": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

Starten Sie Cursor nach dem Bearbeiten der Konfiguration neu.

Cline (VSCode-Erweiterung)

Konfiguration über Cline-Einstellungen und dann MCP-Server, mit derselben Snippet-Struktur:

{
  "mcpServers": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

Starten Sie VSCode nach dem Bearbeiten der Konfiguration neu.

Andere MCP-Clients

humantone-mcp funktioniert mit jedem MCP-kompatiblen Client, einschließlich VSCode mit GitHub Copilot Agent-Modus, Codex CLI, Gemini CLI, Continue.dev, Zed, Windsurf, JetBrains AI Assistant und anderen. Das Konfigurationsmuster ist über alle Clients hinweg gleich: ein Befehl (npx -y humantone-mcp) mit HUMANTONE_API_KEY in der Umgebung.

Siehe humantone.io/docs/mcp/ für client-spezifische Setup-Snippets und Fehlerbehebung.

Tools

• humanize schreibt Text um, damit er natürlicher und menschlicher geschrieben klingt. Unterstützt benutzerdefinierte Anweisungen für Tonfall, Zielgruppe und Terminologie.

• detect_ai prüft die KI-Wahrscheinlichkeit von Text (0 bis 100). Verbraucht keine Credits. 30 Prüfungen pro Tag, geteilt mit der HumanTone-Web-App.

• get_account zeigt den aktuellen Plan, Credits und den Abonnementstatus an.

Nutzungsbeispiele

Sobald die Konfiguration abgeschlossen ist, sprechen Sie natürlich mit Ihrem Assistenten. Die Erwähnung von humantone oder spezifischen Tool-Namen in Ihrer Nachricht hilft dem Modell, zuverlässig zum MCP-Tool zu leiten, insbesondere bei Humanize-Anfragen, bei denen das Modell den Text sonst selbst umschreiben könnte.

Humanize:

• "Verwende humantone, um diesen Entwurf so umzuschreiben, dass er natürlicher klingt: <füge deinen Text ein>"

• "Lasse dies durch humantone mit einem formellen, geschäftlichen Tonfall laufen: <füge deinen Text ein>"

• "Gib dies an humantone weiter, setze das Level auf fortgeschritten und bewahre den Begriff Kubernetes intakt: <füge deinen Text ein>"

KI-Wahrscheinlichkeit prüfen:

• "Verwende den KI-Detektor von humantone, um diesen Absatz zu bewerten: <füge deinen Text ein>"

• "Prüfe die KI-Wahrscheinlichkeit mit humantone: <füge deinen Text ein>"

• "Lasse dies durch humantone detect_ai laufen: <füge deinen Text ein>"

Kontostatus:

• "Wie viele HumanTone-Credits habe ich noch übrig?"

• "Was ist mein aktueller HumanTone-Plan?"

• "Wann verlängert sich mein HumanTone-Abonnement?"

Fehlerbehebung

• Tools erscheinen nicht im Assistenten. Bestätigen Sie, dass die JSON-Konfiguration keine Syntaxfehler enthält, beenden Sie den Client vollständig und öffnen Sie ihn erneut. Ein Fenster-Refresh reicht nicht aus.

• Fehler "Invalid API key format". Schlüssel sind 67 Zeichen lang: ht_ gefolgt von 64 Hexadezimalzeichen. Generieren Sie bei Unsicherheit einen neuen unter app.humantone.io/settings/api.

• Fehler "Plan does not include API access". Kostenlose Testkonten können die API nicht nutzen. Sehen Sie sich kostenpflichtige Pläne unter humantone.io/pricing an.

• "npx: command not found". Installieren Sie Node.js 18 oder neuer von nodejs.org.

Links

• MCP-Setup-Anleitung für weitere Clients: https://humantone.io/docs/mcp/

• API-Dokumentation: https://humantone.io/docs/api/

• HumanTone Node SDK (wird von diesem Server verwendet): https://www.npmjs.com/package/humantone

• API-Schlüssel erhalten: https://app.humantone.io/settings/api

• Probleme: https://github.com/humantone/humantone-mcp/issues

• E-Mail des Autors: dev@humantone.io

• Produktsupport: help@humantone.io

Lizenz

MIT. Copyright (c) HumanTone.