급여 보험료 조회 (MCP 도구 2종)

# 보험료 요약 호출(다른 도구는 name 과 arguments 만 바꿉니다)
# echo -n "<client_id>:<client_secret>" | base64
export MCP_URL="https://api.xdata.kr/mcp"
export MCP_AUTH_B64="<base64_결과_붙여넣기>"
curl -sS -X POST "$MCP_URL" \
  -H "Authorization: Basic $MCP_AUTH_B64" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "payroll_pack__premium_summary_v1__generate",
      "arguments": {
        "notice_year_month": "202608",
        "installment_round": 1,
        "idempotency_key": "payroll-premium-2026-08"
      }
    }
  }'

{
  "pack_run_id": "prun_01JC8YH8R0E1ABCDEFGHJKMN0P",
  "composite": true,
  "tool_name": "payroll_pack__premium_summary_v1__generate",
  "provider": "payroll_pack",
  "action": "payroll_pack.premium_summary_v1.generate",
  "idempotency_key": "payroll-premium-2026-08",
  "partial": false,
  "legs": [
    {
      "leg_index": 0,
      "provider": "nhis_edi",
      "action": "nhis_edi.hr_payroll.premium_notices.search",
      "label_ko": "건강보험 고지 검색",
      "status": "SUCCEEDED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN01",
      "result": {
        "...": "nhis_edi.hr_payroll.premium_notices.search 조회가 돌려주는 값입니다"
      },
      "artifacts": [],
      "error": null
    },
    {
      "leg_index": 1,
      "provider": "nps_edi",
      "action": "nps_edi.b1.pension_notices.search",
      "label_ko": "국민연금 고지 검색",
      "status": "SUCCEEDED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN02",
      "result": {
        "...": "nps_edi.b1.pension_notices.search 조회가 돌려주는 값입니다"
      },
      "artifacts": [],
      "error": null
    },
    {
      "leg_index": 2,
      "provider": "nhis_edi",
      "action": "nhis_edi.hr_payroll.health_premiums.summary",
      "label_ko": "건강보험료 요약",
      "status": "SUCCEEDED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN03",
      "result": {
        "...": "nhis_edi.hr_payroll.health_premiums.summary 조회가 돌려주는 값입니다"
      },
      "artifacts": [],
      "error": null
    },
    {
      "leg_index": 3,
      "provider": "nps_edi",
      "action": "nps_edi.b1.national_pension_premiums.summary",
      "label_ko": "국민연금보험료 요약",
      "status": "SUCCEEDED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN04",
      "result": {
        "...": "nps_edi.b1.national_pension_premiums.summary 조회가 돌려주는 값입니다"
      },
      "artifacts": [],
      "error": null
    }
  ],
  "succeeded_count": 4,
  "failed_count": 0,
  "computed": {
    "health_insurance_won": 1243500,
    "long_term_care_won": 163390,
    "national_pension_won": 1890000,
    "employment_insurance_won": null,
    "combined_insurance_premium_won": 3296890,
    "total_insurance_deduction_won": null,
    "completeness": "full_insurance_subset",
    "missing_fields": [
      "income_tax_won",
      "local_income_tax_won"
    ],
    "deduction_rows": [
      {
        "item": "건강보험",
        "amount_won": 1243500
      },
      {
        "item": "노인장기요양",
        "amount_won": 163390
      },
      {
        "item": "국민연금",
        "amount_won": 1890000
      },
      {
        "item": "건강보험·요양·연금 합계",
        "amount_won": 3296890
      }
    ]
  },
  "computed_error": null,
  "artifacts": []
}

{
  "partial": false,
  "succeeded_count": 2,
  "failed_count": 0,
  "computed": {
    "health_insurance_won": null,
    "long_term_care_won": null,
    "national_pension_won": null,
    "employment_insurance_won": 378000,
    "combined_insurance_premium_won": null,
    "total_insurance_deduction_won": null,
    "completeness": "employment_insurance_only",
    "missing_fields": [
      "income_tax_won",
      "local_income_tax_won"
    ],
    "deduction_rows": [
      {
        "item": "고용보험(실업급여)",
        "amount_won": 378000
      }
    ]
  }
}

