근태 데이터를 구글시트나 ERP로 가져가려면 인사책에서 무엇이 되나요?

인사책에서 근태 데이터를 꺼내는 길 가운데 이 글은 두 가지를 다룹니다.
하나는 관리자 화면의 근로시간 대장 CSV 이고,
다른 하나는 AI 연동 규격(MCP)의 근태 CSV 내보내기 도구입니다.
구글시트는 인사책을 원본으로 두고 시트로 보내는 일방향 안내형이며,
ERP 가 매일 직접 호출하는 범용 REST 근태 API 와 ADT 출입기록 수신,
구내식당 식수 연동은 인사책에 없습니다.

이 글은 2026-10-21 에 인사책 공개 페이지와 서비스 소스 코드를 대조해 정리했습니다.
인사책은 인원 제한 없는 무료 플랜 · 모든 기능으로 제공합니다.
무료 플랜은 과거 기록 조회 기간·내보내기·AI 연결(MCP) 호출 등 일부 사용량에서 유료 플랜과 차이가 있을 수 있어요.
아래 내용은 그 안에서 근태 데이터를 어디까지 밖으로 꺼낼 수 있는지만 다룹니다.
직접 호출 시험을 거치지 않은 항목은 시험하지 않았다고 표시했습니다.

한눈에 보는 답

받는 쪽이 사람이 여는 시트인지,
프로그램이 매일 호출하는 ERP 인지에 따라 답이 갈립니다.
아래 표는 상황마다 인사책에서 되는 것과 그 전에 확인할 것을 나란히 둡니다.

먼저 확인할 질문 6가지

연동 방식을 정하기 전에 아래 여섯 가지를 먼저 적어 두면 인사책이 맞는지가 바로 갈립니다.

1. 받는 쪽이 사람이 여는 시트인가요,
   프로그램이 매일 호출하는 ERP 인가요? 사람이 여는 시트와 엑셀이면 근로시간 대장 CSV 로 충분한 경우가 많습니다.
   프로그램이 호출해야 한다면 ERP 쪽에서 MCP 를 구현할 수 있는지부터 확인합니다.
2. 한 방향이면 되나요,
   받은 쪽에서 고친 값이 인사책으로 되돌아와야 하나요? 인사책은 시트나 CSV 에서 고친 값을 원본으로 되돌리지 않습니다.
   되돌림이 필수라면 인사책은 맞지 않습니다.
3. 근태의 원천이 인사책 앱·웹 출퇴근 기록인가요,
   이미 쓰는 출입통제나 식당 단말의 기록인가요? 후자를 인사책으로 가져오는 기능은 없습니다.
   인사책의 근태 원천은 인사책에서 남긴 출퇴근 기록입니다(직원이 누른 기록 외에 승인된 정정과 수기 추가,
   자동 마감 기록이 섞일 수 있습니다).
4. 언제까지 반영되면 되나요? 월말이나 하루 단위 대사라면 요청할 때마다 그 시점의 저장값을 받는 방식으로 충분합니다.
   변경이 생기는 즉시 외부로 알려 주는 웹훅은 공개 문서에 없으므로,
   실시간 반영이 필수라면 인사책은 맞지 않습니다.
5. 대사에 쓸 열이 이름·부서·날짜·시각·근로시간으로 충분한가요? 두 CSV 에는 사번이나 기록 ID 열이 없습니다.
   동명이인이 있으면 부서까지 묶어서 대사해야 합니다.
6. 정정이나 마감 뒤에 값이 바뀌면 누가 다시 받나요? 직원 본인이 신청하는 정정은 최근 30일 안의 기록만 가능하고 급여가 확정된 달은 정정할 수 없습니다(소스 코드 확인).
   받는 쪽에서 같은 달을 다시 받는 시점을 정해 두면 정정이 누락되지 않습니다.

계산해 보기: 한 달 치를 받은 뒤 줄 수와 시간 맞추기

아래는 가상의 예입니다.
직원 12명인 가상의 회사가 2026년 10월에 평일 22일을 모두 출근했고,
하루 근로시간이 모두 8.0시간이라고 가정합니다.

줄 수만 맞추면 정정이 잡히지 않습니다.
정정은 기본적으로 이미 있는 기록의 시각을 바꾸기 때문입니다(회사에 따라 방식이 다르며,
4단계에서 설명합니다).
다만 못 찍은 날을 승인으로 채우는 수기 추가 기록은 줄을 늘릴 수 있습니다.
그래서 줄 수와 근로시간(h) 합계를 함께 맞추고,
비고에서 「정정」이 찍힌 줄 수를 세어 정정이 승인된 날 수와 비교합니다.
같은 날 정정이 여러 건이어도 그 줄의 비고에는 「정정」이 한 번만 찍힙니다.

