Aside로 작은 스킬을 만들고, PowerShell에서 CLI·MCP 실행까지 확인했습니다
2026.10.20
소개
Aside를 처음 접하는 분들에게 도움이 되는 사례글을 쓰고 싶었습니다. 설정이나 페이지 요약에서 한 걸음 더 나아가, 실제로 작은 작업을 끝내 보는 과정을 담고자 했습니다.
이번에는 3주차 학습자료를 바탕으로 다음 작업을 진행했습니다.
내장 스킬을 사용하기 전과 후의 결과 비교
학습자료를 실행 체크리스트로 바꾸는 사용자 스킬 제작
REPL로 작은 브라우저 동작 실행
Windows PowerShell에서 CLI 작업 실행
MCP 도구 발견과 실제 호출, 시험 서버 종료
처음부터 순조롭게 진행되지는 않았습니다. 에이전트의 실행 환경에서는 접근 거부 오류가 났습니다. 하지만 거기서 Windows에서는 안 된다고 결론 내리지 않고, 제 일반 PowerShell에서 확인하면서 다음 단계로 이어갔습니다.
이 글은 제가 요청하고 승인한 일, 에이전트가 수행한 일, 제가 PowerShell에서 직접 실행한 일을 구분한 기록입니다.
진행 방법
1. 작은 실습 주제부터 정했습니다
실습 주제는 “공개 학습자료를 읽고 초보자용 실행 체크리스트 만들기”로 정했습니다.
재료는 보고 있던 3주차 강의자료였습니다. 새로운 회사 자료나 업무 계정을 연결하지 않고도 진행할 수 있는 작업이었습니다.
학습자료에 나온 과제는 단순히 스킬 파일 하나를 만드는 데서 끝나지 않았습니다. 실제로 사용하고, 결과를 확인하고, 막혔다면 다시 시작할 위치까지 남기는 과정이 포함돼 있었습니다.
2. 내장 스킬로 같은 내용을 다르게 표현해 봤습니다
먼저 에이전트가 과제를 일반적인 목록으로 정리했습니다. 이후 내장 visualize 스킬을 읽고, 같은 내용을 표 형태로 표현했습니다.
이번에 확인한 차이는 내용의 정확도보다 표현 형식의 차이였습니다.
할 일은 그대로였지만 목록이 표로 바뀌었습니다. 작업 시간이나 정확도는 측정하지 않았고, 독립된 환경에서 반복한 실험도 아니었습니다.
따라서 “스킬을 사용했더니 성능이 좋아졌다”고 결론 내리지는 않았습니다. 어떤 스킬을 적용했고 결과물의 무엇이 달라졌는지 확인한 간이 비교였습니다.
3. 반복해서 쓸 사용자 스킬을 만들었습니다
다음에는 학습자료를 체크리스트로 바꾸는 방법 자체를 사용자 스킬로 만들었습니다.
이름은 learning-action-checklist로 정했습니다. 다음 내용을 빠뜨리지 않도록 구성했습니다.
지금 해야 할 일
남겨야 할 결과
완료를 확인할 기준
근거가 되는 출처
현재 진행 상태
막혔을 때 다시 시작할 위치
특히 자료에 적힌 요구사항과 에이전트의 추천을 분리하도록 했습니다.
예를 들어 원문에 없는 완료 기준을 제안한다면, 확정된 요구사항처럼 쓰지 않고 ‘추천 확인 기준’으로 표시하는 방식입니다.
또한 체크리스트를 작성해 달라는 요청만으로 설치, 로그인, 외부 전송, 설정 변경 등을 실행하지 않도록 경계를 넣었습니다.
에이전트가 변경안을 보여준 뒤, 저는 저장을 승인했습니다.
text
저장해새 SKILL.md 파일이 저장됐고, 에이전트가 파일을 다시 읽어 확인했습니다.
공식 형식 검증 명령은 권한 오류로 실행되지 않았습니다. 대신 검증 스크립트의 검사 내용을 확인한 뒤, 같은 형식 검사를 내장 REPL에서 수행해 통과했습니다.
여기서도 파일 형식 확인과 앱의 스킬 인식은 다른 단계로 구분했습니다.
4. 저장한 스킬을 직접 적용했습니다
에이전트가 저장된 스킬 파일을 직접 읽고, 강의자료에 적용했습니다.
처음에는 단순한 할 일 목록이었다면, 적용 후에는 해야 할 일과 결과, 확인 기준, 출처, 현재 상태를 함께 정리했습니다.
예를 들면 다음과 같은 차이입니다.
“사용자 스킬 만들기”에서 끝내지 않고, 저장·직접 적용·자동 인식 여부를 따로 표시
“CLI 실행”이라고만 쓰지 않고, 도움말 확인인지 실제 작업 실행인지 구분
실패한 작업은 완료로 바꾸지 않고, 오류와 재개 위치를 남김
다만 이번에는 에이전트가 파일을 직접 읽어 적용한 것입니다. 요청만 보고 앱이 새 스킬을 자동으로 선택하는지는 아직 확인하지 않았습니다.
5. REPL에서는 작은 화면 동작을 확인했습니다
REPL은 작은 코드를 실행하고 결과를 바로 관찰하는 방식입니다.
에이전트가 Aside의 내장 REPL 도구로 강의자료의 ‘다음’ 버튼을 눌렀습니다. 이후 화면 상태를 다시 읽어 48장에서 49장으로 이동한 것을 확인했습니다.
내장 REPL 실행 직후 남긴 화면입니다. PowerShell에서 aside repl 명령을 실행한 화면은 아닙니다.
작은 동작이지만, 요청을 보냈다는 사실과 실제로 화면이 바뀌었다는 사실을 구분해 확인할 수 있었습니다.
6. 접근 거부 오류가 나자 일반 PowerShell에서 다시 확인했습니다
CLI는 터미널에서 명령으로 작업을 요청하는 방식입니다.
처음에는 에이전트가 실행한 aside --help에서 “액세스가 거부되었습니다”라는 오류가 발생했습니다.
여기서 멈췄다면 “Windows에서는 CLI가 안 된다”고 오해할 수도 있었습니다. 하지만 확인해 보니 에이전트의 PowerShell은 제한된 환경이었고, aside 명령이 가리키는 실행 파일 경로도 제 일반 PowerShell과 달랐습니다.
그래서 제가 일반 Windows PowerShell에서 다음 명령을 실행했습니다.
powershell
Get-Command aside -All | Select-Object Name, Sourceaside --help이번에는 실제 CLI 경로가 확인됐고 도움말도 정상 출력됐습니다.
에이전트 환경에서의 실패가 제 일반 Windows 환경에서도 그대로 발생하는 것은 아니었습니다.
이어서 제가 다음 명령을 실행했습니다.
powershell
aside --permission guard "https://example.com 을 열고 화면에 보이는 제목을 알려줘. 로그인, 폼 제출, 파일 저장, 설정 변경은 하지 마."실제 결과는 다음과 같았습니다.
새 작업 세션 생성
example.com페이지 열기페이지 상태와 스크린샷 확인
탭 제목이
Example Domain이라는 결과 반환
도움말 출력에 그치지 않고, CLI로 요청한 브라우저 작업이 실제로 수행되는 것까지 확인했습니다.
업데이트 안내도 표시됐지만 오류와는 별개였고, 이번 실습에서는 업데이트하지 않았습니다.
7. MCP는 연결 다음에 실제 도구 호출까지 진행했습니다
MCP는 다른 프로그램이 Aside의 도구를 사용할 수 있도록 연결하는 방식입니다.
이번에는 별도 AI 앱의 설정을 변경하는 대신, 에이전트가 작성해 준 코드를 제가 PowerShell에서 실행했습니다. PowerShell을 임시 MCP 클라이언트로 사용한 실습이었습니다.
진행 순서는 다음과 같았습니다.
aside mcp로 시험용 서버 시작initialize로 초기 연결tools/list로 사용 가능한 도구 확인발견된 도구의 입력 형식 확인
tools/call로 실제 도구 호출반환된 결과 확인
실제로 발견된 도구는 세 가지였습니다.
replmemory_searchexec
이 중 repl을 선택했습니다. 입력 형식에 title과 code가 필요하다는 것을 확인한 뒤, 기존에 열려 있던 example.com 탭을 읽도록 호출했습니다.
새로운 개인 자료나 기억을 검색하지 않고, 이미 열어 둔 공개 페이지만 읽는 작업이었습니다.
반환된 결과에는 다음 페이지 정보가 포함돼 있었습니다.
text
- title: "Example Domain" [url=https://example.com/]또한 응답에서 다음 값을 확인했습니다.
json
"isError": false이제는 단순히 “MCP 서버가 켜졌다”가 아니라, 도구 발견 → 실제 호출 → 페이지 정보 반환까지 확인한 상태가 됐습니다.
다만 Claude나 다른 AI 앱에 영구적으로 연결한 것은 아닙니다. 이번에 확인한 범위는 PowerShell 임시 클라이언트를 통한 MCP 호출입니다.
8. 시험 서버 종료도 확인했습니다
실습이 끝난 뒤에는 같은 PowerShell에서 시험용 서버의 입력을 닫고 종료를 기다렸습니다.
powershell
$mcpProc.StandardInput.Close()$mcpProc.WaitForExit(5000)결과는 다음과 같았습니다.
text
True시험용 MCP 서버가 종료된 것까지 확인하고 실습을 마쳤습니다.
결과와 배운 점
“진행했다”는 말의 범위를 확인하게 됐습니다
중간에 에이전트가 완료한 작업을 정리해 주었을 때, 저는 실제로 진행한 것이 맞는지 다시 물었습니다.
확인하면서 수행 주체와 완료 범위를 나누는 것이 중요하다는 점이 드러났습니다.
제가 한 일: 주제 선택, 진행 요청, 저장 승인, 일반 PowerShell 명령과 시험 코드 실행
에이전트가 한 일: 스킬 작성·직접 적용, 내장 REPL 실행, PowerShell 코드 작성과 로그 분석
함께 확인한 결과: CLI 작업 성공, MCP 도구 호출과 응답, 시험 서버 종료
에이전트가 수행한 작업과 제가 직접 실행한 작업을 구분하니, 무엇을 실습했고 무엇이 아직 미확인인지 더 정확하게 정리할 수 있었습니다.
이번에 확인한 것과 남은 것을 나눴습니다
확인한 것
사용자 스킬 파일 저장과 형식 확인
저장된 스킬을 직접 읽어 적용한 결과
내장 REPL의 실제 화면 동작
일반 PowerShell에서 CLI 작업 실행
임시 MCP 클라이언트의 도구 발견·호출·결과 반환
시험용 MCP 서버 종료
아직 확인하지 않은 것
새 사용자 스킬의 자동 인식과 자동 선택
PowerShell에서
aside repl명령만 별도로 실행하는 방식다른 AI 앱에 MCP를 영구 연결하는 설정
따라서 모든 활용 방식을 익혔다고 표현하기보다, 이번에 실제로 확인한 범위까지만 기록하는 것이 맞겠습니다.
초보자에게 권하고 싶은 확인 순서
이번 경험을 바탕으로 다음 순서로 확인해 보기를 권하고 싶습니다.
설명서나 결과가 작성됐는가?
파일이 실제로 저장됐는가?
앱이 사용할 수 있는 상태인가?
도구가 실제 작업에 사용됐는가?
요청한 결과나 오류가 반환됐는가?
임시로 실행한 도구는 종료됐는가?
이번에 얻은 가장 중요한 기준은 다음과 같습니다.
AI가 “완료했다”고 말했을 때, 무엇을 실행했고 어떤 결과를 확인했는지까지 물어보기.
또한 오류가 났을 때 바로 기능 전체가 안 된다고 결론 내리기보다, 어느 환경에서 어떤 실행 파일을 사용했는지 확인하는 과정이 필요했습니다.
처음 Aside를 사용한다면 큰 자동화부터 만들기보다, 공개 자료 하나와 작은 작업 하나로 시작해 보는 방법을 추천합니다. 작더라도 실행과 결과 확인을 끝까지 경험하는 데 의미가 있었습니다.




초보자용 실행 체크리스트를 만들겠다는 작은 주제로, 스킬 작성부터 CLI 작업과 MCP 호출까지 실제로 확인하셨네요. 공개 학습자료를 재료로 삼아 업무 계정을 새로 연결하지 않고도 실행과 결과 확인을 경험할 수 있게 잡으신 범위가 처음 따라가는 분들에게도 구체적입니다.
learning-action-checklist에는 할 일만 적지 않고 결과·확인 기준·출처·현재 상태·다시 시작할 위치를 담으셨지요. 자료의 요구사항과 에이전트의 추천을 나누고, 체크리스트 작성 요청이 설치나 외부 전송의 허락이 되지 않도록 한 부분도 함께 읽었습니다.
접근 거부가 났을 때는 에이전트 쪽 PowerShell과 일반 PowerShell의 실행 파일 경로를 비교하셨습니다. 그 뒤 직접 실행한 CLI가 Example Domain을 반환한 결과까지 남겨, 도움말이 출력된 것과 요청한 브라우저 작업이 된 것을 따로 확인하셨어요. 제한된 환경의 실패를 Windows 전체의 문제로 넓히지 않은 과정입니다.
MCP도 서버 시작에서 멈추지 않고 도구 목록과 입력 형식을 확인한 뒤, repl로 이미 열린 공개 페이지를 읽으셨네요. 페이지 정보와 오류 없는 응답을 받고 시험 서버가 종료된 것까지 기록해, 연결부터 마무리까지 무엇을 확인했는지 따라갈 수 있습니다.
목록을 표로 바꾼 비교는 표현 형식의 차이로, 저장한 스킬은 직접 읽어 적용한 결과로 한정하신 설명도 정확합니다. 자동 선택이나 다른 앱에 영구 연결하는 방식은 미확인으로 남겨, 독자가 같은 완료 표시로 묶어 받아들이지 않게 해주셨어요.
직접 승인하고 실행한 일과 에이전트가 작성하거나 분석한 일을 나누어 적어주신 덕분에, 결과를 확인한 주체가 또렷합니다. 작은 실습에서도 완료라는 말에 어떤 실행과 결과가 따라야 하는지 보여주셨네요.