MCP Academy · 강의

첫 프롬프트 등록하기

함수에 데코레이터를 적용하여 프롬프트를 게시합니다.

레슨 1/413개 단계

첫 프롬프트 등록하기은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

첫 번째 prompt

이제 prompt를 공개할 차례입니다. prompt는 매번 잘 작성된 문장으로 작업을 시작하는 재사용 가능하고 사용자가 실행하는 템플릿입니다. 💬

데코레이터

@mcp.prompt() 데코레이터를 사용하면 일반 Python 함수를 prompt로 바꿀 수 있습니다. 도구를 @mcp.tool()로 표시한 것과 같은 방식입니다.

@mcp.prompt()
def greet() -> str:
    return "Say hello warmly."

이름은 함수에서 가져옵니다

기본적으로 prompt의 이름은 함수 이름입니다. 클라이언트는 슬래시 메뉴에 이 이름을 표시하므로 짧고 명확하게 지정하세요.

반환 값

가장 단순한 prompt는 문자열을 반환합니다. 사용자가 prompt를 선택하면 이 텍스트가 모델에 전달되는 첫 번째 사용자 메시지가 됩니다.

설명 추가

함수의 독스트링이 prompt 설명이 됩니다. 사용자가 실행하기 전에 이 prompt의 용도를 알려 줍니다.

@mcp.prompt()
def greet() -> str:
    """Start a friendly greeting."""
    return "Say hello warmly."

자동 실행이 아닌 사용자 실행

도구와 달리 prompt는 사용자가 명시적으로 선택할 때만 실행됩니다. 모델이 prompt를 스스로 호출하는 일은 없습니다.

서버에 등록됩니다

prompt는 도구와 리소스를 담고 있는 동일한 FastMCP 서버 인스턴스에 등록됩니다. 서버 하나에서 세 가지 기본 요소를 사용할 수 있습니다.

mcp = FastMCP("my-server")

@mcp.prompt()
def greet() -> str:
    return "Say hello warmly."

클라이언트가 나열할 수 있습니다

등록이 완료되면 클라이언트가 prompts/list를 호출해 prompt를 검색합니다. 이를 통해 호스트가 슬래시 명령 또는 템플릿 메뉴를 채웁니다.

선택하고 메시지 받기

사용자가 prompt를 선택하면 호스트가 이를 가져와 반환된 텍스트로 채팅을 시작합니다. 사용자는 다듬어진 첫 문장으로 시작하게 됩니다.

텍스트를 집중해서 작성하기

좋은 prompt 본문은 선택지를 길게 나열하지 않고 모델에 명확한 지침을 제공합니다. 목표와 어조를 말한 다음 끝내세요.

사용할 이유

등록된 prompt는 모두가 같은 요청을 다시 입력하지 않아도 되게 하고, 팀 전체에서 표현을 일관되게 유지해 줍니다. ✨

빠른 확인

prompt가 어떻게 등록되는지 확인해 보겠습니다.

인터랙티브 레슨에서 답해보세요

복습: 첫 번째 prompt

잘하셨습니다! @mcp.prompt() 데코레이터는 함수를 사용자가 실행하는 템플릿으로 공개하며, 이름과 독스트링을 사용자에게 표시합니다. ✅

무료로 시작

AI 튜터와 함께 Python을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스: 30
레슨: 120

무료로 학습 시작 전체 코스 보기

자주 묻는 질문

“첫 프롬프트 등록하기” 강의는 무료인가요?

네 — “첫 프롬프트 등록하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“첫 프롬프트 등록하기”에서 뭘 배우나요?

함수에 데코레이터를 적용하여 프롬프트를 게시합니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

MCP Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“첫 프롬프트 등록하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← MCP Academy(으)로 돌아가기