코드에서 도구 호출하기
서버 도구를 호출하고 결과를 읽습니다.
코드에서 도구 호출하기은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
나열에서 실행으로
검색을 통해 무엇이 존재하는지 알았습니다. 이제 실제로 도구를 호출하고, 인수를 보내고, 자체 코드에서 결과를 읽습니다.
이름으로 호출하기
도구 이름과 인수 사전을 함께 사용하여 session.call_tool()을 호출합니다. 이름은 검색한 inputSchema와 일치해야 합니다.
result = await session.call_tool(
"add",
{"a": 2, "b": 3},
)인수는 검증을 통과해야 합니다
인수 사전은 도구의 inputSchema를 충족해야 합니다. 잘못된 형태를 보내면 서버가 호출을 거부합니다.
await session.call_tool("greet", {"name": "Ada"})콘텐츠 읽기
결과에는 블록으로 구성된 콘텐츠 목록이 포함됩니다. 대부분의 도구는 텍스트를 반환하므로 첫 번째 블록에서 텍스트를 읽습니다.
print(result.content[0].text)오류 확인하기
실패한 도구는 오류를 발생시키는 대신 결과의 isError를 true로 설정합니다. 이를 확인하여 클라이언트가 적절히 대응하도록 합니다.
if result.isError:
print("tool failed")구조화된 출력도 받기
서버가 출력 스키마를 정의한 경우 최신 도구는 텍스트와 함께 유형이 지정된 객체인 structuredContent도 반환할 수 있습니다.
print(result.structuredContent)실제 인수 전달하기
인수는 프로그램, 사용자 또는 모델에서 가져옵니다. 클라이언트는 이를 일반 사전으로 변환하여 이름이 지정된 도구에 전달할 뿐입니다.
args = {"city": "Paris"}
await session.call_tool("weather", args)여전히 비동기입니다
모든 네트워크 호출과 마찬가지로 call_tool도 기다려야 합니다. await는 서버가 작업을 마치고 결과가 돌아올 때까지 실행을 일시 중지합니다.
호출 하나에 결과 하나
각 호출은 요청과 응답의 쌍입니다. 세션은 ID를 기준으로 응답과 요청을 일치시키므로 결과가 서로 뒤섞이지 않습니다.
느린 도구 처리하기
일부 도구는 시간이 걸립니다. 견고한 클라이언트는 도구가 멈춰 전체 프로그램을 중단하지 않도록 시간 제한을 설정합니다.
오케스트레이터는 여러분입니다
코드에서 도구를 호출하면 프로그램이 순서를 결정하고, 결과를 결합하며, 원시 출력을 사용자에게 유용한 형태로 변환합니다.
빠른 확인
클라이언트 코드에서 검색한 도구를 어떻게 실행합니까?
복습: 호출 만들기
도구를 처음부터 끝까지 호출했습니다. 유효한 인수로 이름을 사용해 호출하고, 콘텐츠 블록을 읽고, 출력을 신뢰하기 전에 isError를 확인했습니다.
자주 묻는 질문
“코드에서 도구 호출하기” 강의는 무료인가요?
네 — “코드에서 도구 호출하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“코드에서 도구 호출하기”에서 뭘 배우나요?
서버 도구를 호출하고 결과를 읽습니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
MCP Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“코드에서 도구 호출하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 클라이언트 세션 열기
- 도구와 리소스 탐색하기
- 코드에서 도구 호출하기
- LLM을 통한 도구 호출 라우팅