humantone-mcp

HumanTone을 위한 공식 Model Context Protocol 서버입니다. Claude Desktop, Cursor, Cline 및 기타 MCP 클라이언트에서 HumanTone의 휴머나이징 및 AI 생성 가능성 탐지 도구를 직접 사용하세요. HumanTone 웹 앱에서 이미 사용 중인 동일한 크레딧과 하나의 API 키로 이용 가능합니다.

HumanTone은 AI가 생성한 콘텐츠를 더 자연스럽게 들리도록 다시 작성하는 AI 텍스트 휴머나이저입니다. 이 MCP 서버는 해당 도구들을 AI 어시스턴트로 가져옵니다.

초기 릴리스(v0.0.x)입니다. GitHub에서 업데이트를 확인하세요.

요구 사항

• Node.js 18 이상.

• API 액세스가 포함된 유료 HumanTone 플랜. 무료 체험 계정은 API를 사용할 수 없습니다.

• app.humantone.io/settings/api에서 발급받은 API 키.

Related MCP server: PostIdentity MCP Server

설치

별도의 설치 단계는 없습니다. MCP 클라이언트가 첫 실행 시 npx humantone-mcp를 통해 패키지를 다운로드합니다. 아래에서 사용하는 클라이언트에 맞는 구성 스니펫을 추가하기만 하면 됩니다.

구성

Claude Desktop

구성 파일 위치:

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

파일을 편집한 후 Claude Desktop을 다시 시작하세요.

Cursor

설정(Settings)의 MCP를 통해 구성하거나 ~/.cursor/mcp.json을 직접 편집하세요.

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

구성을 편집한 후 Cursor를 다시 시작하세요.

Cline (VSCode 확장 프로그램)

Cline 설정(Settings)의 MCP Servers를 통해 동일한 구조의 스니펫으로 구성하세요:

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

구성을 편집한 후 VSCode를 다시 시작하세요.

기타 MCP 클라이언트

humantone-mcp는 GitHub Copilot 에이전트 모드를 사용하는 VSCode, Codex CLI, Gemini CLI, Continue.dev, Zed, Windsurf, JetBrains AI Assistant 등을 포함하여 MCP와 호환되는 모든 클라이언트에서 작동합니다. 구성 패턴은 모든 클라이언트에서 동일합니다: 환경 변수에 HUMANTONE_API_KEY를 포함한 명령어(npx -y humantone-mcp)를 사용합니다.

클라이언트별 설정 스니펫 및 문제 해결 방법은 humantone.io/docs/mcp/를 참조하세요.

도구

• humanize: 텍스트를 더 자연스럽고 사람이 쓴 것처럼 다시 작성합니다. 어조, 대상 독자, 용어에 대한 사용자 지정 지침을 지원합니다.

• detect_ai: 텍스트의 AI 생성 가능성(0에서 100 사이)을 확인합니다. 크레딧을 소모하지 않습니다. 하루 30회 확인 가능하며, HumanTone 웹 앱과 공유됩니다.

• get_account: 현재 플랜, 크레딧 및 구독 상태를 표시합니다.

사용 예시

구성이 완료되면 어시스턴트와 자연스럽게 대화하세요. 메시지에 humantone 또는 특정 도구 이름을 언급하면 모델이 MCP 도구로 안정적으로 라우팅하는 데 도움이 됩니다. 특히 모델이 직접 텍스트를 다시 작성할 수 있는 휴머나이징 요청 시 유용합니다.

휴머나이징(Humanize):

• "Use humantone to rewrite this draft so it reads more naturally: <텍스트 붙여넣기>"

• "Run this through humantone with a formal corporate tone: <텍스트 붙여넣기>"

• "Pass this to humantone, set level to advanced, and preserve the term Kubernetes intact: <텍스트 붙여넣기>"

AI 생성 가능성 확인:

• "Use humantone's AI detector to score this paragraph: <텍스트 붙여넣기>"

• "Check AI likelihood with humantone: <텍스트 붙여넣기>"

• "Run this through humantone detect_ai: <텍스트 붙여넣기>"

계정 상태:

• "How many HumanTone credits do I have left?"

• "What is my current HumanTone plan?"

• "When does my HumanTone subscription renew?"

문제 해결

• 도구가 어시스턴트에 나타나지 않음. JSON 구성에 구문 오류가 없는지 확인한 후, 클라이언트를 완전히 종료하고 다시 여세요. 창 새로고침만으로는 충분하지 않습니다.

• "Invalid API key format" 오류. 키는 67자입니다: ht_ 뒤에 64개의 16진수 문자가 옵니다. 확실하지 않은 경우 app.humantone.io/settings/api에서 새 키를 생성하세요.

• "Plan does not include API access" 오류. 무료 체험 계정은 API를 사용할 수 없습니다. 유료 플랜은 humantone.io/pricing에서 확인하세요.

• "npx: command not found". nodejs.org에서 Node.js 18 이상을 설치하세요.

링크

• 더 많은 클라이언트를 위한 MCP 설정 가이드: https://humantone.io/docs/mcp/

• API 문서: https://humantone.io/docs/api/

• HumanTone Node SDK (이 서버에서 사용): https://www.npmjs.com/package/humantone

• API 키 발급: https://app.humantone.io/settings/api

• 이슈: https://github.com/humantone/humantone-mcp/issues

• 작성자 이메일: dev@humantone.io

• 제품 지원: help@humantone.io

라이선스

MIT. Copyright (c) HumanTone.