DeerFlow：ByteDance製オープンソースAgentフレームワークでMCPプロトコル経由でGPT-5.5を統合する実践ガイド

私は2026年1月から、社内R&D部門でマルチAgentオーケストレーション基盤の刷新プロジェクトを担当しています。最初の週末に遭遇したのが、DeerFlowとGPT-5.5をMCP（Model Context Protocol）で接続した直後に発生する ConnectionError: timeout と 401 Unauthorized のダブルパンチでした。本記事では、その障害から学んだ教訓と、現在の本番環境で3ヶ月連続無停止稼働している構成を共有します。

事の発端：ConnectionError と 401 Unauthorized

私が遭遇した最初のエラーは、DeerFlowの mcp_client.py からMCPクライアントを起動し、GPT-5.5エンドポイントへ接続した瞬間に発生しました。当時は公式のLLMプロバイダー直叩き構成で、平均レイテンシは320ms、ピーク時には1,200msまで跳ね上がっていました。

Traceback (most recent call last):
  File "deerflow/mcp_client.py", line 142, in client.connect()
    self._session = await self._open_session()
  File "deerflow/mcp_client.py", line 198, in self._open_session()
    await self._http.post(url, json=payload, timeout=30)
  File "httpx/_client.py", line 1747, in send
    raise ConnectError(message)
httpx.ConnectError: Connection timeout after 60s (SSE stream stalled)

次に、APIキーを修正