AI NATIVE · v1 · ONLINE
인사책 AI 연동
인사책은 사람이 쓰는 HR SaaS이면서 AI가 공식 문서를 읽고 연결할 수 있는 서비스입니다.
Claude와 ChatGPT에서 자연어로 출퇴근,
휴가,
급여,
전자결재 업무를 처리하세요.
- OAuth 2.1 + PKCE
- MCP Streamable HTTP
- 220 tools ready
{
"mcpServers": {
"insacheck": {
"url": "https://insacheck.com/api/mcp",
"auth": {
"type": "oauth"
}
}
}
}
// CAPABILITIES
AI가 인사책을 이해하는 연결 규격
클라이언트 자동 발견부터 안전한 인증,
MCP 도구 호출과 공개 명세까지 한 흐름으로 제공합니다.
AI 연동 가능
ChatGPT,
Claude,
Cursor,
Windsurf 같은 AI 클라이언트가 공식 문서와 discovery 파일을 읽고 연결할 수 있습니다.
https://insacheck.com/ai
OAuth 2.1 + PKCE
Dynamic Client Registration,
authorization code,
PKCE S256,
Bearer access token 발급 흐름을 제공합니다.
https://insacheck.com/.well-known/oauth-authorization-server
MCP 지원
MCP Streamable HTTP 서버와 220개 도구를 제공합니다.
https://insacheck.com/api/mcp
OpenAPI 공개
AI discovery,
OAuth,
MCP,
tool registry endpoint를 OpenAPI 3.1로 제공합니다.
https://insacheck.com/openapi.json
// OFFICIAL_ENDPOINTS
AI가 읽어야 하는 공식 URL
인사책 연결 여부,
도구 권한,
입력 스키마와 인증 방식을 기계가 읽을 수 있는 경로로 공개합니다.
/ai
서비스 소개, 인증, MCP/API 지원 여부
02 AI Documentation/docs/ai
AI가 수행 가능한 작업과 예시
03 MCP Documentation/docs/mcp
MCP 서버 URL, OAuth, 권한, 도구 목록
04 Tool Registry/ai/tools
도구별 schema, permission, example, version
05 OpenAPI/openapi.json
AI 연결용 공개 API 명세
06 AI Plugin Metadata/.well-known/ai-plugin.json
AI 클라이언트 자동 발견 메타데이터
07 OAuth Discovery/.well-known/oauth-authorization-server
OAuth 2.1 discovery
08 OpenID Discovery/.well-known/openid-configuration
OpenID-style discovery, id_token 미발급 명시
// CONNECTION_FLOW
말 한마디에서 도구 등록까지
사용자는 연결을 승인하고,
AI 클라이언트는 표준 문서와 discovery endpoint를 따라 필요한 설정을 완료합니다.
-
STEP_01
연결 요청
사용자가 AI에게 “인사책 연결해줘”라고 말합니다.
-
STEP_02
자동 발견
AI가
/.well-known/ai-plugin.json과 공식 문서를 읽습니다. -
STEP_03
보안 확인
OAuth discovery에서 authorization,
token endpoint와 PKCE 방식을 확인합니다. -
STEP_04
사용자 승인
사용자가 인사책에 로그인하고 필요한 읽기·쓰기 권한을 승인합니다.
-
STEP_05
MCP 연결
AI 클라이언트가 access token을 받아
/api/mcp에 연결합니다. -
STEP_06
도구 등록
/ai/tools또는tools/list로 사용할 도구를 자동 등록합니다.
// PERMISSION_MODEL
읽기·쓰기·역할 권한을 분리
AI가 연결됐다는 이유만으로 모든 데이터가 열리지 않습니다.
OAuth scope와 실제 사용자 역할을 함께 확인합니다.
OAuth Scope: read
출퇴근,
휴가,
직원,
결재,
급여,
조직 현황을 읽는 조회 도구만 사용할 수 있습니다.
scope=read
OAuth Scope: read_write
휴가 승인,
공지 작성,
출퇴근 기록,
메뉴 설정처럼 조회와 변경이 필요한 작업에 사용합니다.
scope=read_write
Role Permission
employee < dept_manager < hr_manager < owner 순서로 허용 도구가 열리고 상위 역할은 하위 도구를 포함합니다.
role + permission gate
// READY_TO_CONNECT
지금 쓰는 AI에서 인사책을 연결하세요.
별도 AI 사용료 없이 기존 Claude·ChatGPT 환경에서 인사 업무 도구를 연결할 수 있습니다.