인사책 MCP 연동 문서

OAuth Discovery

{
  "issuer": "https://timesync-dfu.pages.dev",
  "mcp_server_url": "https://timesync-dfu.pages.dev/api/mcp",
  "authorization_endpoint": "https://timesync-dfu.pages.dev/oauth/authorize",
  "token_endpoint": "https://timesync-dfu.pages.dev/oauth/token",
  "registration_endpoint": "https://timesync-dfu.pages.dev/oauth/register",
  "revocation_endpoint": "https://timesync-dfu.pages.dev/oauth/revoke",
  "introspection_endpoint": "https://timesync-dfu.pages.dev/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만 보내는 것을 권장합니다.

안전 경계

되돌리기 어려운 작업은 scope 와 역할만으로 실행하지 않습니다.
아래 permission 에 속한 도구는 이 문서 끝의 Tool 목록에서 「확인」 표시가 붙어 있고,
첫 호출이 실행 대신 확인 요청을 돌려줍니다.

AI 클라이언트는 이 응답을 사람에게 보여 주고,
사람이 승인하면 같은 arguments 에 confirmation_id 를 넣어 다시 호출합니다.
확인 코드는 한 번 쓰면 소모되고 유효 시간이 지나면 만료되며,
arguments 가 한 글자라도 달라지면 그 코드로는 실행되지 않습니다.
만료·재사용은 -32004 로 거절합니다.
action_preview 의 인자 중 확인 코드·초대 코드·API 키·Authorization·쿠키·비밀번호 형태는 가려서 보여 줍니다.

{
  "requires_confirmation": true,
  "confirmation_id": "<서버가 발급한 1회용 코드>",
  "confirmation_message": "<사람에게 보여 줄 확인 문장>",
  "permission": "leave.approve",
  "action_preview": {
    "tool_name": "approve_leave",
    "arguments": {
      "leave_id": 1234
    }
  },
  "next_step": "사용자가 명시적으로 승인하면 같은 tool arguments에 confirmation_id를 포함해 다시 호출하세요."
}

예제 요청

{
  "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 목록