技術約6分で読めます

Google ColabのリモートMCPに一度同意して、再ログインなしで接続できた

いけさん目次

Google Colabが11月に公開したリモートMCP(AIエージェントからツールを呼ぶための仕組み)にローカルのLinuxから接続してみた。
ログインや認証情報がない状態でも使えるツール一覧(10個)までは取得できたが、自分のランタイム(Pythonなどを実行する環境)一覧を取る list_runtimes を呼ぶと認証が必要になる。ブラウザで一度だけGoogleの同意画面を許可して更新用のトークンを保存しておけば、別のプロセスから起動し直したときも同意画面を開かずにアクセストークンを取り直して一覧を取得できた。

ノートブックを開かずにGoogleのMCPへつないだ

以前、Google Colabが3月に公開した同じ名前のオープンソースMCPサーバーは、ローカルで起動してブラウザで開いているノートブックを操作する仕組みだった。11月の発表で加わった接続先 https://colaboratory.googleapis.com/mcp はそれとは別で、ブラウザのタブを開かずにGoogle側で動いているMCPサーバーへ直接リクエストを送れる。Colabチームの11月の発表・3月の発表

最初は3月公開のローカル版からFirefoxで試してみた。ローカルで立ち上げたサーバーからはブラウザ接続用のツールが1件返ってきたものの、このツールはブラウザがつながるまで最大60秒待つ実装になっていて、ノートブックとつながらないまま60.19秒で false が返った。接続待ちを実装したコード

そこで11月のリモート接続先へ切り替え、Pythonの標準ライブラリから直接HTTP POSTを送ってみた。MCPの通信では最初にクライアントとサーバーでプロトコルを合わせる initialize を送り、初期化完了の通知のあと tools/list でツール一覧を取って、tools/call でツールを実行する。認証ヘッダーもブラウザのCookieも付けないで、この順番にリクエストを送った結果はこうなった。公式MCPリファレンス

送ったリクエストHTTP返ってきた応答
initialize(通信の初期化)200サーバー名 StatelessServer とプロトコルバージョン 2025-03-26
notifications/initialized(初期化完了の通知)202本文なし
tools/list(利用できるツールの一覧)200list_runtimes や execute_code を含む10件
tools/call で list_runtimes を指定401isError: true と、認証情報が必要というメッセージ

サーバーの仕様だけを返す tools/list までは未認証でも200が返るが、自分のアカウントに割り当てられたランタイムを問い合わせる list_runtimes を呼んだところで401になる。この401応答の再現は、次の curl コマンドでも確認できる。list_runtimesの仕様

curl -i 'https://colaboratory.googleapis.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_runtimes","arguments":{}}}'

リモートMCPへつなぐたびにGoogleへログインするのか

401応答には必要な権限を確認できるURLも含まれていて、開いてみると要求されていたスコープ(アクセス範囲)は https://www.googleapis.com/auth/colaboratory の1件だけだった。401応答の認証メタデータ

公式の導入手順ではGoogle CloudプロジェクトでColab APIを有効にしてOAuthクライアントを用意することになっているが、毎回ブラウザでログインし直すのではエージェントから扱いづらい。Googleのデスクトップアプリ向けOAuthでは、APIを呼ぶための短い寿命のアクセストークンと、それを取り直すためのリフレッシュトークンが発行される。リフレッシュトークンを保存しておけば、別プロセスを起動したときもブラウザを開かずに新しいアクセストークンを取り直せる。Colabチームの導入手順・デスクトップアプリのトークン更新

もっとも、Google CloudのOAuth同意画面で公開設定を「テスト中(Testing)」にしたままだと、リフレッシュトークンは7日で切れる。自分の環境ではすでにアクセス解析・Search Console・AdSenseの読み取り用に使っているデスクトップOAuthクライアントがあり、こちらは公開設定が本番環境(In production)なので7日制限がかからない。Googleの失効条件

既存の3サービスで許可しているのはそれぞれの読み取り権限だけなので、同じ本番クライアントを使ってColabの権限にも一度同意し、既存のトークンファイルとは混ぜないようにColab用のリフレッシュトークンを別ファイルへ保存した。

ローカルのLinux上でそのクライアントを使い、認可結果を受け取るためのローカルポートを待ち受け状態にしてからFirefoxでGoogleの同意画面を開いた。ところが1回目は15分待ってもブラウザから許可の結果が戻らず、待ち受けプロセスがタイムアウトで終了してしまい、あとからFirefoxが元のポートへリダイレクトしてきたときには接続エラーになった。そこで認証をやり直し、新しく開いたタブで許可ボタンを押すと、今度は同じPCの待ち受けポートへ結果が返ってリフレッシュトークンを保存できた。

同意直後に取得したアクセストークンで list_runtimes を呼ぶとHTTP 200が返り、続けて別のPythonプロセスを立ち上げて、保存済みのリフレッシュトークンからアクセストークンを取り直して呼んだ場合も、ブラウザの同意画面を開かずにそのまま200で一覧を取得できた。ただ、確認したのは同じ日のうちだけで、7日以上たったあとも同じトークンで通るかはまだ試していない。

ランタイムを作る前にGPUを使えるか調べた

認証が通ったところで、実際にランタイムを起動する前にアカウントの契約プランと使えるGPUの種類を調べてみた。get_subscription を呼ぶと契約プランはColab Proと返り、list_runtime_specs ではT4・L4・A100・G4が使える判定で、H100だけは対象外だった。なお、この一覧で使える判定になっていても、その時点でGPUに空きがなければ起動できない。公式のマシン選択・起動条件

実際にコードを実行したいときは、create_runtime でランタイムを確保し、create_session で作ったセッションを指定して execute_code でPythonを動かし、使い終わったら delete_runtime で消すことになる(今回はプランと使えるGPUを確かめたところまでで、ランタイム自体は作っていない)。Colab MCPのツール仕様