MCP 424 Timeout 해결을 위한 Async HandleId 패턴 도입

Context

Model Context Protocol(MCP) 기반 AI Agent가 외부 API 호출 시 7~10초의 암시적 Timeout 임계치를 초과하여 424 Failed Dependency 에러 발생. 동기식 호출 구조로 인해 외부 서비스 지연 시 Agent 전체 워크플로우가 프리징되는 아키텍처적 한계 존재.

Technical Solution

• 동기식 API 호출을 비동기 작업 기반의 Async HandleId 패턴으로 전환하여 응답성 확보
• start_async_job 도구를 통해 작업 요청 즉시 고유 Job ID를 반환하는 Non-blocking 구조 설계
• asyncio.create_task를 활용한 Fire-and-forget 방식으로 백그라운드에서 실제 외부 API 작업 수행
• check_job_status 도구를 제공하여 Agent가 Job ID 기반으로 작업 상태를 폴링(Polling)하도록 유도
• 메모리 기반 Job Store(Production 시 Redis/DynamoDB 전환)를 통한 작업 상태 관리 및 결과 매핑
• 외부 API 지연 시간에 관계없이 1초 미만의 즉각적인 응답으로 MCP Timeout 원천 차단