◉CLAUDE LABEN
●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です
記事一覧/Cowork
◈ Cowork/2026-08-23上級

コネクタが使えない朝に、待つのか人に返すのかを分ける三つの状態

無人実行でコネクタに届かないとき、原因は起動途中・未認証・恒久欠落の三つに分かれます。それぞれ正しい対処が正反対になる理由と、待機予算を切り分ける判定器の実装をまとめました。

cowork16mcp20automation55scheduled-tasks3reliability15

✦ プレミアム記事

朝のログに、一行だけ残っていました。

「該当する機能が見つかりませんでした」。

前日まで問題なく動いていた定時タスクです。手元で同じ手順をなぞると、コネクタは何事もなく応答します。再実行すると成功します。翌朝また同じ一行が残ります。この往復を何度か繰り返して、ようやく腑に落ちました。タスクは嘘をついていたわけではありません。タスクが見たその瞬間には、本当にそのコネクタが存在していなかったのです。

私自身、個人開発の運用でスケジュール実行を増やすほど、この種の「見た時刻に依存する失敗」に足を取られてきました。厄介なのは、失敗の見た目が全部同じになることです。応答しないコネクタを前にしたとき、機械は「無い」としか言えません。けれど無いことの中身は一つではありませんでした。

使えないコネクタは、三つの別々の事情を同じ顔で見せてくる

実行環境のコネクタ一覧を眺めていて気づいたのは、届かない理由が少なくとも三種類に分かれることでした。

一つ目は、まだ起動が終わっていない状態です。バックグラウンドで接続処理が進んでいて、数秒後には一覧に現れます。この状態のコネクタに対して「無い」と判定するのは、単に早すぎるだけです。

二つ目は、認証が切れている状態です。トークンの期限が過ぎているか、初回の認可がまだ済んでいないか、そのどちらかです。サーバー自体は生きていて、名前も見えているのに、呼ぶと弾かれます。そして無人実行では、ここが決定的に効いてきます。認可のやり取りには人間のブラウザ操作が要るため、待っても永遠に直りません。

三つ目が、そもそも接続されていない状態です。設定から外れているか、環境が変わって配信されなくなったかのいずれかです。これも待っても現れません。ただし対処は二つ目とは別物で、こちらは代替経路を探すか、機能そのものを諦める判断になります。

同じ「使えない」でも、正しい振る舞いが三方向に分かれます。ここを一つに畳んでしまうと、待つべきときに諦め、諦めるべきときに待ち続けることになります。

状態実体時間で解決するか既定の振る舞い
connecting接続処理が進行中する(多くは数秒)予算内で待つ
unauthenticated認可が未了・期限切れしない(人の操作が必要)即座に人へ返す
absent未接続・配信されていないしない代替経路か、機能を落とす

三状態を分ける最小の判定器

判定に必要な材料は多くありません。実行時点で使えるツールの一覧、接続処理中のサーバー名、認証待ちのサーバー名。この三つが取れれば分類できます。純関数にしておくと、後でテストが書けます。

// resolver.mjs — コネクタの「使えなさ」を三状態に分類する
export const READY = "ready";
export const CONNECTING = "connecting";
export const UNAUTHENTICATED = "unauthenticated";
export const ABSENT = "absent";
 
// mcp__google-drive__search → "google-drive"
// 組み込みツール(Bash 等)はサーバーを持たないので "builtin"
export function serverOf(toolName) {
  const m = /^mcp__([^_]+(?:_[^_]+)*?)__/.exec(toolName);
  return m ? m[1] : "builtin";
}
 
export function classify(toolName, snapshot) {
  const { readyTools, pendingServers, unauthenticatedServers } = snapshot;
 
  // 1. 使えるなら、それ以上の詮索は不要
  if (readyTools.includes(toolName)) return READY;
 
  const server = serverOf(toolName);
 
  // 2. 認証を先に見る。ここを後回しにすると「待てば直る」と誤判定する
  if (unauthenticatedServers.includes(server)) return UNAUTHENTICATED;
 
  // 3. 接続処理中なら、まだ結論を出さない
  if (pendingServers.includes(server)) return CONNECTING;
 
  // 4. どれでもなければ、この実行では存在しない
  return ABSENT;
}

判定の順序に意味があります。認証チェックを接続チェックより先に置いているのは、認証待ちのサーバーが同時に「接続処理中」としても現れることがあるからです。順序を逆にすると、永遠に直らないものを延々と待つ実装になります。この一行の並び順が、後述する待ち時間の差をそのまま生みました。

✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦コネクタに届かない原因を起動途中・未認証・恒久欠落の三つに切り分けて、それぞれ別の対処へ自動で振り分けられるようになる
✦無人タスクが「その機能はありません」と誤って報告し、静かに空振りする事故を、公開前の設計段階で防げるようになる
✦能力の確認を実行の入口ではなく使用の直前に置き直して、起動順序に左右されないタスクへ書き換えられるようになる
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

◈ Cowork2026-05-04
Cowork スケジュールタスクが黙って止まる理由と、自動で立ち直る仕組みの作り方
Coworkのスケジュールタスクが黙って止まる原因を、実測した終了コードとエラー文で切り分けます。safe.directory が失敗を遅らせる仕組み、書ける場所を先に決めるプリフライト、理由コード付きログまで扱います。
◈ Cowork2026-10-08
毎回読ませる指示ファイルを半分にした夜、削る前に3つの引き出しへ分けました
指示ファイルが長くなるほど、書いたはずの決まりごとが守られなくなります。毎回読ませる分を半分にするため、残す・移す・捨てるの3つに分けた基準と、見出しごとの大きさを測る小さなスクリプトをまとめます。
◈ Cowork2026-09-08
毒入りサンプルを置くまで、無人の検査は一度も落ちていませんでした
無人スケジュールで回している検査が、ログ整形のパイプ一本で終了コードを失っていました。消える経路を手元で測って切り分け、検査自身を検査する小さなハーネスまで組みます。