커스텀 MCP 설치
추천 목록에 없는 MCP를 Add Extension으로 직접 등록하거나, 에이전트에게
@skill:mcp-installer로 맡기는 방법입니다.
추천 프리셋만 쓰려면 Extensions로 MCP 설치하기를 보세요.
언제 커스텀이 필요한가
- npm/
npx패키지, GitHub의 MCP 서버 - 자체
node/python/uvx명령 - 원격 HTTP/SSE MCP 엔드포인트
- Cursor / VS Code / Windsurf 등 다른 앱에 있던 MCP를 가져올 때
방법 A — UI: Add Extension
- 사이드바 Extensions → Tools
- Add Extension (
확장 기능 추가) - 필드 입력 후 Save
공통 필드
- Name — 고유 id (예:
filesystem,my-search). builtin 예약 이름은 사용 불가 - Description — 선택
- Transport Type
- stdio (Local Process) — 로컬에서 프로세스 실행
- HTTP (Remote Server) — URL로 접속
stdio (로컬)
| 필드 | 의미 | 예 |
|---|---|---|
| Command | 실행 파일 | npx, uvx, node, python |
| Arguments | 공백 구분 인자 | -y @modelcontextprotocol/server-filesystem /tmp |
| Environment Variables | 프로세스에 넘길 키/값 | API 키 등 |
예시 — filesystem:
- Name:
filesystem - Transport: stdio
- Command:
npx - Arguments:
-y @modelcontextprotocol/server-filesystem /path/to/folder
npx/uv가 없으면 먼저 @skill:setup-wizard 또는 App Wizard로 런타임을 설치하세요.
HTTP (원격)
| 필드 | 의미 |
|---|---|
| URL | MCP 엔드포인트 전체 URL |
| API Key / Token (선택) | 있으면 Authorization: Bearer … 자동 추가 |
| Custom Headers (고급) | 추가 헤더 |
| Enable SSE | 스트리밍용. 상태 없는 HTTP면 끌 수 있음 |
저장 후
- 목록에서 Active 확인
- 필요하면 Assistants에서 그 확장 허용
- 새 세션/다음 턴에서 도구 사용
편집·삭제는 카드의 Edit / Delete입니다.
방법 B — 에이전트: @skill:mcp-installer
채팅에서:
@skill:mcp-installer
npx로 @modelcontextprotocol/server-everything 를 LibrAgent에 등록해줘.@skill:mcp-installer
Cursor에 있는 MCP 설정을 읽어서 LibrAgent에 가져와줘.이 스킬이 하는 일:
- 패키지·GitHub·JSON 설정으로 Extensions에 직접 등록 (추천 카탈로그에 있는 프리셋을 먼저 확인)
- Cursor / VS Code / Windsurf / Claude Desktop 등 설정 파일에서 가져와 비교·등록
- 등록 후
tool__verifyServer로 실제 연결을 확인하고, 실패하면 원인(런타임 없음, API 키 누락 등)을 알려 줌 - 연결 확인이 끝나면 지금 대화 중인 어시스턴트에 바로 연결할지 물어보고 안내함
추천 카탈로그의 기본 프리셋 그대로 설치할 때는 별도 승인 없이 바로 등록됩니다. 그 외 외부 패키지나 직접 수정한 MCP 서버를 등록·변경할 때는 앱이 실행할 명령(또는 URL)을 보여 주고 승인을 받습니다. YOLO 모드에서도 이 승인은 건너뛰지 않습니다. MCP 서버는 내 컴퓨터에서 임의 명령을 실행하기 때문입니다.
GitHub 주소를 주면 에이전트가 먼저 내용을 확인합니다. SKILL.md가 있으면 스킬이므로 skill-deployer로, MCP 서버 패키지면 이 스킬로 설치합니다.
자세한 절차는 번들 스킬 mcp-installer 본문을 따릅니다. (스킬 카탈로그)
일상적으로는 방법 A(Add Extension UI) 를 먼저 쓰세요. 에이전트 설치는 마이그레이션·일괄 등록에 유리합니다.
어시스턴트에 연결하기
확장을 설치만 하고 어시스턴트에서 막혀 있으면 도구가 안 보입니다.
- Manage Assistants (또는 Assistants)에서 프로필 편집
- MCP / 서버 선택 UI에서 해당 확장을 허용
- 그 어시스턴트로 세션을 다시 시작
(정확한 탭 라벨은 UI의 “Select which MCP servers this assistant can access” 계열입니다.)
문제 해결
| 증상 | 확인 |
|---|---|
| 저장은 됐는데 도구 없음 | Active 여부, 어시스턴트 MCP 허용, 세션 재시작 |
command not found / npx 실패 | App Wizard / @skill:setup-wizard |
| 기동 시간 초과 | Settings → Advanced → MCP Discovery Timeout 증가 |
| 이름 저장 거부 | builtin 예약 이름과 충돌 — 다른 Name 사용 |
| API 키 필요 프리셋 | Extensions 폼의 env / Required Configuration |
관련 문서
- Extensions로 MCP 설치하기 — 추천 프리셋 목록
- 5분 시작 가이드 — App Wizard
- 문제 해결