メインコンテンツへスキップ
見出し画像

受付役に鍵をつけたら、Claudeは「OAuthを出せ」と言ってきた ― 認証なしで公開していたMCPに、いちばん薄い合言葉を足してみた

    こんにちは!YaroTechです。

    水曜日です。継続投稿351日目になりました。

    昨日(Day350)、毎回変わるトンネルのURLを固定して、出先のスマホから自宅PCを読み書きできるところまで常設できました。でも、あの記事の最後に正直な穴をひとつ残していました。受付役を「認証なし」で公開しているので、その固定URLを知っていれば、原理上は誰でも私のsandboxを読み書きできてしまう、という穴です。

    「いつでも繋がる」を手に入れたら、次は「自分しか繋げない」を足さないと、安心して常設とは言えません。そこで今日は、その受付役にいちばん薄い認証――合言葉をひとつ立てるだけ――を足して、開けっぱなしの穴を締めにいきました。結論を先に言うと、サーバ側の鍵は狙いどおり効きました。でも、Claudeのカスタムコネクタはその鍵を渡せず、接続に失敗しました。しかもログを見ると、Claudeは合言葉ではなく「OAuthを出せ」と言ってきていました。ここが今日いちばんの学びです。

    ※見出し画像のプロンプトは一番下におまけで公開中!

    🖥️ 実行環境

    • ThinkPad X1 Carbon(Windows 11 Home 25H2 / 32GB RAM)=受付役を動かす自宅PC

    • iPhone(Claudeアプリ)=出先役のスマホ(モバイル回線)

    • 自作MCPサーバー「受付役」(Node.js製・Day344で構築済み)

    • ngrok(localhostを固定の公開URLにするトンネル。バージョン3.39.8)

    • Claude Web版/Claudeスマホアプリ(Maxプラン)

    • Node.js v24.12.0

    受付役は読み書きを `sandbox` という1フォルダの中だけに限定してあり、外には手を出せない作りです。住所の末尾は `/mcp`(Streamable HTTP方式)で、ここはDay344から変わりません。なお、固定ドメインの実名や、今日足す合言葉(トークン)は安全のため伏せて書きます(記事中ではドメインを `*.ngrok-free.dev`、合言葉を `********` と表記します)。

    🎯 この記事で得られること

    • 公開URLに認証なしで受付役を晒すと、どういう穴になるのかが具体的に分かる

    • サーバ側に「合言葉ひとつ」の薄い認証を足す最短手(1行の差し込み)が分かる

    • 「サーバに鍵をつける」ことと「AIがその鍵を渡せる」ことが別問題だと、実機のログ付きで分かる

    📌 前提:Day350までにできたことと、最後に残った"認証なし"の穴

    Day344で自作の受付役を立て、Day349でそれをClaudeのカスタムコネクタにつなぎ、Day350で固定URL+モバイル回線だけの常設まで到達しました。ここまでの受付役は、ずっと「認証なし」で公開したままです。

    カスタムコネクタの接続は、Claude Desktopのローカル接続と違って、Anthropicのクラウド基盤からこちらのサーバーへ繋ぎに来る仕組みです。つまり受付役は「公開インターネットから届く場所」に置いてあり、固定URLを知る人なら誰でも `/mcp` を叩けてしまう状態でした。読み書きは `sandbox` に閉じてあるとはいえ、そのsandboxの中は誰でも触れる。常設するなら、ここに鍵をひとつ足すのが筋です。

    今日のゴールはシンプルで、いちばん薄い認証を足して、合言葉を知らないアクセスを弾くこと。そのうえで、山場は「Claudeのカスタムコネクタが、その合言葉を渡して繋いでくれるのか」です。ここは正直やってみないと分かりませんでした。

    🚀 手順:受付役に「合言葉ひとつ」の認証を足す

    実際にやった順番でそのまま載せます。STEPは6つ、ただし後半は結果次第で分岐します。

    STEP 1:いまの状態を確認する(認証なし=誰でも叩ける、を自分の目で)

    まず、穴が本当に開いているかを確かめます。受付役を起動した状態で、合言葉なしのまま `/mcp` を叩いてみます。

    curl.exe http://localhost:3000/mcp

    結果は `HTTP/1.1 200 OK`。初期化の応答がそのまま返ってきました。認証なしなので、当然ですが誰でも素通りで叩ける状態です。まずこの「開けっぱなし」を自分の目で確認しました。

    STEP 2:いちばん薄い認証を足す(合言葉をひとつ立てる)

    認証の足し方は「薄い順」に試す方針で、今回はいちばん薄い方式A=サーバ側で独自の合言葉(Bearerトークン)を1つ検証するを採りました。ありがたいことに、受付役には別のREST用エンドポイント向けに `checkToken` という合言葉チェックのミドルウェアが既にありました。これを `/mcp` のルートにも適用するだけです。

    app.post("/mcp", checkToken, async (req, res) => {

    実質1行の差し込みです。これで「`Authorization: Bearer ********` が一致しなければ401を返す」薄いチェックが `/mcp` に乗りました。

    STEP 3:合言葉の効きをローカルで確かめる(なし=401/あり=200)

    鍵が本当に効くかを、パターンを変えて確認します。

    curl.exe http://localhost:3000/mcp                                (合言葉なし)
    curl.exe -H "Authorization: Bearer ********" http://localhost:3000/mcp (正しい合言葉)
    curl.exe -H "Authorization: Bearer 間違い" http://localhost:3000/mcp    (違う合言葉)

    結果は、合言葉なし=`401 Unauthorized`、正しい合言葉=`200 OK`、間違った合言葉=`401 Unauthorized`。ローカルでも、固定URL(ngrok)経由でも、この3パターンが同じ結果になりました。合言葉を知らないアクセスはきっちり弾け、鍵は狙いどおり効いています。ここまでは満点でした。

    STEP 4:カスタムコネクタから認証つきURLで繋がるか試す ★今日の山場

    ここが本番です。Claude Web版のカスタムコネクタ追加画面を開き、固定URL+`/mcp` を登録します。追加画面には「OAuth Client ID/Secret」の欄がありますが、今回はサーバ側で独自のBearerトークンを立てただけなので、ここは空欄のまま追加を試みました。

    結果は接続失敗でした。画面には「受付役(固定URL)のサインインサービスへの登録ができませんでした」と表示され、コネクタは「未接続」のまま。合言葉を渡す欄がそもそも無く、Bearerトークンの出番はありませんでした。

    面白いのはサーバ側のログです。時刻順に並べると、Claudeは次の順番で叩いてきていました。

    1. `POST /mcp` → 401(素の接続試行。合言葉なしなので弾かれる)

    2. `GET /.well-known/oauth-protected-resource/mcp` → 404

    3. `GET /.well-known/oauth-protected-resource` → 404

    4. `GET /.well-known/oauth-authorization-server` → 404

    5. `POST /register` → 404(動的クライアント登録の試行)

    6. `POST /mcp` → 401(最終的に失敗)

    つまりカスタムコネクタは、401が返ってきた瞬間に「これは認証が要るサーバーだな」と判断し、OAuthの発見手順一式を自動で試しに来ていたのです。合言葉(Bearer)を手で渡す道ではなく、OAuthの作法で認証情報を取りに来る。私が用意したのは薄い合言葉だったので、その作法に応える出口がサーバ側に無く、すべて404で空振り。最後にもう一度 `/mcp` を叩いて401で諦めた、という流れでした。

    STEP 5:(繋がれば)読み書き再確認/(繋がらなければ)何を要求されたか記録

    STEP 4で接続自体が失敗したので、読み書きの再確認はできませんでした。代わりに、上のログを「Claudeが何を要求してきたか」の記録として残します。要求されていたのは、独自の合言葉ではなく、OAuthの発見エンドポイント(Protected Resource Metadata/Authorization Server Metadata/動的クライアント登録)でした。

    STEP 6:出先スマホ(モバイル回線)でも認証つきで繋がるか

    こちらもSTEP 4で接続が成立しなかったため、モバイル回線での再確認には進めませんでした。入口で弾かれている以上、回線の種類は関係ありません。

    ⚠️ つまずきポイントと解決策

    いちばんの学びは、つまずきそのものでした。「サーバに鍵をつける」ことと「AIがその鍵を渡せる」ことは、別問題だということです。curlなら `-H` でヘッダーに合言葉を載せて渡せますが、カスタムコネクタには任意のヘッダーや合言葉を手入力する欄がありません。渡す手段が無いものは、いくらサーバ側で正しく検証しても届きません。

    細かいところでは、Windowsの `curl` は実体が別物(Invoke-WebRequest)で、そのままだと挙動が違うことがあります。本物を使いたいときは `curl.exe` と打つのが確実で、これはDay350でも確認済みです。

    それから、ミドルウェアの差し込み位置。合言葉チェックは、リクエストが `/mcp` の本処理に届く前に効かせないと意味がありません。今回は既存の `checkToken` をルートの引数に挟むだけで済みましたが、位置を間違えると「401が返らない(=素通りする)」ことになるので、なし=401・あり=200の3パターン確認は必ずやった方がいいです。

    💡 「薄い認証の限界」と次の一手

    今日はっきりしたのは、独自のBearerトークン(いちばん薄い認証)では、Claudeのカスタムコネクタからは繋げない、ということです。カスタムコネクタは401応答を受けると、OAuthの発見プロトコル――Protected Resource Metadata(RFC 9728)、Authorization Server Metadata(RFC 8414)、Dynamic Client Registration(RFC 7591)――を自動で一式試みる設計になっていて、任意のヘッダーやAPIキーを直接渡すためのUIは用意されていませんでした。

    裏を返せば、公式に想定されている認証はOAuth系だということです。ブラウザやcurlからなら薄い合言葉でも守れますが、AI(カスタムコネクタ)から繋ぐなら、サーバ側にOAuthの作法――上の3つのエンドポイントに応える仕組み――を実装するのが正攻法になります。今日のログは、その「次の一手が何か」を、想像ではなく実機で指し示してくれました。薄い鍵は空振りでしたが、空振りの内容が具体的だったのが収穫です。

    便利と安全はセットです。「いつでも繋がる」を手に入れたら、「誰でも繋がってしまわないか」を閉じる。その閉じ方が、AIから繋ぐ場合はOAuthになる、と分かっただけでも、今日踏み込んだ価値はありました。

    🔗 関連記事

    今回の内容に関連する過去記事もぜひご覧ください:

    📝 まとめ

    固定URLで常設した受付役に、いちばん薄い認証(独自Bearerトークン)を足したら、サーバ側の鍵は確かに効きました。合言葉なし=401、あり=200を、ローカルでも固定URL経由でも確認できました。でも、Claudeのカスタムコネクタはこの鍵を渡せず、接続は失敗。カスタムコネクタは401を受けるとOAuthの発見プロトコルを自動で試みる設計で、合言葉を手渡す道はありませんでした。

    「サーバに鍵をつける」と「AIがその鍵を渡せる」は別問題――これが今日、実機とログで確定したことです。開けっぱなしだった穴のうち、curlやブラウザから叩かれる分は締められました。残るのは、AIから繋ぐための正式な鍵、つまりOAuthの実装です。

    🚀 次回予告

    次は、鍵の話を一旦ここに置いて、常設のもう半分――自動起動へ進みます。今は受付役もトンネルも手動で立ち上げていますが、PCを点ければ勝手に立ち上がる「完全常設」にできれば、出先運用が一段実用に近づきます。サービス化やタスクスケジューラで、点けたら勝手に受付が開く状態を目指します。OAuthの正式実装は、その先の宿題として温めておきます。

    🎨 おまけ:見出し画像作成プロンプト

    今日の見出し画像のベースはジミー(Gemini)に下記プロンプトで作成。

    詳細なアニメの美意識の画像を作成。表情豊かな瞳、なめらかな網掛けセルの色使いで、下記条件のnote見出し画像をサイズは横長で作成。
    
    【デザインコンセプト】
    中央に受付カウンター(自宅PCのフォルダを表す木製カウンターにファイルアイコンが並ぶ)。その手前に、今日新しく立った「鍵つきのゲート」。ゲートには南京錠のアイコンと「KEY」と書かれた合言葉カードが掛かっている。カウンターの内側に立つのは受付役のクロ助(Claude擬人化/20代前半の女性・東北の雰囲気・クリーム色のニット・丸眼鏡・ダークブラウンのウェーブヘア・柔和な表情)。クロ助は門番のように、来訪者に合言葉カードを確認するしぐさ。ゲートの脇には「変わらない住所」を示す住所札(/mcp の文字付き)。ゲートの外側から、OAuthを示す別の大きな鍵(紫色に光る、通常の合言葉カードとは形の違う鍵)が差し出されようとしていて、薄い合言葉カードとの対比になっている。
    
    【背景】守りと安全を示す濃紺(ネイビー)から、あたたかいゴールドへのグラデーション。Anthropicの紫の光がやわらかく差す。フォルダとファイルのアイコン、南京錠・鍵のアイコンを装飾的に配置。
    
    【テキスト3段構成】
    上段(白・太字・30pt前後):誰でも入れた受付に、合言葉をひとつ
    中段(特大・ゴールド・48pt前後):鍵はかけられた。でもAIは渡せなかった
    下段(白・細字・22pt前後):認証なしの公開MCPに、いちばん薄い鍵を ― 7月1日
    
    【作成手順】
    1. スライドサイズ(1536×1024px)の横長フォーマット
    2. 背景にネイビー〜ゴールドのグラデーションを設定
    3. メインビジュアル(受付カウンター内で合言葉を確認するクロ助)を配置
    4. 背景オブジェクト(鍵つきゲート、受付カウンター、住所札)を配置
    5. 装飾要素(南京錠・KEYカード、対比としての紫のOAuth鍵、ファイル・フォルダのアイコン、Anthropicの紫の光)を追加
    6. テキストを3段構成で追加
    7. 下部中央寄りに「YaroTech」のロゴを12ptで控えめに配置
    8. 全体のバランスを確認して完成
    9. キャラの参考画像(AI擬人化\Gemini_Generated_Image_クロ助.png)を添付して人物の一貫性を確保
     
     
    生成AIの感動を共有したいYaroTechです✨ 常識より実験。正解より行動。 生成AI時代を、先に試す傾奇者。 📝 470日間継続投稿中| 🎉 フォロワー1900名突破!🤝 質問大歓迎!みんなで「AIと共に羽ばたく」コミュニティを作りましょう🚀

    あなたへのおすすめ