WatheeqaHR Attendance Analyzer

WatheeqaHR 勤怠分析ツール — MCP サーバー

AI アシスタント（Claude、ChatGPT、Cursor、VS Code など）が、生体認証勤怠デバイスのエクスポートデータを直接分析できる、無料のホスト型Model Context Protocolサーバーです。対応デバイスは、ZKTeco／BioTime、Hikvision、Dahua、Anviz、Suprema BioStar、FingerTec、Matrix COSEC、eSSL などです。英語またはアラビア語のヘッダーを含む CSV、Excel、テキストファイルを読み取ります。

従業員ごとに、出勤日数、推定欠勤日数、遅刻日数、打刻漏れ日数と、検出した列の対応付けを返します。これにより、表計算の数式を作成することなく、給与計算の前に1か月分の勤怠を確認できます。

• エンドポイント： https://www.watheeqahr.com/api/v1/mcp（リモート、Streamable HTTP）
• 認証： 不要
• 料金： 無料
• 開発元： WatheeqaHR。UAE、サウジアラビア、クウェート、カタール、バーレーン、オマーンの企業向けに、勤怠、休暇、給与計算の準備を支援します。

ツール

ツール	機能
analyze_attendance_file	csv_text、または content_base64 と filename を指定して、デバイスのエクスポートデータを分析します。任意の設定：シフトの開始・終了時刻、週末の曜日、祝日、柔軟な勤務スケジュール、必要労働時間、ヒジュラ暦、シート、国。
list_supported_attendance_formats	分析ツールがテスト済みのエクスポートヘッダー形式を一覧表示します。アップロード前にファイルを確認できます。
get_product_facts	WatheeqaHR のサービス範囲、対応国、料金を返すため、アシスタントが推測する必要はありません。

接続

Claude（ウェブまたはデスクトップ）：「Settings → Connectors → Add custom connector」に移動し、https://www.watheeqahr.com/api/v1/mcp を貼り付けます。

Claude Desktop／Cursor／JSON 設定に対応する任意のクライアント（mcp-remote経由）：

{
  "mcpServers": {
    "watheeqahr": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.watheeqahr.com/api/v1/mcp"]
    }
  }
}

VS Code（.vscode/mcp.json）：

{ "servers": { "watheeqahr": { "type": "http", "url": "https://www.watheeqahr.com/api/v1/mcp" } } }

HTTP API（MCP なし）： 同じ分析ツールの仕様を、OpenAPI 3.1 形式で https://www.watheeqahr.com/api/v1/public/openapi.json に公開しています。

試してみる

アシスタントに、次のように尋ねてみてください。

「10月分の ZKTeco エクスポートデータです。シフトは08:00～17:00で、金曜日は休みです。最も遅刻が多かった人と、打刻漏れがある人を教えてください。」

合成サンプルファイルは examples/ にあります。記載されている名前と数値はすべて架空のものです。

制限事項とプライバシー

• 1ファイルあたり5 MBまで。アカウントなしの場合、30日間にネットワークアドレスごとに異なるファイルを3つまで利用できます。
• アップロードされたファイルは、分析ツールの改善のため暗号化されたコピーが最長90日間保管され、その後自動的に削除されます。結果の概要は、推測困難なリンクで7日間保管されます。
• 共有が許可されているファイルのみ送信してください。詳細はプライバシーポリシーをご覧ください。
• 結果は業務上の確認を目的としたものであり、法律上または給与計算上の助言ではありません。WatheeqaHR は WPS プロバイダーではなく、政府への申請も行いません。

詳細：開発者と AI アシスタント向けガイド · 対応エクスポート形式 · ウェブ分析ツール

---

アラビア語

勤怠ファイルアナライザー — 無料の MCP サーバー

この MCP サーバーを使うと、AI アシスタント（Claude、ChatGPT、Cursor など）がタイムレコーダーのファイルを直接分析できます。ZKTeco、BioTime、Hikvision、Dahua、Anviz、Suprema、FingerTec、Matrix COSEC、eSSL に対応しており、CSV、Excel、テキスト形式のファイルを、アラビア語または英語の列見出しで利用できます。

給与計算の準備前に、Excel の数式を使わずに、従業員ごとの出勤日、推定欠勤日、遅刻日、打刻漏れを表示します。

• リンク： https://www.watheeqahr.com/api/v1/mcp。無料で、登録は不要です。
• Claude での設定： 設定 ← Connectors ← Add custom connector を選択し、リンクを貼り付けます。
• ウェブアナライザー： www.watheeqahr.com/ar/tools/attendance-analyzer
• 制限とプライバシー：
  • ファイルサイズ：最大 5 MB。
  • ファイル数：ネットワークアドレスごとに、30 日間で異なるファイルを 3 件まで。
  • 保持期間：アナライザーの改善のため、ファイルの暗号化されたコピーを最長 90 日間保持し、その後自動的に削除します。

ライセンス

このリポジトリのドキュメントとサンプルファイルは、MIT License のもとで公開されています。ホスト型サービスは Fluxnova LLC（UAE、シャルジャ・メディア・シティ）が運営しており、WatheeqaHR の利用規約が適用されます。