humantone-mcp

Servidor oficial del Protocolo de Contexto de Modelos (MCP) para HumanTone. Utiliza las herramientas de humanización y detección de probabilidad de IA de HumanTone directamente desde Claude Desktop, Cursor, Cline y otros clientes MCP. Una clave API, los mismos créditos que ya utilizas en la aplicación web de HumanTone.

HumanTone es un humanizador de texto por IA que reescribe el contenido generado por IA para que suene más natural. Este servidor MCP lleva esas herramientas a tu asistente de IA.

Lanzamiento inicial (v0.0.x). Sigue las actualizaciones en GitHub.

Requisitos

• Node.js 18 o posterior.

• Un plan de pago de HumanTone con acceso a la API. Las cuentas de prueba gratuita no pueden utilizar la API.

• Una clave API de app.humantone.io/settings/api.

Related MCP server: PostIdentity MCP Server

Instalación

No hay pasos de instalación. El cliente MCP descarga el paquete en el primer inicio mediante npx humantone-mcp. Simplemente añade el fragmento de configuración para tu cliente a continuación.

Configuración

Claude Desktop

Ubicación del archivo de configuración:

• 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"
      }
    }
  }
}

Reinicia Claude Desktop después de editar el archivo.

Cursor

Configúralo a través de Ajustes (Settings) y luego MCP, o editando ~/.cursor/mcp.json directamente.

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

Reinicia Cursor después de editar la configuración.

Cline (extensión de VSCode)

Configúralo a través de los Ajustes de Cline y luego Servidores MCP, con la misma estructura de fragmento:

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

Reinicia VSCode después de editar la configuración.

Otros clientes MCP

humantone-mcp funciona con cualquier cliente compatible con MCP, incluyendo VSCode con el modo agente de GitHub Copilot, Codex CLI, Gemini CLI, Continue.dev, Zed, Windsurf, JetBrains AI Assistant y otros. El patrón de configuración es el mismo en todos los clientes: un comando (npx -y humantone-mcp) con HUMANTONE_API_KEY en el entorno.

Consulta humantone.io/docs/mcp/ para obtener fragmentos de configuración específicos para cada cliente y solución de problemas.

Herramientas

• humanize reescribe el texto para que suene más natural y escrito por humanos. Admite instrucciones personalizadas para el tono, la audiencia y la terminología.

• detect_ai comprueba la probabilidad de IA de un texto (de 0 a 100). No consume créditos. 30 comprobaciones al día, compartidas con la aplicación web de HumanTone.

• get_account muestra el plan actual, los créditos y el estado de la suscripción.

Ejemplos de uso

Una vez configurado, habla con tu asistente de forma natural. Mencionar humantone o nombres de herramientas específicos en tu mensaje ayuda al modelo a dirigirse de forma fiable a la herramienta MCP, especialmente para solicitudes de humanización donde el modelo podría, de otro modo, reescribir el texto por sí mismo.

Humanizar:

• "Usa humantone para reescribir este borrador para que se lea de forma más natural: "

• "Pasa esto por humantone con un tono corporativo formal: "

• "Pásale esto a humantone, establece el nivel en avanzado y mantén el término Kubernetes intacto: "

Comprobar probabilidad de IA:

• "Usa el detector de IA de humantone para puntuar este párrafo: "

• "Comprueba la probabilidad de IA con humantone: "

• "Pasa esto por humantone detect_ai: "

Estado de la cuenta:

• "¿Cuántos créditos de HumanTone me quedan?"

• "¿Cuál es mi plan actual de HumanTone?"

• "¿Cuándo se renueva mi suscripción a HumanTone?"

Solución de problemas

• Las herramientas no aparecen en el asistente. Confirma que la configuración JSON no tiene errores de sintaxis, luego cierra completamente y vuelve a abrir el cliente. Actualizar la ventana no es suficiente.

• Error "Invalid API key format". Las claves tienen 67 caracteres: ht_ seguido de 64 caracteres hexadecimales. Genera una nueva en app.humantone.io/settings/api si no estás seguro.

• Error "Plan does not include API access". Las cuentas de prueba gratuita no pueden utilizar la API. Consulta los planes de pago en humantone.io/pricing.

• "npx: command not found". Instala Node.js 18 o posterior desde nodejs.org.

Enlaces

• Guía de configuración de MCP para más clientes: https://humantone.io/docs/mcp/

• Documentación de la API: https://humantone.io/docs/api/

• SDK de Node de HumanTone (utilizado por este servidor): https://www.npmjs.com/package/humantone

• Obtener una clave API: https://app.humantone.io/settings/api

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

• Correo electrónico del autor: dev@humantone.io

• Soporte del producto: help@humantone.io

Licencia

MIT. Copyright (c) HumanTone.