MCP 서버 템플릿 보고서와 클로드
I’m happy to translate the article for you, but I’ll need the full text of the post (the content you’d like translated). Could you please paste the article’s body here? Once I have that, I’ll keep the source line unchanged and provide a Korean translation while preserving all formatting, markdown, and code blocks.
소개
최근에 AI를 가지고 많이 놀고 있었는데, 제가 자주 하게 된 일 중 하나는 MCP 서버와 통합하고, Claude의 Projects 기능을 사용해 맞춤 보고서를 생성하는 것입니다.
이것은 무엇인가?
원격 MCP 서버를 설정했으며, 이 서버는 Star Wars API (SWAPI)에서 데이터를 가져옵니다. 이 서버는 내 도메인 중 하나에 호스팅되어 있습니다. 글을 짧고 주제에 맞게 유지하기 위해, MCP 서버 자체의 구체적인 내용은 다루지 않고 Claude 구성 요소에만 초점을 맞추겠습니다. 서버는 정상적으로 실행 중이며, 연결도 가능합니다.
MCP 서버
MCP 서버는 두 가지 도구를 제공합니다:
get_swapi_character– ID로 SWAPI에서 캐릭터 정보를 가져옵니다.get_all_swapi_people– SWAPI에서 모든 사람을 가져옵니다.
이 구현은 MCP 서버 내에서 도구를 매우 간단하게 구현한 것이지만, MCP와 사용 가능한 도구를 이용해 보고서를 생성하는 목적을 수행합니다.
Claude 프로젝트
저는 Claude 프로젝트를 사용하여 컨텍스트와 지시사항을 자체적으로 포함시키고 있습니다. 이렇게 하면 모든 템플릿과 기록을 함께 유지하기가 더 쉬워집니다.
Claude 프로젝트에 대해 여기서 읽어볼 수 있습니다:
Claude에서 프로젝트를 만들 때의 일부는 지시사항을 작성하는 것입니다. 지시사항은 프로젝트가 사용될 때마다 Claude에게 무엇을 해야 하는지 알려줍니다.
프로젝트 지시사항은 다음과 같이 명시하고 있습니다:
- 템플릿 파일을 사용하여 문서를 생성합니다.
- 프로젝트에 기본 이름을 지정합니다.
- 템플릿 안의 추가 지시사항을 읽습니다.
- 기본 스타워즈 브랜드 스타일을 사용하지 마세요 (검정‑노랑 테마는 그래프를 읽기 어렵게 만듭니다).
- 사용자에게 출력 형식을 PowerPoint (
.ppt) 파일로 할지 Word 문서 (.doc) 로 할지 물어봅니다.
이 모든 지시사항은 프로젝트가 사용될 때 실행됩니다. 가장 중요한 두 가지는 템플릿 파일 안의 지시사항을 읽는 것과 스타워즈 브랜딩을 피하는 것입니다.
템플릿 파일
템플릿 파일은 내장된 추가 지시사항이 포함된 표준 Word 문서입니다. 또한 프로젝트 이름을 설정하기 위해 변수를 사용합니다.
템플릿의 프롬프트는 비교적 간단하고 직관적으로 유지했지만, 더 복잡한 프롬프트를 추가하여 다양한 기능을 구현할 수 있습니다.
제가 아직 시도해보지 않은 한 가지는 템플릿 안에 명시적인 도구 호출을 직접 배치하는 것입니다. 다만 프로젝트 지시사항에는 명시적인 도구 호출이 포함되어 있다는 점을 참고하세요.
Report Generation
보고서를 생성하려면, 저는 단순히 Claude를 열고 프로젝트로 이동한 뒤 “generate report.” 라고 말합니다.
흥미로운 점은, 사용자가 선호하는 출력 형식을 물어보는 지시가 프로젝트에서 마지막 지시임에도 불구하고 Claude가 이를 먼저 실행한다는 것입니다. Claude는 해당 정보 없이는 진행할 수 없다는 것을 알고 즉시 사용자에게 프롬프트를 표시합니다.
사고 과정에서 Claude는 템플릿을 읽고, 지시들을 종합하며, 어떤 도구를 호출할지 결정합니다. 여러 MCP 서버가 연결된 경우, 이름으로 연결을 지정하거나 도구를 직접 지정하는 것이 더 빠르고 신뢰할 수 있습니다.
다음 단계
올바른 도구 호출이 사용되고 데이터가 반환되는 것을 확인할 수 있습니다. 여기서 클라이언트(Claude)가 도구 호출을 수행하고 백엔드 API로부터 응답을 받습니다.
행성 데이터 재키잉
다음 두 단계는 흥미롭습니다. 첫 번째 단계에서는 Claude가 조회한 기존 데이터셋에서 행성 데이터를 추출합니다. 본질적으로 행성 데이터가 사람 데이터에 포함되어 있기 때문에 기존 데이터를 재배열하거나 재키합니다.
PPTX 내보내기
퍼즐의 마지막 조각: Claude는 내장된 기능을 사용해 .pptx 파일을 내보내어 제가 확인할 수 있게 합니다.
출력 개요
출력은 간단합니다:
- 행성 데이터 그래프.
- 템플릿에 요청한 필드가 포함된 사람들의 표.
가장 놀라운 점은, 브랜딩이 전통적인 검정‑노랑이 아님이라는 것입니다.
MCP Logs
서버 측에서 클라이언트(Claude)가 먼저 도구 목록을 조회하고 그 다음 get_all_swapi_people 도구를 호출한 것을 확인할 수 있습니다. 이 내용은 다음 글에서 더 자세히 살펴보겠습니다.
2026-01-16 03:09:20 - mcp.server.lowlevel.server - INFO - Processing request of type ListToolsRequest
2026-01-16 03:10:39 - mcp.server.lowlevel.server - INFO - Processing request of type CallToolRequest
2026-01-16 03:10:39 - root - INFO - Tool called: get_all_swapi_people with arguments: {}
2026-01-16 03:10:39 - root - INFO - Fetching all people from SWAPI
2026-01-16 03:10:39 - root - INFO - Making request to: http://localhost:3000/people/
2026-01-16 03:10:39 - httpx - INFO - HTTP Request: GET http://localhost:3000/people/ "HTTP/1.1 200 OK"
2026-01-16 03:10:39 - root - INFO - Successfully fetched data from: http://localhost:3000/people/
2026-01-16 03:10:39 - root - INFO - Successfully fetched 83 people요약
Claude와 MCP를 사용해 자동 보고서 생성(및 그 외 작업)을 하지 않고 있다면, 큰 기회를 놓치고 있는 겁니다. 모든 설정에 드는 노력은 최소 수준이었습니다:
- 템플릿을 만드는 데 대략 5 분 정도 걸렸습니다.
- 프로젝트 지시는 간단했으며, 몇 차례의 작은 반복만으로 충분했습니다.
활용 사례는 무궁무진합니다—규제 보고서 작성, 정기 비즈니스 대시보드 제작, 혹은 반복되는 모든 문서 작업 등.
보고서 생성 필요에 MCP와 Claude 프로젝트를 적극 활용하시길 강력히 권합니다. 도입이 쉽고 놀라울 정도로 유연합니다!