{
  "pack_run_id": "prun_01JC8YH8R0E1ABCDEFGHJKMN0P",
  "composite": true,
  "tool_name": "payroll_pack__premium_summary_v1__generate",
  "provider": "payroll_pack",
  "action": "payroll_pack.premium_summary_v1.generate",
  "idempotency_key": "payroll-premium-2026-08",
  "partial": true,
  "legs": [
    {
      "leg_index": 0,
      "provider": "nhis_edi",
      "action": "nhis_edi.hr_payroll.premium_notices.search",
      "label_ko": "건강보험 고지 검색",
      "status": "SUCCEEDED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN01",
      "result": {
        "...": "nhis_edi.hr_payroll.premium_notices.search 조회가 돌려주는 값입니다"
      },
      "artifacts": [],
      "error": null
    },
    {
      "leg_index": 1,
      "provider": "nps_edi",
      "action": "nps_edi.b1.pension_notices.search",
      "label_ko": "국민연금 고지 검색",
      "status": "FAILED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN02",
      "result": null,
      "artifacts": null,
      "error": {
        "code": -32004,
        "message": "세션이 만료됐거나 없습니다(오류 AUTH_REQUIRED). 같은 account_link_id 로 'nps_edi__auth__npki_session__login' 을 먼저 불러 세션을 연 뒤 이 도구를 다시 부르세요.",
        "data": {
          "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN02",
          "error_code": "AUTH_REQUIRED",
          "next_action": "nps_edi__auth__npki_session__login",
          "safe_to_retry": true
        }
      }
    },
    {
      "leg_index": 2,
      "provider": "nhis_edi",
      "action": "nhis_edi.hr_payroll.health_premiums.summary",
      "label_ko": "건강보험료 요약",
      "status": "SUCCEEDED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN03",
      "result": {
        "...": "nhis_edi.hr_payroll.health_premiums.summary 조회가 돌려주는 값입니다"
      },
      "artifacts": [],
      "error": null
    },
    {
      "leg_index": 3,
      "provider": "nps_edi",
      "action": "nps_edi.b1.national_pension_premiums.summary",
      "label_ko": "국민연금보험료 요약",
      "status": "SKIPPED",
      "job_id": null,
      "result": null,
      "artifacts": null,
      "error": {
        "code": -32004,
        "message": "이 작업에 필요한 앞 단계 결과를 쓸 수 없습니다. 앞 단계 조회 결과를 확인한 뒤 다시 시도해 주세요.",
        "data": {
          "error_code": "COMPOSITE_DEPENDENCY_UNAVAILABLE",
          "leg_index": 3,
          "detail": "nps_edi nps_edi.b1.pension_notices.search did not produce a successful result"
        }
      }
    }
  ],
  "succeeded_count": 2,
  "failed_count": 2,
  "computed": null,
  "computed_error": {
    "reason": "dependency_missing",
    "message": "nps_edi nps_edi.b1.national_pension_premiums.summary did not produce a successful result"
  },
  "artifacts": []
}

