HumanTone

Servidor oficial do Model Context Protocol para HumanTone. Humanize texto gerado por IA e verifique a probabilidade de IA diretamente do Claude Desktop, Cursor, Cline e outros clientes MCP.

Documentação

humantone-mcp

Servidor oficial do Model Context Protocol para HumanTone. Use as ferramentas de humanização e probabilidade de IA da HumanTone diretamente no Claude Desktop, Cursor, Cline e outros clientes MCP. Uma chave de API, os mesmos créditos que você já usa no aplicativo web da HumanTone.

HumanTone é um humanizador de texto por IA que reescreve conteúdo gerado por IA para soar mais natural. Este servidor MCP traz essas ferramentas para o seu assistente de IA.

Versão inicial (v0.0.x). Acompanhe as atualizações no GitHub.

Requisitos

  • Node.js 18 ou superior.
  • Um plano pago da HumanTone com acesso à API. Contas de teste gratuito não podem usar a API.
  • Uma chave de API em app.humantone.io/settings/api.

Instalação

Não há etapa de instalação. O cliente MCP baixa o pacote no primeiro uso via npx humantone-mcp. Basta adicionar o trecho de configuração para o seu cliente abaixo.

Configuração

Claude Desktop

Local do arquivo de configuração:

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

Reinicie o Claude Desktop após editar o arquivo.

Cursor

Configure em Configurações e depois MCP, ou editando ~/.cursor/mcp.json diretamente.

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

Reinicie o Cursor após editar a configuração.

Cline (extensão do VSCode)

Configure em Configurações do Cline e depois Servidores MCP, com a mesma estrutura de trecho:

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

Reinicie o VSCode após editar a configuração.

Outros clientes MCP

O humantone-mcp funciona com qualquer cliente compatível com MCP, incluindo VSCode com modo agente do GitHub Copilot, Codex CLI, Gemini CLI, Continue.dev, Zed, Windsurf, JetBrains AI Assistant e outros. O padrão de configuração é o mesmo em todos os clientes: um comando (npx -y humantone-mcp) com HUMANTONE_API_KEY no ambiente.

Consulte humantone.io/docs/mcp/ para trechos de configuração específicos por cliente e solução de problemas.

Ferramentas

  • humanize reescreve texto para soar mais natural e humano. Suporta instruções personalizadas para tom, público e terminologia.
  • detect_ai verifica a probabilidade de IA do texto (0 a 100). Não consome créditos. 30 verificações por dia, compartilhadas com o aplicativo web da HumanTone.
  • get_account mostra o plano atual, créditos e status da assinatura.

Exemplos de uso

Depois de configurado, converse naturalmente com seu assistente. Mencionar humantone ou nomes específicos de ferramentas na sua mensagem ajuda o modelo a rotear com confiabilidade para a ferramenta MCP, especialmente em solicitações de humanização, onde o modelo poderia reescrever o texto por conta própria.

Humanizar:

  • "Use humantone para reescrever este rascunho para que soe mais natural: "
  • "Passe isso pelo humantone com um tom corporativo formal: "
  • "Passe isso para o humantone, defina o nível como avançado e preserve o termo Kubernetes intacto: "

Verificar probabilidade de IA:

  • "Use o detector de IA do humantone para pontuar este parágrafo: "
  • "Verifique a probabilidade de IA com humantone: "
  • "Passe isso pelo humantone detect_ai: "

Status da conta:

  • "Quantos créditos da HumanTone ainda tenho?"
  • "Qual é o meu plano atual da HumanTone?"
  • "Quando minha assinatura da HumanTone renova?"

Solução de problemas

  • As ferramentas não aparecem no assistente. Confirme se o JSON da configuração não tem erros de sintaxe e, em seguida, feche e reabra completamente o cliente. Atualizar a janela não é suficiente.
  • Erro "Invalid API key format". As chaves têm 67 caracteres: ht_ seguido de 64 caracteres hexadecimais. Gere uma nova em app.humantone.io/settings/api se não tiver certeza.
  • Erro "Plan does not include API access". Contas de teste gratuito não podem usar a API. Veja os planos pagos em humantone.io/pricing.
  • "npx: command not found". Instale Node.js 18 ou superior em nodejs.org.

Links

Licença

MIT. Copyright (c) HumanTone.