시간대는 두 파일이 다릅니다.
근로시간 대장 CSV 의 출근·퇴근 칸은 한국 시간으로 바꾼 HH:MM 입니다.
MCP 근태 CSV 의 시각 칸은 저장된 시각을 앞 16자만 잘라 시간대 표시 없이 내보냅니다.
인사책은 시각을 UTC 로 저장하므로,
이 칸은 한국 시간보다 9시간 이릅니다.

시간대 차이의 가상의 예입니다.
직원이 한국 시간 2026-10-01 08:30 에 출근하면 저장 시각은 2026-09-30 23:30 입니다.
MCP 의 월 범위는 한국 날짜 기준이라 이 줄은 month=2026-10 응답에 들어가지만,
시각 칸에는 2026-09-30 23:30 이 적힙니다.
받는 쪽에서 날짜만 잘라 월별로 다시 나누면 이 줄이 9월로 가므로,
시각에 9시간을 더한 뒤 날짜를 정해야 합니다.
이 동작은 서비스 소스 코드 기준이며 운영 서버에서 직접 호출해 확인한 결과는 아닙니다.

인사책에서 근태 데이터를 꺼내는 법

관리자가 직접 하는 일과 개발자가 프로그램으로 하는 일을 나눠 적었습니다.
근로시간 대장이 어떤 서식으로 나오는지는 출근부 양식,
한 건마다 남는 값은 근태기록어플이 남기는 값에 있습니다.

1단계: 근로시간 대장 CSV 를 내려받습니다

관리자 화면에서 근로시간 대장을 열고 대상월을 고른 뒤 「근로시간 대장 CSV」 링크를 누릅니다.
파일 이름은 근로시간대장_2026-10.csv 와 같은 꼴입니다.
글자 인코딩은 UTF-8 이고 파일 앞에 BOM 표식이 붙어 엑셀에서 한글이 깨지지 않도록 했습니다.
데이터 줄의 모든 칸은 큰따옴표로 감싸고(머리글 줄은 감싸지 않습니다) 줄바꿈은 CRLF 입니다.
서버는 요청할 때마다 파일을 새로 만들고,
중간 서버가 보관하지 않도록 Cache-Control: no-store 로 내려줍니다.
내려받을 때마다 임금 감사 로그에 출력 기록이 한 줄 남습니다.

2단계: 열 사전을 보고 시트 열에 맞춥니다

근로시간 대장 CSV 는 아래 9개 열로 나옵니다.
사람·날짜마다 한 줄이며,
출근과 퇴근이 모두 없는 날은 줄 자체가 없습니다.

출근이나 퇴근 중 하나만 있는 날은 없는 쪽만 빈 칸이 됩니다.
이름과 근무 시각이 들어 있으므로 열람 권한이 있는 사람에게만 파일을 공유하세요.
위치 좌표와 정확도,
기기 정보는 이 열 목록에 없습니다.
개인정보 처리 기준은 개인정보처리방침에 있습니다.
시트 쪽 열 구성은 근태관리엑셀 시트 칸에 정리해 두었습니다.

3단계: 프로그램이 월 단위로 요청합니다

ERP 나 스크립트가 직접 가져가야 한다면 MCP 서버를 호출합니다.
서버 주소는 https://insacheck.com/api/mcp 이고,
규격은 JSON-RPC 2.0 over HTTP 입니다.
인증은 OAuth 2.1(authorization_code,
PKCE S256,
동적 클라이언트 등록)이나 /worker/mcp 에서 발급하는 PAT 를 Authorization: Bearer 헤더로 붙입니다.
조회만 한다면 scope=read 로 충분합니다.
OAuth 액세스 토큰은 30일,
리프레시 토큰은 90일 뒤 만료되고,
/worker/mcp 에서 새로 발급하는 PAT 는 발급 뒤 90일이 지나면 만료됩니다.
호출 한도와 오류 코드의 최신 표는 AI 비서 연동 시작하기에 있습니다.

근태 CSV 를 받는 요청은 아래와 같습니다.
인자는 month 하나뿐이며 YYYY-MM 으로 씁니다.

POST https://insacheck.com/api/mcp
Authorization: Bearer <토큰>
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"export_attendance_csv","arguments":{"month":"2026-10"}}}

응답의 result.content[0].text 안에 JSON 문자열이 들어오고,
그 안에 month,
row_count,
filename,
csv,
message 다섯 칸이 있습니다.
csv 칸이 파일 내용 전체이며 파일 이름은 근태_2026-10.csv 로 안내됩니다.
MCP 근태 CSV 의 열은 아래 4개입니다.

