Make.com MCP 엔드포인트 통합 과정의 4가지 아키텍처적 제약 해결

Make.com has an MCP endpoint now. The auth token goes in the URL — and 3 other walls the docs skip

אחיה כהן2026년 6월 14일5분intermediate

AI 요약

Context

AI Agent를 통해 Make.com 시나리오 블루프린트를 원격으로 수정하고 복구하는 자동화 파이프라인 구축 시도. 공식 문서에 누락된 WAF 차단, 비표준 JSON 스펙, 경로 기반 인증 등 실제 API 구현과 명세 간의 괴리로 인한 통합 병목 발생.

Cloudflare WAF의 User-Agent 기반 403 차단 해결을 위해 Python-urllib 대신 curl을 통한 요청 전달 구조 채택
시나리오 목록 조회 시 Organization ID가 아닌 Team ID 기반의 계층 구조(Organization → Team → Scenario)를 통한 스코핑 적용
블루프린트 JSON 내 raw control character 포함으로 인한 파싱 오류 해결을 위해 Python json.loads의 strict=False 옵션을 활용한 관용적 파싱 구현
Bearer Header 인증 시 404 에러가 발생하는 MCP 엔드포인트의 특성에 따라 Token을 URL Path에 직접 포함하는 비표준 인증 방식 적용
보안 유출 방지를 위해 Token을 설정 파일에 기록하지 않고 macOS Keychain에서 런타임에 동적으로 호출하는 쉘 스크립트 브릿지 설계

실천 포인트

1. API 통합 시 HTTP 라이브러리 전의 curl 테스트로 WAF 차단 여부 확인

2. JSON 파싱 에러 발생 시 strict 모드 해제로 제어 문자 포함 여부 검토

3. 경로 기반 토큰 인증 시 환경 변수나 Keychain을 통한 런타임 주입 구조 설계

4. API 리소스 계층 구조(Org vs Team)를 정밀하게 분석하여 정확한 식별자 매핑

태그