HumanTone

Servidor oficial del Protocolo de Contexto de Modelo para HumanTone. Humaniza texto generado por IA y verifica la probabilidad de IA directamente desde Claude Desktop, Cursor, Cline y otros clientes MCP.

GitHub
1

Documentación

humantone-mcp

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

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

Versión preliminar (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 gratuitas no pueden usar la API.
  • Una clave de API desde app.humantone.io/settings/api.

Instalación

No hay paso de instalación. El cliente MCP descarga el paquete en el primer lanzamiento mediante npx humantone-mcp. Solo agrega 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

Configura a través de Configuración 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)

Configura a través de Configuración 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, incluidos 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 fragmentos de configuración específicos por cliente y solución de problemas.

Herramientas

  • humanize reescribe texto para que suene más natural y humano. Admite instrucciones personalizadas para tono, audiencia y terminología.
  • detect_ai verifica la probabilidad de IA del texto (0 a 100). No consume créditos. 30 verificaciones por 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 enrutar de manera confiable a la herramienta MCP, especialmente para solicitudes de humanización donde el modelo podría reescribir el texto por sí mismo.

Humanizar:

  • "Usa humantone para reescribir este borrador para que se lea más natural: "
  • "Pasa esto por humantone con un tono corporativo formal: "
  • "Pasa esto a humantone, establece el nivel en avanzado y conserva el término Kubernetes intacto: "

Verificar probabilidad de IA:

  • "Usa el detector de IA de humantone para calificar este párrafo: "
  • "Verifica 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 de HumanTone?"

Solución de problemas

  • Las herramientas no aparecen en el asistente. Confirma que el JSON de configuración no tenga errores de sintaxis y luego cierra y vuelve a abrir el cliente por completo. Actualizar la ventana no es suficiente.
  • Error de "formato de clave de API no válido". 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 de "el plan no incluye acceso a la API". Las cuentas de prueba gratuitas no pueden usar la API. Consulta los planes de pago en humantone.io/pricing.
  • "npx: comando no encontrado". Instala Node.js 18 o posterior desde nodejs.org.

Enlaces

Licencia

MIT. Copyright (c) HumanTone.