Galpi
스킬과 MCP
스킬은 에이전트가 읽는 안내와 명령의 묶음이고, MCP 연결은 채팅에 붙이는 외부 도구예요. 둘 다 시스템·프로젝트·개인 단계로 켜요.
스킬
스킬은 파일 묶음이에요. SKILL.md가 있어야 하고(frontmatter의 name이 slug와 같아야 해요), skill.json(필요한 연동, 설정 항목)과 bin/*(VM에서 PATH에 오르는 명령)은 있어도 돼요.
my-skill/
├── SKILL.md # 에이전트가 읽는 안내. frontmatter의 name이 slug
├── skill.json # 선택: 필요한 연동, 설정 항목
└── bin/
└── my-command # 선택: VM의 PATH에 오르는 명령


- 스킬 저장소: 계정 메뉴의 스킬 저장소에서 올리고 찾아요. 로그인한 누구나 만들 수 있어요. 공개 스킬은 모두의 목록에 보이고, 비공개 스킬은 만든 사람이 관리자인 프로젝트에서만 켤 수 있어요.
- 프로젝트 스킬: 프로젝트 관리자가 프로젝트 관리 → 스킬에서 켜면 그 프로젝트의 모든 채팅에 들어가요.
- 내 스킬: 각자 스킬 저장소에서 자기 채팅에만 켜요. 프로젝트 관리자가 "개인 스킬 쓰기"를 막으면 그 프로젝트에서는 빠져요.
- 기본 스킬 Plane: 모든 프로젝트에서 켜진 채로 시작하고, 프로젝트가 Plane에 연결돼 있으면 채팅에 들어가요. 무엇을 할 수 있는지는 서버의 Plane 규칙이 정해요.
- 버전은 고정돼요. 프로젝트는 켤 때의 버전을 써요. 작성자가 새 버전을 올려도 관리자가 업데이트를 누르기 전에는 바뀌지 않아요.
- 설정: 파일 안의
{{settings.KEY}}를 바꿔요.{{project.name}},{{repo.url}},{{proxies.<이름>.url}}도 쓸 수 있어요. 비밀값은 설정에 넣지 말고 프록시로 불러요. galpi-로 시작하는 이름은 갈피가 써요(galpi-push스킬,galpi-secret·galpi-port명령).bin/opencode,bin/git처럼 VM이 쓰는 명령 이름은 받지 않아요.- 스킬을 끄거나 버전·설정을 바꾸면 열린 채팅도 다음 질문부터 바뀌어요.
예시는 갈피 저장소의 examples/skills/(예: ci-history, Woodpecker 조회)에 있어요. 스킬 저장소 화면에서 올려 써요.
MCP 연결
원격 MCP 서버(Streamable HTTP)를 채팅에 붙여요. 모든 호출은 갈피 서버를 거쳐요. VM에서 임의 stdio 명령을 돌리는 연결은 없어요.
| 단계 | 만드는 곳 | 채팅에 들어가는 방법 |
|---|---|---|
| 시스템 | 시스템 관리 → MCP | 프로젝트 관리자가 갈피 공용 연결에서 켜면 그 프로젝트의 채팅에, 각자 스킬 저장소 → 서비스 연결에서 켜면 그 사람의 채팅에. 모든 채팅에 필수로 두면 모든 채팅에 |
| 프로젝트 | 프로젝트 관리 → 고급 → MCP | 그 프로젝트 모든 멤버의 채팅에 |
| 개인 | 스킬 저장소 → 서비스 연결 → 내가 추가한 연결 | 그 사람의 채팅에만. 시스템 관리자가 각자 MCP 주소 추가하기를 켰을 때만(기본 꺼짐) |


- 인증: 없음, 공용 Bearer 토큰, 공용 API 키 헤더, 사람마다의 OAuth(PKCE, 서버가 지원하면 동적 등록) 중에서 골라요. 시스템 연결에는 **사용자 확인(서명)**도 있어요: 갈피 서버가 채팅 주인이 누구인지 서명해서 보내고, 나루 toolset이 이렇게 받아요. 로그인은 연결에 묶여서, 시스템 연결에 한 번 로그인하면 그 연결을 쓰는 모든 프로젝트에서 같아요.
- 사내 인증서: 사내 CA를 믿게 하거나 공개키를 고정(pin)할 수 있어요.
- 한 채팅에는 Mothership 필수 연결, 연동 서비스 연결, 시스템 필수 연결, 프로젝트 연결, 프로젝트가 켠 시스템 연결, 채팅 주인이 켠 연결 순서로 들어가요. 같은 연결은 한 번만이에요.
- 시스템 연결의 전체 주소는 시스템 관리자에게만 보여요(경로에 키가 들어가는 서비스가 있어서요).


연동 서비스
나루처럼 manifest(/.well-known/galpi-provider.json) 하나로 프로젝트에 붙는 서비스예요. 시스템 관리자가 시스템 관리 → 연동 서비스에 주소를 올리면, 프로젝트 관리자가 프로젝트 관리 → 연동 서비스에서 잇고, 필수 MCP·스킬·커밋 제출을 받아요. → 제품 잇기

