Humaans

@mindstone/mcp-server-humaans

Model Context Protocol ホスト向けの Humaans HR プラットフォーム MCP サーバーです。標準化された MCP インターフェースを通じて、従業員プロフィール、職務、休暇申請、会社情報、オフィスの場所を照会できます。

ステータス

• バージョン： 0.3.1 · npm
• 認証： API キー（HUMAANS_API_KEY）
• ツール： 16（people、job-roles、time-away、company、teams）
• サーフェス： cloud-api
• 機械可読： STATUS.json

要件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストで HUMAANS_API_KEY の入力を求められます。

{
  "mcpServers": {
    "Humaans": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-humaans"
      ],
      "env": {
        "HUMAANS_API_KEY": ""
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/humaans
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-humaans

ローカル

node dist/index.js

設定

環境変数

• HUMAANS_API_KEY — Humaans API アクセストークン（アプリの設定から取得）
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジ状態ファイルの任意のパス
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE と後方互換性のあるエイリアス

ホスト設定例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Humaans": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-humaans"],
      "env": {
        "HUMAANS_API_KEY": "your-api-key"
      }
    }
  }
}

ローカル開発（npm 公開不要）

{
  "mcpServers": {
    "Humaans": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/humaans/dist/index.js"],
      "env": {
        "HUMAANS_API_KEY": "your-api-key"
      }
    }
  }
}

ツール（16）

設定

• configure_humaans_api_key — Humaans API アクセストークンを設定

従業員

• get_humaans_me — 現在認証されているユーザーのプロフィールを取得
• list_humaans_people — 従業員を一覧表示
• get_humaans_person — ID を指定して従業員の全プロフィールを取得
• list_humaans_teams — メンバー数とともにチーム名を一覧表示（従業員ディレクトリから算出。Humaans には専用のチームエンドポイントはありません）

職務

• list_humaans_job_roles — 従業員の職務履歴を一覧表示
• get_humaans_job_role — ID を指定して特定の職務を取得

休暇

• list_humaans_time_away — 休暇記録（有給休暇、病気休暇など）を一覧表示
• create_humaans_time_away — 休暇を申請
• list_humaans_time_away_types — 利用可能な休暇の種類を一覧表示
• list_humaans_time_away_allocations — 休暇割り当てを一覧表示（各従業員に適用されるポリシー）
• cancel_humaans_time_away — 休暇記録をキャンセル（完全に削除）
• approve_humaans_time_away — 保留中の休暇申請を承認（マネージャーの操作）
• decline_humaans_time_away — 保留中の休暇申請を却下（マネージャーの操作）

会社

• list_humaans_locations — 会社の拠点／オフィスを一覧表示
• get_humaans_company — 会社情報を取得

データの取り扱い

• 人物一覧のレスポンスでは、許可リストに含まれるフィールドのみを返します。人物詳細のレスポンスでは、機密フィールド（納税者番号、個人用メールアドレス／電話番号、自宅住所、誕生日、プロフィール写真）を削除します。
• Humaans で入力された自由記述フィールド（休暇の note／reviewNote、職務の note／jobTitle／department、休暇タイプとポリシーの名前、チーム名、名前／bio／ソーシャルリンク／職務などの人物プロフィールの自由記述、場所のラベル／都市名、会社名）は、<untrusted-content> エンベロープ内に返されます。これにより、モデルはこれらを指示ではなくデータとして扱います。
• Humaans API のエラーボディは、モデルに渡す前にエンベロープで囲みます（JSON 以外のボディには上限を設けます）。Retry-After は解析された整数としてのみレート制限メッセージに渡されます。また、不正な 2xx ボディの場合は、ボディの一部を含むパーサーメッセージではなく、固定のエラーを返します。

ライセンス

FSL-1.1-MIT — Functional Source License, Version 1.1。将来的に MIT ライセンスとなります。本ソフトウェアは 2030-04-08 に MIT ライセンスへ移行します。