ともシフト

Claude Desktop 連携の使い方

日本語が正文です。English translation is provided under each section for reference.

できること / What it does

Claude Desktop 用の拡張「ともシフト」(tomoshift.mcpb)を入れると、Claude から起動中のともシフト(Windows デスクトップ版)を操作できます。

Claude ができるのは、画面に入力されている内容を読むこと、ルール設定(使うシフト・曜日別/区分別の必要人数・連勤上限)を組み立てて画面に反映すること、シフト生成を依頼することの 3 つです。

カレンダーに人が入力した希望休・固定シフト・スタッフ情報は Claude が変更しません。反映されたルール設定や生成結果はデータベースには保存されず、利用者が画面で確認してから保存します。

この拡張は、同じ PC で起動中のともシフト本体と localhost(127.0.0.1)で通信するだけで、インターネットや外部サービスには接続しません。ともシフト本体が別途必要で、拡張単体では動作しません。

Installing the Claude Desktop extension "Tomoshift" (tomoshift.mcpb) lets Claude operate the Tomoshift Windows desktop app while it is running.

Claude can do three things: read what is currently entered on screen, build rule settings (which shift types to use, required headcount per weekday / staff category, maximum consecutive work days) and apply them to the screen, and ask the app to generate a schedule.

Claude never changes what people entered in the calendar (day-off requests, fixed shifts, staff information). Applied rule settings and generated results are not saved to the database; the user reviews them on screen and saves manually.

The extension only talks to the Tomoshift app running on the same PC over localhost (127.0.0.1). It never connects to the internet or any external service, and it does nothing on its own without the Tomoshift app.

必要なもの / Requirements

Windows 10/11(64bit)、ともシフト Windows デスクトップ版(Claude 連携対応版)、Claude Desktop for Windows(Microsoft Store 版・通常版のどちらでも可)。

Node.js のインストールは不要です。Claude Desktop に同梱された Node が拡張を動かします。ローカル MCP 拡張は Claude の無料プランでも利用できます。

Windows 10/11 (64-bit), the Tomoshift Windows desktop app (a version with Claude integration), and Claude Desktop for Windows (Microsoft Store or classic installer version).

No Node.js installation is required; the Node runtime bundled with Claude Desktop runs the extension. Local MCP extensions are available on Claude's free plan.

手順 1:ともシフトを起動して接続トークンを確認する / Step 1: Start Tomoshift and get the connection token

ともシフトを起動し、ヘッダーの「Claude と連携」を押します。パネルに「接続トークン」が表示されるので「コピー」を押します。

接続トークンは、ともシフトが初回起動時にこの PC 内で生成したランダムな文字列で、Claude からの接続を認証するためだけに使います。「再発行」で新しいトークンに切り替えられます(その場合は Claude Desktop 側の設定も更新が必要です)。

Start Tomoshift and click "Claude と連携" (Connect with Claude) in the header. The panel shows the connection token; click "コピー" (Copy).

The connection token is a random string generated on this PC when Tomoshift first starts. It is used only to authenticate connections from Claude. "再発行" (Regenerate) issues a new token; the extension setting in Claude Desktop must then be updated.

手順 2:Claude Desktop に拡張を追加する / Step 2: Add the extension to Claude Desktop

パネルの「Claude Desktop に追加」を押すと Claude Desktop が開き、拡張のインストール画面が表示されます。「インストール」を押してください。

うまく開かない場合は、Claude Desktop の「設定 → 拡張機能 → 詳細設定 → 拡張機能をインストール」から、ともシフトの「Claude と連携」パネルで案内される tomoshift.mcpb を選んでください。

拡張がディレクトリに掲載されるまでは、Claude Desktop に「開発者情報は検証されていません」という注意が表示されます。これはローカルで動く拡張すべてに表示される標準の文言です。

Click "Claude Desktop に追加" (Add to Claude Desktop) in the panel. Claude Desktop opens the extension install screen; click Install.

If it does not open, use Claude Desktop's Settings → Extensions → Advanced settings → Install Extension and choose the tomoshift.mcpb file indicated in Tomoshift's "Claude と連携" panel.

Until the extension is listed in the directory, Claude Desktop shows a notice that the developer is not verified. This is the standard notice shown for every locally running extension.

手順 3:接続トークンを設定する / Step 3: Enter the connection token

インストール画面(または拡張の設定画面)の「接続トークン」に、手順 1 でコピーしたトークンを貼り付けて保存します。拡張が有効になっていることを確認してください。

On the install screen (or the extension's settings), paste the token copied in Step 1 into "接続トークン" (Connection token) and save. Make sure the extension is enabled.

手順 4:Claude に話しかける / Step 4: Talk to Claude

ともシフトを起動したまま、Claude Desktop で新しいチャットを開き、次のように話しかけます。

「ともシフトの今の入力を見て」 → 画面のスタッフ・希望休・固定シフト・現在のルール設定を Claude が読みます。

「土日は普通番を最低 3 人、看護師は平日最低 2 人、連勤は 5 日までにして」 → Claude がルール設定を組み立てて検証し、画面のルール設定欄に反映します。画面に「Claude がルール設定を更新しました」と表示されます。

「この条件でシフトを生成して」 → 生成結果が画面のシフト表に表示されます。内容を確認してから保存してください。

With Tomoshift still running, open a new chat in Claude Desktop and try prompts such as the following.

"Show me the current input in Tomoshift" → Claude reads the staff, day-off requests, fixed shifts and current rule settings on screen.

"At least 3 regular shifts on weekends, at least 2 nurses on weekdays, max 5 consecutive work days" → Claude builds and validates the rule settings and applies them to the rule panel. The app shows "Claude がルール設定を更新しました" (Claude updated the rule settings).

"Generate the schedule with these settings" → the result appears in the app's schedule table. Review it before saving.

うまくいかないとき / Troubleshooting

「ともシフトに接続できません」→ ともシフトが起動しているか確認してください。二重起動はできません。

「接続トークンが一致しません」→ ともシフトの「Claude と連携」に表示されているトークンと、Claude Desktop の拡張の設定が一致しているか確認してください。トークンを再発行した後は設定の更新が必要です。

拡張のツールが Claude に表示されない → Claude Desktop の「設定 → 拡張機能」で「ともシフト」が有効になっているか確認し、Claude Desktop を再起動してください。

解決しない場合は tomoshift.support@gmail.com までご連絡ください。

"ともシフトに接続できません" (Cannot connect to Tomoshift) → check that Tomoshift is running. It cannot run twice at the same time.

"接続トークンが一致しません" (Connection token does not match) → make sure the token shown in Tomoshift's "Claude と連携" panel matches the extension setting in Claude Desktop. After regenerating the token, the setting must be updated.

The extension's tools do not appear in Claude → check that "ともシフト" is enabled under Claude Desktop's Settings → Extensions, then restart Claude Desktop.

If the problem persists, contact tomoshift.support@gmail.com.

関連ページ / Related pages

Claude Desktop 拡張のプライバシーポリシー:https://tomoshift.jp/claude/privacy/

サポート・お問い合わせ:https://tomoshift.jp/claude/support/

Privacy policy for the Claude Desktop extension: https://tomoshift.jp/claude/privacy/

Support and contact: https://tomoshift.jp/claude/support/