지식센터 / 레퍼런스

n8n MCP 오류 진단 체크리스트 & 트러블슈팅

# n8n MCP 오류 진단 체크리스트

MCP 서버 연결 실패 시

• [ ] 워크플로우가 Publish 상태인가? (Save만으로는 프로덕션 URL 비활성)
• [ ] Production URL 사용 중인가? (/mcp/ 경로, -test 아님)
• [ ] 인증 토큰이 클라이언트-서버 간 일치하는가?
• [ ] SSE 엔드포인트 테스트: curl -H "Accept: text/event-stream" <MCP_URL>/sse

MCP Tool 호출 무한 대기 시

• [ ] Sub-workflow에 JavaScript Code 노드 포함? → Python 또는 내장 노드 대체 (GitHub #19902 버그)
• [ ] Code 노드 로직 60초 이내 완료되는가? (Task Runner 타임아웃)
• [ ] Sub-workflow 독립 실행 시 정상 완료되는가?
• [ ] 전체 실행 시간 5분 이내? (MCP 하드 타임아웃)

파라미터 에코백 (입력값만 그대로 반환)

• [ ] Tool Code 노드에서 fetch() 사용 시도? → Cloud에서 불가. HTTP Request 노드 사용
• [ ] Sub-workflow가 존재하고 Active 상태인가?
• [ ] MCP Trigger의 Tool 연결이 올바른가? (노드 연결선 확인)

Supabase API 호출 실패

• [ ] apikey + Authorization: Bearer 두 헤더 모두 설정?
• [ ] Content-Type: application/json 포함?
• [ ] RLS 정책이 해당 작업 허용? (빈 결과 = RLS 차단 가능)
• [ ] 내장 Supabase 노드 대신 HTTP Request 노드 사용? (403 버그 #17020 우회)
• [ ] service_role 키 만료/로테이션 확인

Webhook 프로덕션 URL 미작동

• [ ] 워크플로우 Publish 확인 (v2에서 Save ≠ Publish)
• [ ] URL에 -test 포함 여부 확인
• [ ] 같은 path+method의 다른 워크플로우 충돌 확인

Code 노드 타임아웃 ("Task request timed out after 60 seconds")

• [ ] 로직 경량화 (무거운 처리는 Sub-workflow 분리)
• [ ] 대량 데이터는 Loop/SplitInBatches로 1건씩 처리
• [ ] 외부 API 호출 시 HTTP Request 노드 사용 (Code 노드 내 HTTP 불가)

워크플로우 Import/Export 시

• [ ] 대상에 필요한 Credential 미리 생성
• [ ] Credential 이름 일치 (ID가 아닌 이름 매핑)
• [ ] v2 워크플로우를 v1에 임포트하면 실패
• [ ] JSON에서 하드코딩된 API키/instanceId 제거

Cloud 워크플로우 조용한 실패

• [ ] 메모리 제한 초과: Loop 1건씩 처리
• [ ] Executions 탭에서 실행 기록 확인
• [ ] 월별 실행 횟수 한도 확인 (Starter 2,500회)
• [ ] Cloudflare 100초 타임아웃: Respond to Webhook → 비동기 처리

핵심 GitHub Issues 추적

• #19902: MCP + JS Code 노드 행 (Sub-workflow 사용 시)
• #17020: Supabase 노드 403 (충돌 인증 헤더)
• #17428: MCP Client SSE 핸들링
• #16989: MCP 파라미터 전달 제한
• #19882: 장기 가동 후 트리거 등록 실패

커뮤니티 검증 MCP 템플릿

• n8n.io/workflows/3641: MCP Supabase Agent (CRUD)
• n8n.io/workflows/3675: MCP Supabase + RAG + Multi-Tenant
• n8n.io/workflows/3638: Custom API MCP Server

관련 문서

이 문서를 참조하는 문서 (역링크)

• 없음

다른 표현: Markdown · JSON · 최종 갱신 2026-08-24