{
  "pack_run_id": "prun_01JC8YH8R0E1ABCDEFGHJKMN0P",
  "composite": true,
  "tool_name": "payroll_pack__premium_summary_v1__generate",
  "provider": "payroll_pack",
  "action": "payroll_pack.premium_summary_v1.generate",
  "idempotency_key": "payroll-premium-2026-08",
  "partial": true,
  "legs": [
    {
      "leg_index": 0,
      "provider": "nhis_edi",
      "action": "nhis_edi.hr_payroll.premium_notices.search",
      "label_ko": "건강보험 고지 검색",
      "status": "SUCCEEDED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN01",
      "result": {
        "success": false,
        "row_count": 0,
        "options": [],
        "error_code": "PREMIUM_NOTICE_SEARCH_EMPTY",
        "implementation_status": "premium_notice_search_empty"
      },
      "artifacts": [],
      "error": null
    },
    {
      "leg_index": 1,
      "provider": "nps_edi",
      "action": "nps_edi.b1.pension_notices.search",
      "label_ko": "국민연금 고지 검색",
      "status": "SUCCEEDED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN02",
      "result": {
        "...": "nps_edi.b1.pension_notices.search 조회가 돌려주는 값입니다"
      },
      "artifacts": [],
      "error": null
    },
    {
      "leg_index": 2,
      "provider": "nhis_edi",
      "action": "nhis_edi.hr_payroll.health_premiums.summary",
      "label_ko": "건강보험료 요약",
      "status": "SKIPPED",
      "job_id": null,
      "result": null,
      "artifacts": null,
      "error": {
        "code": -32004,
        "message": "이 작업에 필요한 앞 단계 결과를 쓸 수 없습니다. 앞 단계 조회 결과를 확인한 뒤 다시 시도해 주세요.",
        "data": {
          "error_code": "COMPOSITE_DEPENDENCY_UNAVAILABLE",
          "leg_index": 2,
          "detail": "NHIS premium notice search returned no selectable options"
        }
      }
    },
    {
      "leg_index": 3,
      "provider": "nps_edi",
      "action": "nps_edi.b1.national_pension_premiums.summary",
      "label_ko": "국민연금보험료 요약",
      "status": "SUCCEEDED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN04",
      "result": {
        "...": "nps_edi.b1.national_pension_premiums.summary 조회가 돌려주는 값입니다"
      },
      "artifacts": [],
      "error": null
    }
  ],
  "succeeded_count": 3,
  "failed_count": 1,
  "computed": null,
  "computed_error": {
    "reason": "dependency_missing",
    "message": "nhis_edi nhis_edi.hr_payroll.health_premiums.summary did not produce a successful result"
  },
  "artifacts": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "국민건강보험공단 EDI 연동 계정이 없습니다. https://console.xdata.kr/credentials?link=1&priority=nhis_edi 에서 인증서를 연결한 뒤 이 도구를 다시 호출하세요. 연결은 호출할 때마다 새로 확인하므로 따로 다시 시작할 필요가 없습니다.",
    "data": {
      "composite": true,
      "tool_name": "payroll_pack__premium_summary_v1__generate",
      "idempotency_key": "payroll-premium-2026-08",
      "legs": [
        {
          "leg_index": 0,
          "provider": "nhis_edi",
          "action": "nhis_edi.hr_payroll.premium_notices.search",
          "label_ko": "건강보험 고지 검색",
          "status": "FAILED",
          "job_id": null,
          "result": null,
          "artifacts": null,
          "error": {
            "code": -32602,
            "message": "국민건강보험공단 EDI 연동 계정이 없습니다. https://console.xdata.kr/credentials?link=1&priority=nhis_edi 에서 인증서를 연결한 뒤 이 도구를 다시 호출하세요. 연결은 호출할 때마다 새로 확인하므로 따로 다시 시작할 필요가 없습니다.",
            "data": {
              "error_code": "PRIMARY_ACCOUNT_LINK_NOT_FOUND",
              "link_url": "https://console.xdata.kr/credentials?link=1&priority=nhis_edi"
            }
          }
        },
        {
          "leg_index": 1,
          "provider": "nps_edi",
          "action": "nps_edi.b1.pension_notices.search",
          "label_ko": "국민연금 고지 검색",
          "status": "FAILED",
          "job_id": null,
          "result": null,
          "artifacts": null,
          "error": {
            "code": -32602,
            "message": "국민연금공단 EDI 연동 계정이 없습니다. https://console.xdata.kr/credentials?link=1&priority=nps_edi 에서 인증서를 연결한 뒤 이 도구를 다시 호출하세요. 연결은 호출할 때마다 새로 확인하므로 따로 다시 시작할 필요가 없습니다.",
            "data": {
              "error_code": "PRIMARY_ACCOUNT_LINK_NOT_FOUND",
              "link_url": "https://console.xdata.kr/credentials?link=1&priority=nps_edi"
            }
          }
        },
        {
          "leg_index": 2,
          "provider": "nhis_edi",
          "action": "nhis_edi.hr_payroll.health_premiums.summary",
          "label_ko": "건강보험료 요약",
          "status": "SKIPPED",
          "job_id": null,
          "result": null,
          "artifacts": null,
          "error": {
            "code": -32004,
            "message": "이 작업에 필요한 앞 단계 결과를 쓸 수 없습니다. 앞 단계 조회 결과를 확인한 뒤 다시 시도해 주세요.",
            "data": {
              "error_code": "COMPOSITE_DEPENDENCY_UNAVAILABLE",
              "leg_index": 2,
              "detail": "nhis_edi nhis_edi.hr_payroll.premium_notices.search did not produce a successful result"
            }
          }
        },
        {
          "leg_index": 3,
          "provider": "nps_edi",
          "action": "nps_edi.b1.national_pension_premiums.summary",
          "label_ko": "국민연금보험료 요약",
          "status": "SKIPPED",
          "job_id": null,
          "result": null,
          "artifacts": null,
          "error": {
            "code": -32004,
            "message": "이 작업에 필요한 앞 단계 결과를 쓸 수 없습니다. 앞 단계 조회 결과를 확인한 뒤 다시 시도해 주세요.",
            "data": {
              "error_code": "COMPOSITE_DEPENDENCY_UNAVAILABLE",
              "leg_index": 3,
              "detail": "nps_edi nps_edi.b1.pension_notices.search did not produce a successful result"
            }
          }
        }
      ]
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "세션이 만료됐거나 없습니다(오류 AUTH_REQUIRED). 같은 account_link_id 로 'nhis_edi__session__login' 을 먼저 불러 세션을 연 뒤 이 도구를 다시 부르세요."
      },
      {
        "type": "text",
        "text": "(아래 JSON 을 문자열로 담은 값)"
      }
    ],
    "isError": true
  }
}

