Async handleId 패턴 도입으로 MCP 424 Timeout 에러 및 에이전트 프리징 해결

Context

Model Context Protocol(MCP) 기반 도구가 지연 시간이 긴 외부 API를 호출할 때 발생하는 동기적 블로킹 구조의 한계점 분석. 특히 7-10초의 암묵적 Timeout 임계치 초과 시 424(Failed Dependency) 에러가 발생하며 AI 에이전트의 전체 워크플로우가 중단되는 병목 현상 확인.

Technical Solution

• 동기적 응답 구조에서 비동기 작업 기반의 Async handleId 패턴으로 아키텍처 전환
• 요청 즉시 고유 Job ID를 반환하는 Fire-and-forget 방식의 start_async_job 설계
• asyncio.create_task를 활용한 백그라운드 작업 수행 및 메인 스레드의 즉각적인 제어권 반환
• check_job_status 폴링 엔드포인트를 통한 상태 확인 및 결과 수신 구조 구현
• 인메모리 Job Store(production 시 Redis, DynamoDB 대체 가능)를 통한 작업 상태 관리
• 응답 지연 5초 이상의 예측 불가능한 외부 API 호출에 대해 비동기 처리 강제 적용