get_request
요청 번호로 상태와 담당자를 조회합니다.
{
"name": "get_request",
"inputSchema": {
"type": "object",
"properties": {
"request_id": { "type": "string" }
},
"required": ["request_id"]
}
}이런 분께 권합니다
AI가 사용할 도구의 경계를 직접 설계합니다.
- ✓Python 또는 TypeScript와 HTTP API 기초를 갖춘 개발자
- ✓사내 업무 도구를 AI 클라이언트와 연결하려는 엔지니어
- ✓도구 실행의 권한과 실패 처리를 검토해야 하는 기술 담당자
실습 미리보기
도구 하나에도 입력과 권한의 계약이 있습니다.
가상 사내 요청 조회 도구의 명세와 연결 경로입니다. 변경 권한 없이 필요한 정보만 조회하도록 범위를 나눈 예시입니다.
조회 권한만 분리
- 허용
- request:read
- 허용하지 않음
- 요청 수정 · 외부 발송
- 필수 확인
- 요청자 인증 · 자료 접근 범위
실패 응답 검토
- 요청 번호 누락 → 입력 오류
- 접근 범위 밖 → 권한 거절
- API 지연 → 시간 제한 안내
- 클라이언트도구 호출 요청
- MCP 서버입력·권한 확인
- 예제 업무 API허용된 자료 조회
- 도구 응답결과·실패 전달
01도구 설명과 입력 스키마를 맞춥니다.+
필수값과 자료 형식을 명시하고 서버에서도 입력값을 검증합니다.
02연결과 업무 권한을 구분합니다.+
도구에 연결됐더라도 자료와 작업에 대한 권한은 별도로 확인합니다.
03실패한 호출도 결과로 전달합니다.+
잘못된 입력과 권한 부족, 연결 실패를 구분해 검토할 수 있게 남깁니다.
화면과 자료는 교육 내용을 설명하기 위한 예시입니다. 실제 서비스에 접속하거나 자료를 전송하지 않습니다.
실습 결과물
수업에서 만들어 볼 것들
결과물을 직접 확인하며
내 업무에 맞게 고치는 연습을 합니다.
도구 명세와 입력 스키마
도구의 이름·설명·입력·출력을 정의합니다. 어떤 요청을 허용하고 거절할지 경계를 명세에 담습니다.
예제 API를 연결한 MCP 서버
실습용 조회 도구를 서버에 구현하고 클라이언트에서 호출을 확인합니다. 사내 연동을 가정한 연결 구조를 익힙니다.
권한·오류 검증 기록
인증 실패, 잘못된 입력과 연결 오류를 확인합니다. 읽기와 변경 작업의 권한을 구분하고 점검 결과를 기록합니다.
01연결할 업무 도구 정하기
클라이언트 · 서버 · 도구+
MCP의 구성 요소와 요청 흐름을 살펴봅니다. 예제 업무에서 조회할 정보와 허용할 작업을 정해 도구의 범위를 좁힙니다.
실습 결과도구 목록과 연결 구조
02입력과 출력의 계약 만들기
도구 설명 · JSON 스키마 · 검증+
도구가 받을 필수값과 자료 형식을 정의합니다. 잘못된 입력을 검증하고 클라이언트가 결과를 이해할 수 있도록 응답을 구성합니다.
실습 결과도구 명세와 입력 스키마
03서버와 예제 API 연결하기
SDK · HTTP API · 테스트 호출+
개강 시 검증한 SDK와 프로토콜 조합으로 서버를 구성합니다. 실습용 API의 조회 결과를 도구 응답으로 연결해 확인합니다.
실습 결과조회 도구를 제공하는 MCP 서버
04권한과 승인 지점 확인하기
인증 · 최소 권한 · 변경 작업+
연결 환경에 맞는 인증과 권한 경계를 살펴봅니다. 읽기와 변경 도구를 구분하고 서버의 권한 확인과 사용자 승인 지점을 설계합니다.
실습 결과권한 설계와 검증 기록
05실패 응답과 연결 점검
잘못된 입력 · 타임아웃 · 로그+
입력 오류, 권한 부족과 연결 실패를 테스트합니다. 민감한 값을 로그에 남기지 않는 기준과 연결 상태 점검 항목을 정리합니다.
실습 결과오류 처리 테스트와 연결 점검표
연결보다 먼저, 허용할 작업을 정합니다.
명세에서 서버로, 호출에서 검증으로
도구의 입출력 계약을 쓰고 실제 테스트 호출과 비교합니다. 정상 결과뿐 아니라 허용하지 않는 요청이 어떻게 처리되는지 확인합니다.
교육 내용을 표현한 연출 이미지도구 명세와 입력 스키마
도구의 이름·설명·입력·출력을 정의합니다. 어떤 요청을 허용하고 거절할지 경계를 명세에 담습니다.
예제 API를 연결한 MCP 서버
실습용 조회 도구를 서버에 구현하고 클라이언트에서 호출을 확인합니다. 사내 연동을 가정한 연결 구조를 익힙니다.
권한·오류 검증 기록
인증 실패, 잘못된 입력과 연결 오류를 확인합니다. 읽기와 변경 작업의 권한을 구분하고 점검 결과를 기록합니다.
이미지는 교육 내용 이해를 위한 예시입니다.
- 도구 명세·입력 스키마
- 서버·예제 API 연결
- 접근 권한·오류 검증
내 업무에 맞춰 쓰는 연습
연결을 설명할 수 있는 기술 문서
도구 목록과 입력 스키마, 권한과 실패 처리 기준을 함께 정리합니다. 다른 개발자가 테스트할 수 있는 호출 예시를 남깁니다.
- 01도구 명세·스키마
- 02권한 설계서
- 03오류·연결 테스트 기록
자료의 세부 구성과 제공 범위는 모집 공지에서 안내합니다.
참여 준비
수업 전에
확인해 주세요.
노트북과 Python 또는 TypeScript, JSON·HTTP API 기초가 필요합니다. MCP 클라이언트·SDK·프로토콜 호환성과 실습 환경은 개강 전에 확인합니다. 로컬 GPU를 전제로 하지 않으며, AI 계정·API 사용 여부와 별도 비용은 모집 공지에서 안내합니다.
준비 사항 문의자주 묻는 질문
참여 안내
실제 사내 시스템을 연결해야 하나요?
테스트용 API와 예제 계정을 기준으로 준비합니다. 실제 사내 시스템은 접근 권한과 보안 정책을 확인한 별도 환경에서 검토해야 합니다.
어떤 버전의 MCP를 배우나요?
프로토콜과 SDK, 클라이언트의 호환성을 개강 전에 확인해 안내합니다. 특정 버전을 계속 최신이라고 고정하지 않고 도구 명세와 연결 원리를 함께 다룹니다.
MCP를 연결하면 모든 작업이 허용되나요?
연결 자체가 업무 권한을 부여하지는 않습니다. 서버의 인증·인가와 작업별 권한, 사용자 확인이 필요한 지점을 나눠 설계하는 실습을 포함합니다.
일정과 수강료는 언제 안내하나요?
현재 개설 준비 중입니다. 일정·장소·수강료와 실습 환경, 신청 방법은 확정 후 이 페이지에 안내합니다.
MCP 서버 개발과 사내 도구 연동
교육 내용과 참여 방법,
궁금한 점을 남겨주세요.
개인 참여와 팀 단위 교육 모두 문의할 수 있습니다.