{
  "composite": true,
  "tool_name": "payroll_pack__premium_summary_v1__generate",
  "idempotency_key": "payroll-premium-2026-08",
  "legs": [
    {
      "leg_index": 0,
      "provider": "nhis_edi",
      "action": "nhis_edi.hr_payroll.premium_notices.search",
      "label_ko": "건강보험 고지 검색",
      "status": "FAILED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN01",
      "result": null,
      "artifacts": null,
      "error": {
        "code": -32004,
        "message": "세션이 만료됐거나 없습니다(오류 AUTH_REQUIRED). 같은 account_link_id 로 'nhis_edi__session__login' 을 먼저 불러 세션을 연 뒤 이 도구를 다시 부르세요.",
        "data": {
          "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN01",
          "error_code": "AUTH_REQUIRED",
          "next_action": "nhis_edi__session__login",
          "safe_to_retry": true
        }
      }
    },
    {
      "leg_index": 1,
      "provider": "nps_edi",
      "action": "nps_edi.b1.pension_notices.search",
      "label_ko": "국민연금 고지 검색",
      "status": "FAILED",
      "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN02",
      "result": null,
      "artifacts": null,
      "error": {
        "code": -32004,
        "message": "세션이 만료됐거나 없습니다(오류 AUTH_REQUIRED). 같은 account_link_id 로 'nps_edi__auth__npki_session__login' 을 먼저 불러 세션을 연 뒤 이 도구를 다시 부르세요.",
        "data": {
          "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN02",
          "error_code": "AUTH_REQUIRED",
          "next_action": "nps_edi__auth__npki_session__login",
          "safe_to_retry": true
        }
      }
    },
    {
      "leg_index": 2,
      "provider": "nhis_edi",
      "action": "nhis_edi.hr_payroll.health_premiums.summary",
      "label_ko": "건강보험료 요약",
      "status": "SKIPPED",
      "job_id": null,
      "result": null,
      "artifacts": null,
      "error": {
        "code": -32004,
        "message": "이 작업에 필요한 앞 단계 결과를 쓸 수 없습니다. 앞 단계 조회 결과를 확인한 뒤 다시 시도해 주세요.",
        "data": {
          "error_code": "COMPOSITE_DEPENDENCY_UNAVAILABLE",
          "leg_index": 2,
          "detail": "nhis_edi nhis_edi.hr_payroll.premium_notices.search did not produce a successful result"
        }
      }
    },
    {
      "leg_index": 3,
      "provider": "nps_edi",
      "action": "nps_edi.b1.national_pension_premiums.summary",
      "label_ko": "국민연금보험료 요약",
      "status": "SKIPPED",
      "job_id": null,
      "result": null,
      "artifacts": null,
      "error": {
        "code": -32004,
        "message": "이 작업에 필요한 앞 단계 결과를 쓸 수 없습니다. 앞 단계 조회 결과를 확인한 뒤 다시 시도해 주세요.",
        "data": {
          "error_code": "COMPOSITE_DEPENDENCY_UNAVAILABLE",
          "leg_index": 3,
          "detail": "nps_edi nps_edi.b1.pension_notices.search did not produce a successful result"
        }
      }
    }
  ]
}

