HumanTone

humantone-mcp

HumanTone の公式 Model Context Protocol サーバーです。HumanTone の文章の人間らしさ向上ツールと AI 判定ツールを、Claude Desktop、Cursor、Cline などの MCP クライアントから直接利用できます。API キーは 1 つで、HumanTone のウェブアプリで現在お使いのクレジットをそのまま利用できます。

HumanTone は、AI が生成したコンテンツを書き換えて、より自然な文章にする AI テキスト人間化ツールです。この MCP サーバーを使うと、これらのツールを AI アシスタントで利用できます。

初期リリース（v0.0.x）です。更新情報は GitHub でご確認ください。

必要条件

• Node.js 18 以降。
• API アクセスが含まれる有料の HumanTone プラン。無料トライアルアカウントでは API を利用できません。
• app.humantone.io/settings/api で取得した API キー。

インストール

インストール作業は不要です。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 互換のあらゆるクライアントで動作します。クライアント間で設定方法は共通です。コマンド（npx -y humantone-mcp）を指定し、環境に HUMANTONE_API_KEY を設定します。

クライアントごとの設定スニペットやトラブルシューティングについては、humantone.io/docs/mcp/ をご覧ください。

ツール

• humanize はテキストを書き換え、より自然で人が書いたような文章にします。トーン、対象読者、用語に関するカスタム指示に対応しています。
• detect_ai はテキストが AI によって生成された可能性を判定します（0～100）。クレジットは消費しません。1 日あたり 30 回まで利用でき、HumanTone のウェブアプリと共通です。
• get_account は現在のプラン、クレジット、サブスクリプションのステータスを表示します。

使用例

設定が完了したら、アシスタントに自然な言葉で依頼してください。メッセージに humantone や特定のツール名を含めると、モデルが MCP ツールを確実に呼び出しやすくなります。特に文章の人間らしさを向上させる依頼では、指定しないとモデル自身が文章を書き換えてしまう場合があります。

文章の人間らしさを向上させる：

• 「humantone を使って、この下書きをより自然な文章に書き換えてください：<文章を貼り付け>」
• 「これを humantone に通して、フォーマルな企業向けのトーンにしてください：<文章を貼り付け>」
• 「これを humantone に渡し、レベルを advanced に設定して、Kubernetes という用語はそのまま残してください：<文章を貼り付け>」

AI による生成可能性を確認する：

• 「humantone の AI 検出ツールを使って、この段落をスコアリングしてください：<文章を貼り付け>」
• 「humantone で AI による生成可能性を確認してください：<文章を貼り付け>」
• 「これを humantone detect_ai に通してください：<文章を貼り付け>」

アカウントのステータス：

• 「HumanTone のクレジットはあといくつありますか？」
• 「現在の HumanTone プランは何ですか？」
• 「HumanTone のサブスクリプションはいつ更新されますか？」

トラブルシューティング

• アシスタントにツールが表示されません。 JSON 設定に構文エラーがないことを確認し、クライアントを完全に終了してから再度開いてください。ウィンドウの再読み込みだけでは不十分です。
• 「Invalid API key format」エラーが表示されます。 キーは ht_ に続く 64 個の 16 進数文字からなる、67 文字の文字列です。不明な場合は、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://humantone.io/dashboard/settings/api
• 課題：https://github.com/humantone/humantone-mcp/issues
• 作者へのメール：[email protected]
• 製品サポート：[email protected]

ライセンス

MIT。Copyright (c) HumanTone.