아래는 소스 코드와 공개 문서를 대조해 정리한 동작이며,
운영 서버에 직접 호출해 시험한 결과가 아닙니다.

이 도구의 인자는 month 하나뿐이라 한 번에 받는 줄 수를 나누는 인자,
이어받기 값,
변경분만 받는 인자가 없습니다.
그래서 누락을 복구하는 방법은 같은 달을 다시 받아 전체를 대사하는 것입니다.
하루 단위로 보려면 query_attendance_today 에 date(YYYY-MM-DD)를 넣어 호출합니다.
자세한 도구 목록과 권한은 MCP 연동 문서에 있습니다.

4단계: 정정이 있으면 같은 달을 다시 받아 덮어씁니다

인사책 공개 안내에 따르면 잘못 찍힌 기록은 지우지 않고 정정으로 고치며,
고친 뒤에도 정정 직전의 원본 시각과 정정 원장이 함께 남습니다.
요청할 때마다 그 달 전체를 새로 받으므로 받는 쪽에서 삭제 이벤트를 따로 처리할 필요는 없고,
정정된 줄의 시각만 달라집니다.
이 설명은 정정이 기존 기록의 시각을 바꾸고 원본 시각을 따로 남기는 방식 기준입니다.
회사에 따라서는 정정된 시각의 새 기록을 덧붙이고 원본에 표시를 남기는 방식으로 처리됩니다(서비스 소스 기준 · 어느 방식인지는 회사마다 다릅니다).
이때 두 CSV 가 원본 줄을 빼고 내보내는지는 확인하지 못했습니다.
정정 전 시각 열은 두 CSV 어디에도 없습니다.
출근부 서식의 비고 칸에는 「정정」 두 글자만 찍히므로,
정정 전후 시각과 사유,
승인자는 인사책의 정정 원장과 해당 기록에서 확인합니다.
기록의 기본 보존 기간은 5년이고 기준은 기록이 발생한 시각입니다.

직원 본인 신청 정정은 최근 30일 안의 기록만 가능하고(오늘 기록은 제외),
급여 명세서가 확정된 달은 정정할 수 없습니다.
관리자가 직원 대신 올리는 정정도 같은 30일 창과 급여 확정 잠금을 쓰는 것을 소스 코드에서 확인했습니다.
다만 그 밖의 관리자 화면 경로는 이 글에서 확인하지 못했습니다.
그래서 마감한 달도 대사할 때는 같은 달을 다시 받아 줄 수와 근로시간 합계를 비교하는 편이 안전합니다.

구글시트로 자동 전달이 필요할 때

구글 시트 연동 페이지는 인사책에 쌓인 출퇴근 기록을 시트로 보내는 일방향 연동을 안내합니다.
시트에서 고친 값은 인사책으로 돌아가지 않고,
시트 안의 합계와 서식은 구글 시트의 기능이라 인사책이 관여하지 않습니다.
서비스 소스 코드에서는 구글 시트 API 를 직접 호출하는 연동 코드를 찾지 못했고,
기존 시트 양식의 열에 맞춰 채워 주는 매핑 기능도 확인되지 않았습니다.
그래서 열 맞춤은 시트 쪽에서 하는 것으로 보고,
문의할 때 실제 전달 방식을 확인하세요.
연동은 문의하기에서 시작하며,
문의할 때 아래 다섯 가지를 문서로 받아 두면 나중에 다툴 일이 줄어듭니다.

• 시트로 보내는 열의 이름과 순서
• 갱신 주기와 마지막 갱신 시각을 확인하는 곳
• 전송이 실패했을 때 누가 알아차리고 누가 다시 보내는지
• 정정이 승인된 뒤 시트의 값이 언제 바뀌는지
• 시트를 열 수 있는 사람의 범위

인사책이 맞지 않는 경우

아래 중 하나가 필수 조건이면 인사책은 맞지 않습니다.
이 경우에는 다음 장의 서비스를 먼저 확인하세요.

• ERP 가 범용 REST API 로 근태를 직접 호출해야 하고,
  MCP 클라이언트를 만들 수 없는 경우입니다.
• 근태가 바뀌는 즉시 외부 주소로 알려 주는 웹훅이나 변경분 수신이 필수인 경우입니다.
  공개 문서에는 이런 기능이 없습니다.
• ADT 같은 출입통제 시스템의 기록을 근태로 자동으로 가져와야 하는 경우입니다.
• 구내식당 단말의 식수를 직원별로 묶어야 하는 경우입니다.
  인사책에는 식당 단말의 식수를 받아 직원별로 집계하는 기능이 없습니다.