{
  "code": -32003,
  "message": "요청이 60초 안에 끝나지 않았습니다(작업 번호 job_01JC8YH8R0E1ABCDEFGHJKMN01). 서버가 바쁠 수 있습니다. 결과는 xdata__job__result 도구에 이 job_id 를 넣어 읽을 수 있습니다(작업을 다시 돌리지 않고 사용 토큰도 쓰지 않습니다). 같은 API 키로 연동한 서비스는 GET https://api.xdata.kr/v1/jobs/job_01JC8YH8R0E1ABCDEFGHJKMN01 로도 읽을 수 있습니다. 잠시 뒤 다시 시도하거나, 요청 범위를 줄일 수 있으면 줄이세요.",
  "data": {
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN01",
    "timeout_seconds": 60,
    "safe_to_retry": true,
    "status_url": "https://api.xdata.kr/v1/jobs/job_01JC8YH8R0E1ABCDEFGHJKMN01",
    "result_tool_call": {
      "name": "xdata__job__result",
      "arguments": {
        "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMN01"
      }
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "같은 idempotency_key 로 내용이 다른 요청이 이미 들어왔습니다. 같은 요청을 다시 보내는 것이면 처음 보낸 인자 그대로 보내고, 새 요청이면 idempotency_key 를 새 값으로 바꾸거나 아예 넣지 마세요(넣지 않으면 서버가 만듭니다).",
    "data": {
      "error_code": "IDEMPOTENCY_KEY_CONFLICT",
      "safe_to_retry": false
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "같은 idempotency_key 로 내용이 다른 요청이 이미 들어왔습니다. 같은 요청을 다시 보내는 것이면 처음 보낸 인자 그대로 보내고, 새 요청이면 idempotency_key 를 새 값으로 바꾸거나 아예 넣지 마세요(넣지 않으면 서버가 만듭니다).",
    "data": {
      "composite": true,
      "tool_name": "payroll_pack__premium_summary_v1__generate",
      "idempotency_key": "payroll-premium-2026-08",
      "legs": [
        {
          "leg_index": 0,
          "provider": "nhis_edi",
          "action": "nhis_edi.hr_payroll.premium_notices.search",
          "label_ko": "건강보험 고지 검색",
          "status": "FAILED",
          "job_id": null,
          "result": null,
          "artifacts": null,
          "error": {
            "code": -32602,
            "message": "같은 idempotency_key 로 내용이 다른 요청이 이미 들어왔습니다. 같은 요청을 다시 보내는 것이면 처음 보낸 인자 그대로 보내고, 새 요청이면 idempotency_key 를 새 값으로 바꾸거나 아예 넣지 마세요(넣지 않으면 서버가 만듭니다).",
            "data": {
              "error_code": "IDEMPOTENCY_KEY_CONFLICT",
              "safe_to_retry": false
            }
          }
        },
        {
          "leg_index": 1,
          "provider": "nps_edi",
          "action": "nps_edi.b1.pension_notices.search",
          "label_ko": "국민연금 고지 검색",
          "status": "FAILED",
          "job_id": null,
          "result": null,
          "artifacts": null,
          "error": {
            "code": -32602,
            "message": "같은 idempotency_key 로 내용이 다른 요청이 이미 들어왔습니다. 같은 요청을 다시 보내는 것이면 처음 보낸 인자 그대로 보내고, 새 요청이면 idempotency_key 를 새 값으로 바꾸거나 아예 넣지 마세요(넣지 않으면 서버가 만듭니다).",
            "data": {
              "error_code": "IDEMPOTENCY_KEY_CONFLICT",
              "safe_to_retry": false
            }
          }
        },
        {
          "leg_index": 2,
          "provider": "nhis_edi",
          "action": "nhis_edi.hr_payroll.health_premiums.summary",
          "label_ko": "건강보험료 요약",
          "status": "SKIPPED",
          "job_id": null,
          "result": null,
          "artifacts": null,
          "error": {
            "code": -32004,
            "message": "이 작업에 필요한 앞 단계 결과를 쓸 수 없습니다. 앞 단계 조회 결과를 확인한 뒤 다시 시도해 주세요.",
            "data": {
              "error_code": "COMPOSITE_DEPENDENCY_UNAVAILABLE",
              "leg_index": 2,
              "detail": "nhis_edi nhis_edi.hr_payroll.premium_notices.search did not produce a successful result"
            }
          }
        },
        {
          "leg_index": 3,
          "provider": "nps_edi",
          "action": "nps_edi.b1.national_pension_premiums.summary",
          "label_ko": "국민연금보험료 요약",
          "status": "SKIPPED",
          "job_id": null,
          "result": null,
          "artifacts": null,
          "error": {
            "code": -32004,
            "message": "이 작업에 필요한 앞 단계 결과를 쓸 수 없습니다. 앞 단계 조회 결과를 확인한 뒤 다시 시도해 주세요.",
            "data": {
              "error_code": "COMPOSITE_DEPENDENCY_UNAVAILABLE",
              "leg_index": 3,
              "detail": "nps_edi nps_edi.b1.pension_notices.search did not produce a successful result"
            }
          }
        }
      ]
    }
  }
}