Perforce 公式 MCP で Claude Code から操作して AI が扱える範囲と扱えない範囲を確認した

mkdir -p p4root
p4d -r "$PWD/p4root" -p 1666 -L "$PWD/p4d.log" -J "$PWD/p4root/journal" -d
# 検証用に認証を無効化する。本番では設定しない
p4 -p 1666 configure set security=0

# 照会用: read-only。書き込み系のツールは公開されない
claude mcp add p4lab \
  --env P4PORT=localhost:1666 --env P4USER=tester_a --env P4CLIENT=ws_a \
  -- uvx p4mcp-server --readonly

# 書き込み用: --readonly を付けない
claude mcp add p4lab-rw \
  --env P4PORT=localhost:1666 --env P4USER=tester_a --env P4CLIENT=ws_a \
  -- uvx p4mcp-server

【プロンプト】
接続中の Perforce サーバーの情報を教えて

【回答 (一部抜粋)】
接続中の Perforce サーバー情報は以下のとおりです。

## サーバー
| 項目 | 値 |
|---|---|
| サーバーアドレス | `localhost:1666` |
| サーバーバージョン | P4D/MACOSX12ARM64/2025.2/2907753 (2026/03/09) |
| サービス種別 | standard |
| ライセンス | none (未設定) |

## 認証ユーザー
| 項目 | 値 |
|---|---|
| ユーザー | `tester_a` |
| 種別 | standard |
| 認証方式 | perforce |

ローカル (`localhost:1666`) で稼働している検証用の P4D サーバーです。

【プロンプト】
changelist を新しい順に一覧して。誰が何を変えたか要約して

【回答 (補足は省略)】
チェンジリストを新しい順に一覧します。全6件すべて `//depot` への submit 済みで、ユーザーは `tester_a` と `tester_b` の2名です。

## 新しい順チェンジリスト一覧
| CL | 日時 (JST) | ユーザー | 概要 |
|---|---|---|---|
| 6 | 07/18 20:30 | tester_a | branch1 へブランチ作成 (lazy copy) |
| 5 | 07/18 20:08 | tester_a | model.uasset を追加 |
| 4 | 07/18 20:05 | tester_b | assetW.bin を編集 |
| 3 | 07/18 20:05 | tester_a | assetW.bin を編集 |
| 2 | 07/18 20:04 | tester_a | assetW.bin を追加 |
| 1 | 07/18 20:02 | tester_a | ベースライン作成 |

## 誰が何を変えたか (詳細)
- CL4 — tester_b「B edits assetW」assetW.bin を編集 (rev.3)。type は binary+w (非排他)。CL3 の tester_a の編集に続けて、同じファイルを別ユーザーが更新できている。
- CL1 — tester_a「baseline: notes.txt (text), assetX/Y.bin (binary+l)」notes.txt (text)、assetX.bin・assetY.bin を排他ロック (binary+l) で追加。

【プロンプト】
//depot/notes.txt の中身を見せて

【回答】
`//depot/notes.txt` の中身です (rev.1、text、21 bytes)。

```
baseline notes
line2
```

CL1 のベースラインで追加されて以降、変更はありません (rev.1 のまま)。

【プロンプト】
//depot/assetX.bin の中身を見せて

【回答】
`//depot/assetX.bin` は **バイナリファイル**(type: `binary+l`、サイズ 1,048,576 バイト = 1MB)です。テキストではないため、中身をそのまま表示しても意味のある内容にはならず、ターミナルにも収まりません。

メタ情報は以下のとおりです。

| 項目 | 値 |
|------|-----|
| head Rev | #2 (CL2) |
| 種別 | binary+l(排他ロック付きバイナリ) |
| サイズ | 1,048,576 バイト (1MB) |
| digest | 05DE508D48FD6E6CB0D6236D77FC0BB4 |

このdigestは CL6 でブランチされた `//depot/branch1/assetX.bin` #1 と一致しており、branch1 はこの内容を lazy copy したものです。

なお、binary+l のバイナリ内容をターミナルに直接ダンプするのはトークンを大量消費し実用的でないため、そのままの表示は避けています。

【プロンプト】
説明文を『notes.txt のベースラインメモを更新』とした pending changelist を作成してください

【回答】
pending changelist を作成しました。

| 項目 | 値 |
|------|-----|
| Changelist | 9 |
| ステータス | pending |
| 説明 | notes.txt のベースラインメモを更新 |
| ユーザー / クライアント | tester_a / ws_a |

現時点ではファイルは未追加 (空の pending) です。

【プロンプト】
//depot/notes.txt を編集用に開いてください

【回答】
`//depot/notes.txt` を編集用に開きました。

| 項目 | 値 |
|------|-----|
| Changelist | 9 (pending) |
| depot ファイル | `//depot/notes.txt` |
| 対象リビジョン | #1 → 編集中 |
| action | edit |
| 種別 | text+D |

ローカルの notes.txt が書き込み可能になり、CL9 に載りました。

【プロンプト】
編集用に開いている //depot/notes.txt を、新しい pending changelist に入れて shelve してください

【回答】
完了しました。

## 実施内容
| ステップ | 結果 |
|---------|------|
| 新規 pending changelist 作成 | CL10 (説明: 「notes.txt の編集を shelve するための changelist」) |
| ファイル移動 | `//depot/notes.txt` を CL9 → CL10 へ移動 |
| shelve | CL10 の `//depot/notes.txt` #1 (edit) を shelve 済み |

## 現在の状態
- CL10 (pending): `//depot/notes.txt` が編集用にオープン、かつ shelve 済み。
- CL9 (pending): ファイルがなくなり、空の状態になりました。

【プロンプト】
作成した changelist を削除してください

【回答 (一部抜粋)】
両方 (CL9・CL10) を削除します。CL10 の shelve 削除 → ファイル revert → changelist 削除の順で進めます。

## 実施内容
| ステップ | 結果 |
|---|---|
| CL10 の shelve 削除 | `//depot/notes.txt` の shelve を削除 |
| ファイル revert | `//depot/notes.txt` を revert (未変更のため影響なし) |
| CL10 削除 | Change 10 deleted |
| CL9 削除 | Change 9 deleted |

開いているファイル・pending changelist は残っていません。クリーンな状態に戻りました。