노코드 자동화 연동
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 |
요청 본문
json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}json
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "<tools/list 에서 받은 이름>",
"arguments": {}
}
}Make — HTTP "Make a request" 모듈 설정
| 항목 | 값 |
|---|---|
| URL | https://api.xdata.kr/mcp |
| Method | POST |
| Authentication type | Basic auth — 사용자 이름에 client_id, 비밀번호에 client_secret |
| Body content type | application/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 오류 코드에서 코드를 찾습니다.