노코드 자동화 연동
n8n · Make 의 HTTP 노드로 XBOSS MCP 를 워크플로우에 붙이는 방법입니다.
연동 원리
MCP 는 HTTP POST 한 번에 JSON-RPC 요청 하나입니다. 그래서 노코드 도구의 HTTP 요청 노드만으로 부를 수 있습니다.
먼저 tools/list 로 도구 이름을 확인하고, 그 이름으로 tools/call 을 실행합니다.
n8n — HTTP Request 노드 설정
| 항목 | 값 |
|---|---|
| Method | POST |
| URL | https://api.xdata.kr/mcp |
| Authentication | Generic 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 |
요청 본문
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "<tools/list 에서 받은 이름>",
"arguments": {}
}
}Make — HTTP V4 "Make a request" 모듈 설정
| 항목 | 값 |
|---|---|
| 버전 기준 | HTTP 앱 오른쪽 위에서 V4를 선택합니다. 아래 설정은 V4 기준입니다. |
| URL | https://api.xdata.kr/mcp |
| Method | POST |
| Authentication type | Basic Auth |
| Credentials | XBOSS의 client_id·client_secret을 저장한 기존 키를 선택하거나, Add에서 Username에 client_id, Password에 client_secret을 입력하고 Create를 누릅니다. |
| Body content type | application/json |
| Body input method | JSON string |
| JSON 본문 입력 | JSON string을 고르면 나오는 입력 칸에 위 JSON 본문을 그대로 넣습니다. |
| Headers (데모 환경만) | X-MCP-Env-Scope: real_test |
tools/list 응답의 result.tools[*].name 이 tools/call 의 params.name 값입니다.이름은 XBOSS 작업의 점을 밑줄 두 개로 바꾼 형태입니다 — 예: hometax__session__login.
응답이 오래 걸리는 도구가 있으니 노드의 타임아웃을 120초 이상으로 둡니다.n8n 은 Options 의 Timeout 에 밀리초로 120000, Make 는 Timeout 에 초로 120 을 넣습니다.서버가 시간 초과로 답하기까지 도구 하나는 60초, 여러 기관을 한 번에 조회하는 팩 도구는 90초를 기다리기 때문입니다. 오류가 오면 MCP 오류 코드에서 코드를 찾습니다.