Sentry や Linear、Notion のようなホスト型の MCP サーバーは、URL を登録しただけでは使えません。ブラウザでのサインインが要ります。claude mcp list に ! Needs authentication と出るのがその状態です。
結論として、claude mcp add --transport http <名前> <URL> で追加したあと、セッション内で /mcp を開いてサーバーを選び Authenticate を実行するか、シェルから claude mcp login <名前> を実行します。トークンは安全に保存され、自動で更新されます。
この記事はシリーズの一部です。サーバーの追加方法全体は Claude Code に MCP サーバーを追加する方法 を参照してください。
要点
この記事で分かること
/mcpとclaude mcp loginの 2 つのサインイン方法- コールバックポートを固定する
--callback-portと、事前登録した client ID の渡し方- トークンが切れたとき、ブラウザが開かないときの対処
まとめ
-
claude mcp add --transport http <名前> <URL>で追加し、/mcpのAuthenticateかシェルのclaude mcp login <名前>でサインインする -
claude mcp logout <名前>と/mcpの「Clear authentication」で認証を取り消せる - ブラウザのない環境では
claude mcp login --no-browserで URL を表示し、リダイレクト URL を貼り戻す - 動的クライアント登録に非対応なら
--client-idと--callback-port、必要なら--client-secretを使う - トークンが拒否されたら
/mcpの Re-authenticate。スコープ不足はoauth.scopesに足してからサインインし直す
設定例・手順の全文はこちらで公開しています: Claude Code でリモート MCP サーバーに OAuth ログインする手順:/mcp と claude mcp login
※ この記事は要約版です。仕様変更に合わせた更新は上記ページで行います。