kiwiHR MCP by usefulapi について
kiwiHR MCP by usefulapi は、kiwiHR の従業員、休暇、タイムシート、プロジェクトのデータを MCP クライアントに提供します。一部のレコードの作成と更新にも対応します。
主な機能
- 01従業員・チーム情報の取得
- 02休暇の種類と残日数の確認
- 03タイムシート・出勤記録の確認
- 04プロジェクト・入社手続きの閲覧
- 05従業員・タイムシートの作成や更新
活用シーン
- 01従業員やチームの情報確認
- 02休暇残日数や出勤状況の確認
- 03タイムシート項目の確認や編集
- 04従業員やプロジェクトの管理
MCP 対応
リモート MCP サーバーを通じて、kiwiHR の読み取り・書き込みツールを MCP クライアントに公開します。初回接続には kiwiHR の会社 API key が必要です。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://kiwihr.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-kiwihr https://kiwihr.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-kiwihr":{"type":"http","url":"https://kiwihr.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-kiwihr":{"type":"http","url":"https://kiwihr.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-kiwihr":{"type":"http","url":"https://kiwihr.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-kiwihr":{"serverUrl":"https://kiwihr.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
usefulapi の kiwiHR MCP
kiwiHR の従業員、休暇、タイムシート、プロジェクトを読み取り、従業員やタイムシートを作成・更新します。
ライブエンドポイント: https://kiwihr.usefulapi.io/mcp · ホームページ: https://usefulapi.io/kiwihr
接続
- Claude(claude.ai、Desktop):Customize → Connectorsを開き、+ Add → Add custom connectorをクリックして、
https://kiwihr.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http kiwihr https://kiwihr.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"kiwihr": {
"url": "https://kiwihr.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定にAuthorizationヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインし、ログインページで kiwiHR の認証情報を求めます。
ステップごとの設定方法、認証情報の確認場所、よくある質問:https://usefulapi.io/kiwihr/
初回接続時に、kiwiHR(Tellent HR)の会社のAPI キーを貼り付けます(kiwiHR のウェブアプリで、Company Settings / Configuration > Integrations > API Keys から作成できます)。
ツール
| ツール | 種類 | 内容 |
|---|---|---|
kiwihr_list_users | 読み取り | 従業員の一覧を取得 |
kiwihr_get_user | 読み取り | 従業員を取得 |
kiwihr_list_teams | 読み取り | チームの一覧を取得 |
kiwihr_list_locations | 読み取り | 所属地の一覧を取得 |
kiwihr_list_positions | 読み取り | 役職の一覧を取得 |
kiwihr_list_custom_fields | 読み取り | カスタムフィールドの一覧を取得 |
kiwihr_list_time_off_types | 読み取り | 休暇種別の一覧を取得 |
kiwihr_list_time_off_balances | 読み取り | 休暇残高の一覧を取得 |
kiwihr_get_time_off_usage | 読み取り | 休暇の利用状況を取得 |
kiwihr_list_timesheets | 読み取り | タイムシートの一覧を取得 |
kiwihr_get_timesheet | 読み取り | タイムシートを取得 |
kiwihr_get_attendance_statement | 読み取り | 勤怠明細を取得 |
kiwihr_list_attendance_statements | 読み取り | 勤怠明細の一覧を取得 |
kiwihr_list_overtime_balances | 読み取り | 残業時間残高の一覧を取得 |
kiwihr_list_projects | 読み取り | プロジェクトの一覧を取得 |
kiwihr_get_project | 読み取り | プロジェクトを取得 |
kiwihr_list_journeys | 読み取り | ジャーニーの一覧を取得 |
kiwihr_get_journey | 読み取り | ジャーニーを取得 |
kiwihr_list_journey_templates | 読み取り | ジャーニーテンプレートの一覧を取得 |
kiwihr_list_journey_types | 読み取り | ジャーニー種別の一覧を取得 |
kiwihr_create_timesheet_entry | 書き込み | タイムシートのエントリーを作成 |
kiwihr_update_timesheet_entry | 書き込み | タイムシートのエントリーを更新 |
kiwihr_delete_timesheet_entry | 書き込み | タイムシートのエントリーを削除 |
kiwihr_create_project | 書き込み | プロジェクトを作成 |
kiwihr_update_project | 書き込み | プロジェクトを更新 |
kiwihr_create_user | 書き込み | 従業員を作成 |
kiwihr_update_user | 書き込み | 従業員を更新 |
kiwihr_deactivate_user | 書き込み | 従業員を無効化 |
kiwihr_activate_user | 書き込み | 従業員を有効化 |
kiwihr_create_journey | 書き込み | ジャーニーを作成 |
kiwihr_usage_status | メタ | 利用状況(無料プランの使用量メーター) |
kiwihr_request_feature | メタ | 不足している機能をリクエスト |
kiwihr_upgrade | メタ | Pro にアップグレード(無制限*) |
kiwihr_cancel_subscription | メタ | Pro サブスクリプションを解約 |
readツールは読み取り専用です。writeツールはデータを変更するため、クライアント側で確認する必要があります。metaツールは利用状況を報告し、サブスクリプションを管理するか、機能リクエストを送信します。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| 無料 | $0 | 月50回のツール呼び出し |
| Pro(ユーザーごと) | $9/月または**$90/年**(2か月分無料) | 無制限* |
*Proには、このサーバーで月10,000回のツール呼び出しという公正使用の上限があります。それ以上必要な場合は、[email protected] までお問い合わせください。
Proの対象はこのサーバーのみです。kiwihr_upgrade で登録してください(Stripe Checkoutのリンクが返されます)。kiwihr_cancel_subscription でいつでもキャンセルできます。Proは支払い済み期間の終了まで継続し、現在の期間分の返金はありません。また、その前に kiwihr_upgrade を実行すると、キャンセルが取り消されます。[email protected] までお問い合わせいただくこともできます。
ライセンス
MIT © usefulapi。kiwiHRとは提携しておらず、kiwiHRからの推奨も受けていません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。