• 시트나 ERP 에서 고친 값이 인사책 원본에 반영되어야 하는 경우입니다.
• 기존 구글시트 양식의 열에 인사책이 맞춰 채워 주길 기대하는 경우입니다.
• 사번이나 기록 ID 로 한 건씩 대사해야 하는 경우입니다.
  두 CSV 에는 그 열이 없습니다.
• .xlsx 파일 자체를 내려받아야 하는 경우입니다.
  근태 내보내기는 CSV 와 A4 인쇄본입니다.

반대로 월말에 정해진 CSV 나 시트로 근태만 받으면 되는 경우에는 인사책을 후보에 둘 수 있습니다.
출입이나 식수 집계를 기존 시스템에 그대로 두고,
근태만 인사책에서 받아 월말에 합치는 구성도 가능합니다.
이때 두 파일의 시간대와 사람 식별 열이 다르므로 합치기 전에 열 사전을 맞춰야 합니다.

다른 서비스와 비교할 때

아래 표는 각 서비스의 공식 공개 자료에서 확인한 내용을 2026-10-21 기준으로 옮긴 것이며,
날짜를 따로 적은 칸은 그날 다시 확인했습니다.
순위가 아니며,
「공개 자료로 확인 못함」은 지원하지 않는다는 뜻이 아닙니다.
실제 지원 여부는 설치 모델과 계약에 따라 달라지므로 견적 전에 각 서비스에 확인하세요.

조건별로 정리하면 다음과 같습니다.

• 기존 출입 기록을 근태로 자동 반입하는 것이 필수이면 시프티,
  flex,
  ADT캡스의 연동 대상 모델과 계약 범위를 먼저 견적받는 것이 맞습니다.
• ERP 가 프로그램으로 직접 가져가야 하면 시프티,
  flex,
  뉴플로이,
  타임키퍼의 API·연동 안내를 명세 단위로 확인한 뒤 비교합니다.
  인사책은 MCP 호출을 구현할 수 있을 때 후보가 됩니다.
• 식수 통계까지 같은 제품군에서 보려면 ADT캡스를 먼저 확인하고,
  직원별 매핑과 중복 규칙을 시연으로 확인합니다.
• 정해진 CSV 나 시트만 있으면 되고 출입·식수는 기존 시스템에 두는 경우에는 인사책을 다시 비교 대상에 넣을 수 있습니다.

요금은 서비스마다 구성이 달라 비교하지 않았습니다.
시프티의 공개 요금표는 Enterprise,
PC-OFF,
API 등을 별도로 표기하고,
타임키퍼는 구축형을 별도 견적으로 안내합니다(AT-S11,
AT-S21).
부가세 포함 여부,
최소 이용 인원,
계약 기간은 견적에서 직접 확인해야 합니다.

근거와 확인일

이 글의 인사책 기능 설명은 2026-10-21 기준 인사책 소스 코드입니다.
관련 페이지는 구글 시트 연동, 근태기록어플이 남기는 값, 근태 정정, 출근부 양식, 근태관리엑셀 시트 칸, MCP 연동 문서, AI 비서 연동 시작하기, 개인정보처리방침입니다.
근로시간 대장 CSV 의 열과 시간대는 근로시간 대장 출력 라우트의 소스(enterprise-attendance-export.ts)를,
MCP 근태 CSV 는 export 도구의 소스(mcp-tools/export.ts)를 읽고 정리했습니다.

경쟁사 공개 자료는 2026-10-21 에 확인했고,
날짜를 따로 적은 칸은 그날 다시 확인했습니다.
요금 표기는 실제 견적과 다를 수 있습니다.

• 시프티(AT-S16,
  AT-S11): https://shiftee.io/ko/integration · https://shiftee.io/ko/pricing
• flex(AT-S17): https://flex.team/landing/service/time-tracking
• 뉴플로이(AT-S19): https://www.newploy.net/
• 타임키퍼(AT-S21,
  AT-S22,
  AT-S23): https://time-keeper.kr/price/ · https://time-keeper.kr/faq/ · https://time-keeper.kr/on-premise/
• ADT캡스(AT-S28): https://www.adtcaps.co.kr/security-services/access-control?tab=attendance-system

이 글은 공개 문서를 읽고 정리한 것이며 서비스의 순위를 매기지 않았습니다.
각 서비스의 실제 성능과 현재 계약 조건,
샘플 요청의 실행 결과는 확인하지 못했습니다.
고쳐야 할 내용이 있으면 문의하기로 알려 주세요.
회사 등록은 회사 무료 등록에서 시작합니다.