Deputy MCP

Deputy MCP

Claude に 「次の勤務はいつですか？」 と尋ねると、 Deputy の勤務表から回答が得られます。

Deputy MCP はローカルの MCP サーバーで、AI エージェントが シフト、タイムシート、チームのスケジュールを読み取れます。また、有効にした場合に限り、それらに対する操作も行えます。 お使いのマシン上で動作し、Deputy に接続します。通常の 従業員アカウントで利用できます。

できること

• 「次の勤務はいつですか？」
• 「先週は何時間働きましたか？」
• 「今、シフトに入っているのは誰ですか？」（マネージャーアクセス）
• 「出勤打刻してください。」（書き込みが有効な場合）
• 「土曜日の空きシフトに入れてください。」（書き込みが有効な場合。最初に確認を求めます）

インストール

uv と Python 3.11 以降が必要です。まずアクセス モードを選択してください。

モード	対象ユーザー	はじめに
OAuth	すべての従業員	従業員のサインイン
API token	Deputy 管理者	管理者向けセットアップ
Calendar feed	API アクセスがない場合	クライアントのセットアップを使ってDEPUTY_CALENDAR_URLを設定します。自分の勤務表のみで、読み取り専用です

従業員向け OAuth

https://once.deputy.com/my/oauth_clients で、リダイレクト URI を http://localhost:8823/callback に設定した個人用アプリを作成します。インストール内の Settings → Developer ではなく、上記の場所で作成してください。インストール内で作成したアプリではサインイン時に invalid_client エラーが発生します。Bash でプレースホルダーを置き換えてサインインし、Claude Code にサーバーを登録します。

export DEPUTY_OAUTH_CLIENT_ID='your-client-id'
export DEPUTY_OAUTH_CLIENT_SECRET='your-client-secret'
uvx deputy-mcp login
claude mcp add deputy \
  -e DEPUTY_OAUTH_CLIENT_ID="$DEPUTY_OAUTH_CLIENT_ID" \
  -e DEPUTY_OAUTH_CLIENT_SECRET="$DEPUTY_OAUTH_CLIENT_SECRET" \
  -- uvx deputy-mcp

ログインするとブラウザーが開き、既定では OAuth トークンが OS のキーチェーンに保存されます。 ログインと Claude Code は同じ OS ユーザーで実行してください。ターミナルを使えない場合（たとえば Claude Desktop バンドルの場合）は、2 つの OAuth 値を設定し、アシスタントにサインインを依頼してください。 deputy_login ツールが同じブラウザーサインインを開きます。

管理者向け API トークン

Deputy API トークンとインストール URL があれば、OAuth ログインを使わずに直接登録できます。

claude mcp add deputy \
  -e DEPUTY_API_TOKEN=your-deputy-token \
  -e DEPUTY_BASE_URL=https://your-company.eu.deputy.com \
  -- uvx deputy-mcp

Codex CLI

自分の勤務表を取得する場合は、... を個人用のカレンダーフィード URL に置き換えてください。

codex mcp add deputy --env DEPUTY_CALENDAR_URL=... -- uvx deputy-mcp

最初の uvx の実行時に依存関係がダウンロードされます。Codex でツールを利用できないと表示される場合は、 ~/.codex/config.toml の [mcp_servers.deputy] の下に startup_timeout_sec = 60 を設定してください。

Claude Desktop のユーザーは、リリースページ から .mcpb バンドルをダウンロードし、Settings → Extensions にドラッグしてください（Windows ではダブルクリックしても開かない場合があります）。Configure でいずれかのアクセスモードを設定し、Claude にサインインを依頼してください。 その他の MCP クライアントと Docker については、その他のインストール方法を参照してください。 すべての設定は .env.example に記載されています。

ツール

• 自分のデータ（すべてのアカウント）：deputy_whoami、deputy_get_my_roster、 deputy_next_shift、deputy_get_my_timesheets、deputy_get_my_colleagues、 deputy_get_my_calendar_url、deputy_get_areas
• チーム（マネージャーアクセス）：deputy_get_team_roster、deputy_who_is_working、 deputy_get_employee_info、deputy_search_shifts
• 操作（DEPUTY_ALLOW_WRITES=true の場合のみ）：deputy_clock_in、 deputy_clock_out、deputy_set_unavailability、 deputy_claim_open_shift

デフォルトで安全

• DEPUTY_ALLOW_WRITES=true を設定しない限り、読み取り専用です。設定するまで、エージェントにはアクションツールが存在しません。
• シフトを申請する前に、ユーザーが確認します。申請すると、Deputy の承認手順が省略されるためです。
• 推測しません：名前が複数の人物に一致する場合、最初の人物ではなく候補一覧を表示します。
• 認証情報の保護：デフォルトでは、トークンの送信先は https://*.deputy.com のみで、OAuth トークンは OS のキーチェーンに保存されます。エージェントに表示される前に、エラーからシークレット情報が除去されます。

ステータス

日常的に使用する読み取りツールと OAuth サインインは、従業員アカウントを使って実際の Deputy 環境でテスト済みです。マネージャーツール、アクション、OAuth トークンの更新は自動テストでカバーされていますが、実環境ではまだ検証されていません。Deputy とは無関係です。

詳細

• 構築方法とその理由
• コントリビューション · セキュリティ · 変更履歴 · ロードマップ

ライセンス

MIT