인사책 MCP 연동 문서

OAuth Discovery

{
  "issuer": "https://insacheck.com",
  "mcp_server_url": "https://insacheck.com/api/mcp",
  "authorization_endpoint": "https://insacheck.com/oauth/authorize",
  "token_endpoint": "https://insacheck.com/oauth/token",
  "registration_endpoint": "https://insacheck.com/oauth/register",
  "revocation_endpoint": "https://insacheck.com/oauth/revoke",
  "introspection_endpoint": "https://insacheck.com/oauth/introspect",
  "scopes_supported": [
    "read",
    "read_write"
  ],
  "scope_rule": "read_write includes read. Request scope=read_write alone for full access. scope=read read_write is accepted and normalized to read_write for compatibility.",
  "code_challenge_methods_supported": [
    "S256"
  ]
}

권한 범위

쓰기 도구는 OAuth scope read_write가 필요합니다.
조회 도구는 read로 사용할 수 있습니다.
표준 호환을 위해 scope=read read_write 요청은 read_write로 정규화하지만,
클라이언트는 전체 권한 요청 시 scope=read_write만 보내는 것을 권장합니다.

예제 요청

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "query_attendance_today",
    "arguments": {
      "date": "2026-06-13"
    }
  }
}

예제 응답

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ \"date\": \"2026-06-13\", \"records\": [] }"
      }
    ],
    "isError": false
  }
}

Tool 목록