--- slug: "sentry-cli-multi-profile-zsh-wrapper" title: "MCP より Skill + CLI。Sentry MCP をやめて マルチプロファイル対応 CLI にした" description: "sentry-cli にはネイティブなマルチプロファイル機能がないため、AWS CLI の --profile のように使える zsh ラッパー関数を作成した。Claude Code のスキルとしても登録し、AI エージェントからも自然に操作できるようにした。" url: "https://www.ytyng.com/blog/sentry-cli-multi-profile-zsh-wrapper" publish_date: "2026-02-22T03:38:29.138Z" created: "2026-02-22T03:38:29.139Z" updated: "2026-02-27T11:57:07.120Z" categories: [] keywords: "" featured_image_url: "https://media.ytyng.com/resize/20260226/9eaf38c3ee1a48639aa93a16efc03f1c.png.webp?width=768" has_video: true has_music: true video_urls: ["https://media.ytyng.net/ytyng-blog/336/featured-video-1.mp4", "https://media.ytyng.net/ytyng-blog/336/featured-video-2.mp4", "https://media.ytyng.net/ytyng-blog/336/featured-video-3.mp4"] music_urls: ["https://media.ytyng.net/ytyng-blog/336/featured-music-336-1.mp3", "https://media.ytyng.net/ytyng-blog/336/featured-music-336-2.mp3"] lang: "ja" --- # MCP より Skill + CLI。Sentry MCP をやめて マルチプロファイル対応 CLI にした ## 背景 Sentry の CLI ツール [`sentry-cli`](https://docs.sentry.io/cli/) を複数の組織 (Organization) で使いたいが、AWS CLI の `--profile` のようなネイティブなマルチプロファイル機能は存在しない。 ### sentry-cli のインストール ```bash brew install getsentry/tools/sentry-cli ``` ### 設定の優先順位 公式ドキュメント ([Configuration and Authentication](https://docs.sentry.io/cli/configuration/)) によると、設定は以下の優先順位で読み込まれる: 1. コマンドライン引数 (`-o`, `-p`, `--auth-token`) 2. 環境変数 (`SENTRY_AUTH_TOKEN`, `SENTRY_ORG`, `SENTRY_PROJECT`) 3. カレントディレクトリから上方向に `.sentryclirc` ファイルを検索 4. `~/.sentryclirc` (グローバルデフォルト) `.sentryclirc` はファイル名が固定で、リネームした別名のファイル(`.sentryclirc-staging` 等) は読み込まれない ([参考](https://github.com/getsentry/sentry-javascript/discussions/7638))。 ## Sentry MCP Server はどうか Sentry は [MCP サーバー](https://docs.sentry.io/product/sentry-mcp/) も提供しており、AI エージェントから直接 Sentry を操作できる。しかし、いくつかの課題がある: - **旧版 (stdio transport + Auth Token) は事実上の後継版に置き換えられた**。[sentry-mcp-stdio](https://github.com/getsentry/sentry-mcp-stdio) リポジトリは「教育目的」として残っているが、現在は [リモート版 MCP サーバー](https://github.com/getsentry/sentry-mcp) の使用が推奨されている - **新版 (OAuth + Streamable HTTP) は、セッションの有効期限が切れるたびに再認証が必要**。ブラウザで OAuth 認証フローを再度行う必要があり、作業の流れが中断されるのがストレスになる - **コンテキストを大量消費する**。Sentry のイベントやイシュー情報は構造が複雑で、MCP のツール定義だけでもかなりのトークンを使う - **マルチアカウントに対応していない**。複数の MCP サーバーインスタンスを作ることで対応は可能だが、消費コンテキストがインスタンス数に比例して増えるのでつらい 結局、CLI ラッパー + AI エージェントのスキルという構成の方が、軽量かつ柔軟に扱える。 ## 解決策: zsh ラッパー関数 zsh の function は PATH 上の同名バイナリより常に優先されるため、`sentry-cli` という名前の function を定義するだけで、brew でインストールした本物の `sentry-cli` をラップできる。 ### プロファイルの保存場所 ```bash ~/.config/sentry-cli/profiles/.env ``` 中身はシンプルな env ファイル: ```bash SENTRY_AUTH_TOKEN=sntrys_xxx... SENTRY_ORG=my-org SENTRY_URL=https://my-org.sentry.io/ ``` `SENTRY_PROJECT` はプロファイルに固定せず、コマンド実行時に `-p` で指定する運用が良い。1つの org に複数の project があるのが普通なので。 ### ラッパー関数 `~/.zshrc` や alias ファイル等に以下の function を追加する: ```bash # sentry-cli wrapper with --profile support # Profiles: ~/.config/sentry-cli/profiles/.env function sentry-cli () { local _sentry_cli # whence -p: function を無視してバイナリのパスだけ返す _sentry_cli=$(whence -p sentry-cli) || { echo "sentry-cli not found in PATH" >&2; return 1; } local profile_dir="${HOME}/.config/sentry-cli/profiles" local profile="" local setup=0 local args=() while [[ $# -gt 0 ]]; do case "$1" in --profile=*) profile="${1#--profile=}"; shift ;; --profile) profile="$2"; shift 2 ;; --profiles) if [[ -d "$profile_dir" ]]; then for f in "$profile_dir"/*.env(N); do echo "${f:t:r}" done else echo "No profiles directory: $profile_dir" >&2 fi return 0 ;; --setup) setup=1; shift ;; *) args+=("$1"); shift ;; esac done # --setup: create or edit a profile if [[ $setup -eq 1 ]]; then if [[ -z "$profile" ]]; then echo "Usage: sentry-cli --profile= --setup" >&2 return 1 fi mkdir -p "$profile_dir" local pfile="${profile_dir}/${profile}.env" if [[ -f "$pfile" ]]; then echo "Editing existing profile: $profile" else echo "Creating new profile: $profile" cat > "$pfile" <&2 echo "Run: sentry-cli --profile=${profile} --setup" >&2 return 1 fi # サブシェルで source して現在の環境変数を汚さない ( set -a source "$pfile" set +a "$_sentry_cli" "${args[@]}" ) } ``` ### ハマりポイント: `command -v` の罠 最初の実装では `command -v sentry-cli` でバイナリパスを取得していたが、zsh の `command -v` は同名の function 自身も返してしまうため、**無限再帰**になり `maximum nested function level reached; increase FUNCNEST?` エラーが発生した。 `whence -p` を使うことで、function を無視してバイナリパスだけを取得できる。これは zsh 固有のビルトインコマンド。 ### 使い方 ```bash # プロファイル作成 (エディタが開く) sentry-cli --profile=myorg --setup # 接続確認 sentry-cli --profile=myorg info # プロジェクト一覧 sentry-cli --profile=myorg projects list # リリース一覧 (プロジェクト指定) sentry-cli --profile=myorg releases list -p my-project # プロファイル一覧 sentry-cli --profiles # プロファイルなし (通常の sentry-cli として動作) sentry-cli info ``` ## Claude Code のスキルとして登録 このラッパーを [Claude Code](https://claude.ai/claude-code) のスキルとしても登録した。SKILL.md を書いておくことで、AI エージェントが自然に `sentry-cli --profile=xxx` を使って Sentry を操作できるようになる。 以下がスキル定義の全体像: ```markdown --- name: sentry-cli description: Sentry CLI のマルチプロファイル対応ラッパー。リリース管理・ソースマップアップロード・イベント送信など。 allowed-tools: Bash(sentry-cli:*) --- # Sentry CLI (multi-profile wrapper) Sentry CLI をマルチプロファイルで使うための zsh ラッパー。 ## 重要: 操作前にヘルプを確認 sentry-cli のサブコマンドや引数が不明な場合、まずヘルプを読むこと。 sentry-cli --help sentry-cli --help ## プロファイル管理 ### プロファイル作成・編集 sentry-cli --profile= --setup ### プロファイル一覧 sentry-cli --profiles ### プロファイルを指定して実行 sentry-cli --profile= [options] ### プロファイルなしで実行 (通常の sentry-cli として動作) sentry-cli [options] ## よく使うサブコマンド - info: 接続情報と認証状態を確認 - releases: リリースの一覧・作成・ファイナライズ - sourcemaps: ソースマップのアップロード - send-event: テストイベントの送信 - deploys: デプロイの記録 - issues: イシューの一覧・解決 - projects: プロジェクトの一覧 ``` ポイントは: - **`allowed-tools: Bash(sentry-cli:*)`** で、エージェントに `sentry-cli` コマンドの実行を許可 - **操作前に `--help` を読む指示**を含めることで、サブコマンドの引数ミスを防ぐ - **プロファイル管理コマンド**と**よく使うサブコマンド**をリファレンスとして記載し、エージェントがすぐに使えるようにする ## まとめ - sentry-cli にはネイティブなマルチプロファイル機能がない - Sentry MCP Server は OAuth の再認証やコンテキスト消費の問題があり、マルチアカウント対応も弱い - zsh function でラップすれば、`--profile` オプションで簡単に切り替えられる - `whence -p` を使わないと無限再帰になるので注意 - Claude Code のスキルとして登録すれば、AI エージェントからもシームレスに操作可能