Work Journal MCP Server

チームの誰もがSimplified HR Work JournalをClaudeを通じて読めるようにするホスト型MCPサーバーです。自分のエントリーは常に、同僚のエントリーは既存のWork Journal権限で許可されている場合にのみ読めます。

読み取り専用です。ここにあるどのツールもエントリーを作成、変更、削除することはできません。

接続（任意のClaudeクライアントから）

どのクライアントでも同じ手順です。URLでサーバーを追加し、開いたブラウザウィンドウでサインインします。

Claude Desktop または claude.ai — 設定 → コネクタ → カスタムコネクタを追加 →

https://wj-mcp.dev.besimplified.net/mcp

Claude Code

claude mcp add work-journal --transport http https://wj-mcp.dev.besimplified.net/mcp

どちらの場合もブラウザウィンドウが開きます。Simplified HRのメールアドレスとパスワードでサインインします。開発環境ではワークスペースも入力します。例: development-hr.dev.besimplified.net

このデバイスがアカウントサービスにとって初めての場合は、メールまたはSMSで確認コードが送信されます。一度入力すれば、同じクライアントから再度求められることはありません。

パスワードがClaudeに届くことはなく、このサーバーがパスワードを保存することもありません。

ツール

work_journal_get_entries

日付または最大31日間の範囲について、タスクの詳細を含むエントリーを取得します。

例: "先週のEODエントリーを表示して"

work_journal_get_day

1日分を完全に取得: すべてのタスクのメモ、添付ファイル、通知先、ETA、提出時刻。

例: "8月4日に何を記録した？"

work_journal_get_summary

任意の期間におけるタイプ別・ステータス別の件数。日ごとの詳細はありません。31日を超える場合はこれを使用します。

例: "今年、EOWレポートを何回逃した？"

work_journal_find_member

名前またはメールの一部から同僚を検索し、そのメンバーIDを返します。上記ツールの member として使用します。

例: "RahulのメンバーIDを探して"

work_journal_get_team_report

期間内の提出済み、保留中、未提出の件数をメンバーごとに1行で返します。

例: "先週EODを逃したのは誰？"

タイプエイリアス

マッチングでは大文字小文字を無視し、スペース、ハイフン、アンダースコアを同等に扱います。

誰が誰のジャーナルを見られるか

このサーバーは独自の権限を強制しません。すべてのリクエストにはあなた自身のSimplified HRセッションが含まれ、Work Journal APIはWeb UIで適用されるのとまったく同じ権限を適用します。

• インスタンス権限 — 会社の任意のメンバーを読むことができます

• グループ権限 — 自分のレポート配下のメンバーを読むことができます

• どちらもない — 自分のジャーナルのみ読むことができ、他のメンバーのジャーナルへの試みは拒否されます

同僚のエントリーを読む際に知っておくべきことが2つあります。リクエストが完全に拒否される可能性があることと、管理者ビューでは下書き、予定済み、非公開エントリーが除外されることです。したがって、エントリーがないことは何も記録されていないことを証明しません。

制限

• work_journal_get_entries は31日を超える範囲を拒否し、work_journal_get_summary を案内します

• ツール呼び出しごとに最大4リクエストが並行して実行されるため、広い範囲でもAPIに優しくなっています

• "先週" などの相対日付は呼び出し前にClaudeによって解決されます。ツールは YYYY-MM-DD のみを受け付けます

ローカルでの実行

npm install
cp .env.example .env      # then fill in the two secrets
WJ_ENV=dev \
WJ_PUBLIC_BASE_URL=http://localhost:8080 \
WJ_TOKEN_KEY=$(openssl rand -hex 32) \
WJ_FINGERPRINT_SECRET=$(openssl rand -hex 32) \
npm start

GET /healthz は {"status":"ok"} を返す必要があります。環境変数なしで node src/index.js を実行すると、不足している変数をすべて列挙して即座に終了しなければなりません。

環境変数

WJ_FINGERPRINT_SECRET はすべてのタスクで同一でなければならず、気軽にローテーションしてはいけません。 これは各メンバーの安定したデバイスフィンガープリントを導出するもので、変更するとチーム全員に確認コードの再入力が求められます。

デプロイに関する注意

• Cookieスティッキネスが必要なのは /authorize のみです。OTP送信はログインを開始したタスクに到達する必要があります。進行中のログインはそのプロセスのメモリに5分間保持されるためです。/mcp と /token はステートレスであり、スティッキーであってはなりません。

• 両方のシークレットはSSMパラメータストアに SecureString として保存し、タスク定義の secrets ブロックから参照します。環境リテラルとして決して使用しないでください。最初のデプロイ前に環境ごとに一度作成してください。プラットフォームの他の何も /hr/work-journal-mcp/ プレフィックスを使用しないため、既に存在することはありません:

  aws ssm put-parameter --type SecureString --name /hr/work-journal-mcp/<env>/token_key           --value "$(openssl rand -hex 32)"
  aws ssm put-parameter --type SecureString --name /hr/work-journal-mcp/<env>/fingerprint_secret  --value "$(openssl rand -hex 32)"

  ecsTaskExecutionRole には両方に対する ssm:GetParameters と kms:Decrypt が必要です。これがないと、このコードが実行される前に、タスクは起動時に ResourceInitializationError で失敗します。

• 本番環境は開発環境で必須の workspace ログインフィールドを拒否するため、ログインページでは開発環境以外では非表示になります。

セキュリティ

• パスワードは保存もログ記録もされず、いかなる形でもブラウザに返されません。ログインに要する数秒間、メモリ上にのみ存在します。

• セッション状態は、このサーバーだけが開くことができるAES-256-GCM暗号化エンベロープで送信されます。Simplified HR JWTがClaudeやモデルに届くことはありません。

• アクセストークン、リフレッシュトークン、認可コードのエンベロープはそれぞれの種類に暗号的にバインドされているため、別の種類として使用することはできません。

• ログイン試行はメールアドレスごとにレート制限されます。

• すべてのツール呼び出しは、呼び出し元、ツール、読み取られたジャーナルのメンバーとともにログ記録されるため、メンバー間の読み取りを監査できます。トークンとエントリー内容は決してログ記録されません。

テスト

npm test