CC逆引きリファレンス

MCP サーバーに CLI から OAuth ログインしたい

7. MCP（Model Context Protocol）

コマンド / 機能

claude mcp login <name> / claude mcp logout <name>

MCP OAuth をコマンドラインから実行

概要

claude mcp login <name> を使うと、MCP サーバーの OAuth 認証をコマンドラインから直接行えます（v2.1.186）。ブラウザが開けないヘッドレス環境では --no-browser を付けると URL とコードが表示され、別端末で認証を完了できます。claude mcp logout <name> でログアウトできます。

設定例

# ブラウザを開いて OAuth ログイン
claude mcp login github

# ヘッドレス環境（ブラウザなし）でログイン
claude mcp login github --no-browser
# → 認証用 URL とコードがターミナルに表示される
# → 別の端末やスマホのブラウザで開いて認証

# ログアウト
claude mcp logout github

# ログイン状態を確認
claude mcp list
公式ドキュメントを見る

こんな時に使う

  • OAuth 認証が必要な MCP サーバーに CLI だけでログインしたい時
  • SSH 接続先やコンテナなどブラウザのないヘッドレス環境で認証したい時
  • トークンが失効した MCP サーバーに再ログインしたい時

使い方

  1. 1claude mcp login <サーバー名> を実行
  2. 2ブラウザが自動で開き OAuth 認証画面が表示される
  3. 3ヘッドレス環境では --no-browser を付けて URL/コードを手動で開く
  4. 4claude mcp logout <サーバー名> でログアウト

Tips

  • v2.1.186 で追加。それ以前は /mcp のインタラクティブ画面からのみ OAuth できた
  • 一時的なネットワークエラーは自動でリトライされるよう改善されている
  • ヘッドレス実行時は自動的にブラウザを開かず --no-browser 相当の挙動になる場合がある

同じカテゴリの記事

MCP 管理画面を開きたい
/mcp
サーバー一覧を見たい
claude mcp list
サーバーを追加したい (HTTP)
claude mcp add --transport http <name> <url>
サーバーを追加したい (stdio)
claude mcp add --transport stdio <name> -- <command>
サーバーを追加したい (SSE)
claude mcp add --transport sse <name> <url>
サーバーを削除したい
claude mcp remove <name>
前の記事
指定した MCP サーバーだけ使いたい
次の記事
特定サーバーの詳細設定を確認したい