AI Native · v1
AI Integration
인사책은 사람이 쓰는 HR SaaS이면서 AI가 공식 문서를 읽고 연결할 수 있는 서비스입니다.
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 서버와 226개 도구를 제공합니다.
https://insacheck.com/api/mcp
OpenAPI 공개
AI discovery, OAuth, MCP, tool registry endpoint를 OpenAPI 3.1로 제공합니다.
https://insacheck.com/openapi.json
AI Client 설정 예시
{
"mcpServers": {
"insacheck": {
"url": "https://insacheck.com/api/mcp",
"auth": {
"type": "oauth"
}
}
}
}
AI가 읽어야 하는 공식 URL
| AI Integration Page | /ai | 서비스 소개, 인증, MCP/API 지원 여부 |
| AI Documentation | /docs/ai | AI가 수행 가능한 작업과 예시 |
| MCP Documentation | /docs/mcp | MCP 서버 URL, OAuth, 권한, 도구 목록 |
| Tool Registry | /ai/tools | 도구별 schema, permission, example, version |
| OpenAPI | /openapi.json | AI 연결용 공개 API 명세 |
| AI Plugin Metadata | /.well-known/ai-plugin.json | AI 클라이언트 자동 발견 메타데이터 |
| OAuth Discovery | /.well-known/oauth-authorization-server | OAuth 2.1 discovery |
| OpenID Discovery | /.well-known/openid-configuration | OpenID-style discovery, id_token 미발급 명시 |
연동 사용자 경험
- 사용자가 AI에게 "인사책 연결해줘"라고 말합니다.
- AI가 /.well-known/ai-plugin.json, /ai, /docs/ai를 읽습니다.
- AI가 OAuth discovery에서 authorization/token endpoint와 PKCE 방식을 확인합니다.
- 사용자가 인사책에 로그인하고 권한을 승인합니다.
- AI 클라이언트가 access token을 받아 /api/mcp에 연결합니다.
- AI가 /ai/tools 또는 MCP tools/list로 도구를 자동 등록합니다.
권한 범위
OAuth Scope: read
조회 도구만 사용할 수 있습니다. 출퇴근, 휴가, 직원, 결재, 급여, 조직 현황을 읽는 흐름에 적합합니다.
OAuth Scope: read_write
조회와 변경 도구를 사용할 수 있습니다. 휴가 승인, 공지 작성, 출퇴근 기록, 메뉴 설정 같은 작업은 이 범위가 필요합니다.
Role Permission
employee < dept_manager < hr_manager < owner 순서로 도구가 열립니다. 하위 역할의 도구는 상위 역할에서 함께 사용할 수 있습니다.