Hellotime Mcp

HelloTime 公開 MCP サーバー

AI エージェントが、古い Web スニペットに頼ることなく、HelloTime に関する質問（料金、機能 （シフト、勤務表、休暇、タイムシート、GPS、生体認証キオスク）、対応国、 給与計算機能）に正確に回答できる、公開の読み取り専用 Model Context Protocol サーバーです。

これは公開サーバーです。マーケティング情報に基づく公開データのみを提供します。 顧客のタイムシート、勤務表、給与データを読み取る認証済み MCP サーバーは、 別の非公開リポジトリにあります。

インストール

Claude Code / Claude Desktop / Cursor

claude mcp add --transport http hellotime https://mcp.hellotime.ai/mcp

または、ローカルで開発する場合：

claude mcp add hellotime-local node /path/to/HelloTime-MCP-Public/dist/stdio.js

ツール

ツール	説明
list_plans	HelloTime の全プラン（Free、Attend、Track、Business）。8 通貨での請求価格と継続的な基準価格に加え、利用量と年払いの割引表も確認できます。Free は単一ユーザー向けで恒久的に無料です。有料プランにはそれぞれ 7 日間の無料トライアルが含まれます。任意で country および plan によるフィルターを指定できます。
list_features	14 カテゴリにわたる HelloTime の機能：シフト、勤務表、休暇、タイムシート、時間追跡、生産性、GPS／ジオフェンス、生体認証キオスク、給与計算、請求書発行、分析、プロジェクト、レポート、インテグレーション。任意で category および plan によるフィルターを指定できます。
country_support	IN、AU、GB、US、CA、AE、SG、NZ における、国ごとの機能提供状況と製品の位置付け。
payroll_capabilities	指定した国で対応している給与計算エンジンとそのステータス。AU の STP2 と年金、IN の PF／ESI／TDS／Form 24Q、US の W-2／1099、UK の RTI など。
statutory_rates	法定給与料率の項目。料率、上限、区分、所管機関、検証ステータスを確認できます。IN の項目（PF／EPS／EDLI／PF 管理費／ESI／7 州の専門職税／TDS 区分）は、EPFO／ESIC／州の通知に基づき社内でレビュー済みです。AU と US の項目は公開情報に基づいていますが、レビューは行われていません。任意で country、scheme、category、state、party、verification、id によるフィルターを指定できます。
list_competitors	HelloTime が優位な点、競合が優位な点、料金に関する注記を含む、競合製品（Truein、Deputy、When I Work、Connecteam、Hubstaff、Keka）の位置付け。任意で country、tier、id によるフィルターを指定できます。
feature_search	プラン機能、製品機能、国別機能、給与計算エンジン、法定料率、競合製品の位置付けを対象とするフリーテキスト検索。PF rate、PT slab Maharashtra、vs Truein のようなクエリを指定すると、一致する項目が上位に表示されます。

リソース

URI	説明
hellotime://about	製品の Markdown 概要。
hellotime://changelog	直近 50 件のリリースノート（JSON）。

セキュリティ対策

• 設計上、読み取り専用です。 状態を変更するツールはありません。顧客システムにアクセスするツールもありません。
• 公開データのみです。 カタログのコンテンツはすべて、公開されているマーケティングサイトを情報源としています。
• 認証は不要です。 ナレッジエンドポイントとして意図した仕様です。
• レート制限があります。 IP あたり 120 req/min、セッションあたり 60 req/min です。
• 監査ゲート。 src/data/ に個人識別情報（PII）や認証トークンの文字列が含まれている場合、npm run audit:public-data がデプロイをブロックします。

開発

npm install
npm run dev         # HTTP server on :8080 with watch mode
npm run dev:stdio   # stdio transport for local MCP client testing
npm test            # node:test runner
npm run build
npm run audit:public-data

プロジェクト構成

src/
  data/             # Static catalogs — plans, features, countries, about
  tools/            # One file per MCP tool
  resources/        # MCP resource registry
  server.ts         # MCP server factory (wires tools + resources)
  http.ts           # Streamable HTTP transport with rate limiting
  stdio.ts          # stdio transport entry point
test/
  tools.test.ts
  resources.test.ts
  public-data.test.ts  # Audit gate
scripts/
  audit-public-data.ts  # CI-callable audit

デプロイ

コンテナ化されています。Dockerfile を参照してください。TLS 終端ロードバランサーの背後で実行するよう設計されています。 環境変数で PORT と HOST を設定してください。

任意の匿名利用状況テレメトリー（サーバー側の第 2 層分析）は、GA4_MEASUREMENT_ID と GA4_API_SECRET の両方が設定されている場合に、 Measurement Protocol 経由で GA4 に送信されます。.env.example と src/analytics.ts を参照してください。未設定のままにすると、サーバーの テレメトリーは完全に無効になります。顧客データ、リクエスト本文、ツール引数の値、IP アドレスが送信されることはありません。 送信されるのは匿名のカウントのみです。リクエストトラフィックイベント （mcp_request、mcp_tool_call、mcp_bot_visit、mcp_error）とクライアント／ボットの検出については、戦略ドキュメント 73 と docs/MCP_ANALYTICS.md を参照してください。

docker build -t hellotime-mcp-public .
docker run -p 8080:8080 hellotime-mcp-public

見つけやすさ

• MCP レジストリに掲載されています。
• マーケティングサイトのフッターと /mcp ページからリンクされています。
• https://hellotime.ai/llms.txt で参照されています。

ライセンス

MIT — LICENSE をご覧ください。