Kolay IK MCP by usefulapi

usefulapi の Kolay IK MCP

Claude、Cursor、または任意の MCP クライアントから、Kolay IK アカウントを使用できます。従業員、休暇、勤務記録、経費、給与、カレンダーの予定を読み取り、休暇や勤務記録の作成、予定や従業員情報の変更ができます。ホスト型のため、ローカルへのインストールは不要です。ご自身の認証情報で接続できます。

ライブエンドポイント： https://kolay-ik.usefulapi.io/mcp · ホームページ： https://usefulapi.io

接続

• Claude（claude.ai、Desktop）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://kolay-ik.usefulapi.io/mcp を貼り付けます。
• Claude Code： claude mcp add --transport http kolay-ik https://kolay-ik.usefulapi.io/mcp を実行し、続けて /mcp を実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "kolay-ik": {
      "url": "https://kolay-ik.usefulapi.io/mcp"
    }
  }
}

URL だけを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを行い、ログインページで Kolay IK の認証情報を求めます。

手順ごとの設定方法、認証情報の確認場所、FAQ：https://usefulapi.io/kolay-ik/

初回接続時に、Kolay IK の API トークンを入力します。このトークンは、Kolay IK の Ayarlar → Geliştirici Ayarları → API Token Oluştur から作成できます。サーバーがトークンを検証し、ユーザーごとに保存します。設定ファイルにキーを記載する必要はありません。

ツール

ツール	種類	説明
kolayik_get_me	read	トークンのユーザーを取得
kolayik_list_people	read	従業員の一覧を取得
kolayik_get_person	read	従業員を取得
kolayik_get_person_summary	read	従業員の概要を取得
kolayik_get_person_leave_balances	read	休暇残高を取得
kolayik_list_person_trainings	read	従業員の研修一覧を取得
kolayik_list_person_fields	read	従業員データ項目の一覧を取得
kolayik_list_units	read	組織単位の一覧を取得
kolayik_list_approval_processes	read	承認プロセスの一覧を取得
kolayik_list_leaves	read	休暇記録の一覧を取得
kolayik_get_leave	read	休暇記録を取得
kolayik_create_leave	write	休暇記録を作成
kolayik_list_timelogs	read	勤務記録の一覧を取得
kolayik_get_timelog	read	勤務記録を取得
kolayik_create_timelog	write	勤務記録を作成
kolayik_delete_timelog	write	勤務記録を削除
kolayik_list_transactions	read	取引の一覧を取得
kolayik_get_transaction	read	取引を取得
kolayik_list_expense_categories	read	経費カテゴリの一覧を取得
kolayik_list_payrolls	read	給与期間の一覧を取得
kolayik_get_payroll_sheet	read	給与明細を取得
kolayik_list_events	read	カレンダーの予定一覧を取得
kolayik_get_event	read	カレンダーの予定を取得
kolayik_create_event	write	カレンダーの予定を作成
kolayik_update_event	write	カレンダーの予定を更新
kolayik_delete_event	write	カレンダーの予定を削除
kolayik_list_trainings	read	研修の一覧を取得
kolayik_get_training	read	研修を取得
kolayik_create_person	write	従業員を作成
kolayik_update_person	write	従業員情報を更新
kolayik_usage_status	meta	使用状況（無料プランの利用量）
kolayik_request_feature	meta	不足している機能をリクエスト
kolayik_upgrade	meta	Pro にアップグレード（無制限*）
kolayik_cancel_subscription	meta	Pro サブスクリプションをキャンセル

read ツールは読み取り専用です。write ツールはデータを変更するため、クライアントで実行前に確認する必要があります。meta ツールは使用状況の報告、サブスクリプションの管理、または機能リクエストの送信を行います。

料金

プラン	料金	上限
無料	$0	月50回のツール呼び出し
Pro（ユーザーごと）	$9/mo または $90/yr（2か月無料）	無制限*

*Pro には、このサーバーで月10,000回のツール呼び出しという公正利用の上限があります。それ以上必要な場合は、[email protected] までご連絡ください。

Pro の対象はこのサーバーのみです。kolayik_upgrade で登録してください（Stripe Checkout のリンクが返されます）。kolayik_cancel_subscription でいつでも解約できます。Pro は有料期間の終了まで利用でき、現在の期間分の返金はありません。また、期間終了前に kolayik_upgrade を実行すると、解約が取り消されます。[email protected] までご連絡いただくこともできます。

ライセンス

MIT — LICENSE をご覧ください。ドキュメントのみです。サーバーはホストされています。