개발자 문서
개발자 문서

노코드 자동화 연동

n8n · Make 의 HTTP 노드로 XBOSS MCP 를 워크플로우에 붙이는 방법입니다.

연동 원리

MCP 는 HTTP POST 한 번에 JSON-RPC 요청 하나입니다. 그래서 노코드 도구의 HTTP 요청 노드만으로 부를 수 있습니다.

먼저 tools/list 로 도구 이름을 확인하고, 그 이름으로 tools/call 을 실행합니다.

n8n — HTTP Request 노드 설정

항목값
MethodPOST
URLhttps://api.xdata.kr/mcp
AuthenticationGeneric Credential Type → Basic Auth
Basic Auth 자격증명User 에 client_id, Password 에 client_secret 을 넣습니다(인코딩은 n8n 이 합니다).
Send Body켭니다. Body Content Type 은 JSON, Specify Body 는 Using JSON 을 고릅니다.
JSON아래 본문을 붙여 넣습니다.
Send Headers (데모 환경만)X-MCP-Env-Scope = real_test

요청 본문

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

Make — HTTP "Make a request" 모듈 설정

항목값
URLhttps://api.xdata.kr/mcp
MethodPOST
Authentication typeBasic auth — 사용자 이름에 client_id, 비밀번호에 client_secret
Body content typeapplication/json
Request content위 JSON 본문을 그대로 넣습니다.
Headers (데모 환경만)X-MCP-Env-Scope: real_test

tools/list 응답의 result.tools[*].name 이 tools/call 의 params.name 값입니다. 이름은 XBOSS 작업의 점을 밑줄 두 개로 바꾼 형태입니다 — 예: hometax__session__login.

응답이 오래 걸리는 도구가 있습니다. 서버는 도구 하나를 60초까지, 여러 기관을 한 번에 조회하는 팩 도구를 90초까지 기다린 뒤 시간 초과로 답합니다. 그 답을 받으려면 노드의 타임아웃을 120초로 둡니다. 오류가 오면 MCP 오류 코드에서 코드를 찾습니다.