인사책 AI 연동

인사책은 사람이 쓰는 HR SaaS이면서 AI가 공식 문서를 읽고 연결할 수 있는 서비스입니다.
Claude와 ChatGPT에서 자연어로 출퇴근, 휴가, 급여, 전자결재 업무를 처리하세요.

  • OAuth 2.1 + PKCE
  • MCP Streamable HTTP
  • tools list: /ai/tools
mcp.config.json JSON
{
  "mcpServers": {
    "insacheck": {
      "url": "https://insacheck.com/api/mcp",
      "auth": {
        "type": "oauth"
      }
    }
  }
}
INSACHECK_MCP_CONNECTED TOOLS AVAILABLE

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 서버로 인사책 도구를 제공합니다. 전체 목록은 /ai/tools에서 봅니다.
인증 전 공개 카탈로그(/mcp/tools.json)에는 그중 조회 도구가 실립니다.

https://insacheck.com/api/mcp

OpenAPI 공개

AI discovery, OAuth, MCP, tool registry endpoint를 OpenAPI 3.1로 제공합니다.

https://insacheck.com/openapi.json

AI가 읽어야 하는 공식 URL

인사책 연결 여부, 도구 권한, 입력 스키마와 인증 방식을 기계가 읽을 수 있는 경로로 공개합니다.

말 한마디에서 도구 등록까지

사용자는 연결을 승인하고, AI 클라이언트는 표준 문서와 discovery endpoint를 따라 필요한 설정을 완료합니다.

  1. STEP_01

    연결 요청

    사용자가 AI에게 “인사책 연결해줘”라고 말합니다.

  2. STEP_02

    자동 발견

    AI가 /.well-known/ai-plugin.json과 공식 문서를 읽습니다.

  3. STEP_03

    보안 확인

    OAuth discovery에서 authorization, token endpoint와 PKCE 방식을 확인합니다.

  4. STEP_04

    사용자 승인

    사용자가 인사책에 로그인하고 필요한 읽기·쓰기 권한을 승인합니다.

  5. STEP_05

    MCP 연결

    AI 클라이언트가 access token을 받아 /api/mcp에 연결합니다.

  6. STEP_06

    도구 등록

    /ai/tools 또는 tools/list로 사용할 도구를 자동 등록합니다.

읽기·쓰기·역할 권한을 분리

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

지금 쓰는 AI에서 인사책을 연결하세요.

별도 AI 사용료 없이 기존 Claude·ChatGPT 환경에서 인사 업무 도구를 연결할 수 있습니다.