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
humanizereescreve texto para soar mais natural e humano. Suporta instruções personalizadas para tom, público e terminologia.detect_aiverifica 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_accountmostra 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
- Guia de configuração MCP para mais clientes: https://humantone.io/docs/mcp/
- Documentação da API: https://humantone.io/docs/api/
- SDK Node da HumanTone (usado por este servidor): https://www.npmjs.com/package/humantone
- Obtenha uma chave de API: https://humantone.io/dashboard/settings/api
- Problemas: https://github.com/humantone/humantone-mcp/issues
- E-mail do autor: dev@humantone.io
- Suporte do produto: help@humantone.io
Licença
MIT. Copyright (c) HumanTone.