MCP 프로필
MCP 프로필
프로필은 MCP 서버를 이름 붙여진 모음으로 구성해요. 프로필이 없으면 사용하는 모든 AI 애플리케이션에 서버를 별도로 설정해야 해요. 어떤 서버를 사용할 수 있게 할지 바꿀 때마다 Claude Desktop, VS Code, Cursor 등 각 도구를 개별적으로 업데이트해야 하죠. 프로필은 서버 구성을 중앙 집중화해서 이 문제를 해결해 줘요.
출처: 문서
본문
가용성: Early Access
요구 사항: Docker Desktop 4.63 이상
프로필이 하는 일
프로필은 MCP 서버와 그 설정 및 세팅으로 이루어진 이름 붙여진 모음이에요. 사용 가능한 서버의 원천인 MCP 카탈로그에서 서버를 선택해 특정 작업을 위한 구성된 서버 모음인 프로필에 추가해요. 카탈로그를 도구 라이브러리로, 프로필을 여러 작업에 맞게 정리한 도구 상자로 생각하면 돼요.
"web-dev" 프로필에는 GitHub, Playwright, 데이터베이스 서버가 들어갈 수 있어요. "data-analysis" 프로필에는 스프레드시트, API, 시각화 서버가 들어갈 수 있죠. 서로 다른 AI 클라이언트를 서로 다른 프로필에 연결하거나, 작업이 바뀔 때마다 프로필을 전환할 수 있어요.
프로필을 지정하지 않고 MCP Gateway를 실행하거나 클라이언트를 연결하면 Docker MCP는 기본 프로필을 사용해요. 이전 버전의 MCP Toolkit에서 업그레이드하는 경우 기존 서버 구성이 이미 기본 프로필에 있어요.
프로필 기능
각 프로필은 서버와 구성의 자체 격리된 모음을 유지해요. "web-dev" 프로필에는 GitHub, Playwright, 데이터베이스 서버가, "data-analysis" 프로필에는 스프레드시트, API, 시각화 서버가 들어갈 수 있어요. 필요에 따라 원하는 만큼 프로필을 만들 수 있고, 각 프로필에는 그 컨텍스트에 관련된 서버만 넣을 수 있어요.
참고: OAuth 자격 증명은 프로필 격리의 예외로, 모든 프로필에서 공유돼요. 다른 프로젝트에 다른 계정을 사용해야 한다면 프로필을 전환할 때 자격 증명을 취소하고 다시 승인해야 해요.
서로 다른 AI 애플리케이션을 서로 다른 프로필에 연결할 수 있어요. 클라이언트를 연결할 때 어떤 프로필을 사용할지 지정해요. 필요한 경우 Claude Desktop과 VS Code가 서로 다른 서버 모음에 접근할 수 있다는 뜻이에요.
프로필은 팀과 공유할 수 있어요. 프로필을 레지스트리에 푸시하면 팀원이 풀해서 당신이 사용하는 것과 똑같은 서버 모음과 구성을 얻을 수 있어요.
프로필 만들기와 관리
프로필 만들기
- Docker Desktop에서 MCP Toolkit을 선택하고 Profiles 탭을 선택합니다.
- Create profile을 선택합니다.
- 프로필 이름을 입력합니다(예: "web-dev").
- 선택 사항으로 지금 서버를 검색해 추가하거나 나중에 추가합니다.
- 선택 사항으로 프로필에 연결할 클라이언트를 검색해 추가합니다.
- Create를 선택합니다.
새 프로필이 프로필 목록에 나타나요.
프로필 세부 정보 보기
Profiles 탭에서 프로필을 선택하면 세부 정보를 볼 수 있어요. 프로필 뷰에는 두 개의 탭이 있어요:
- Overview: 프로필의 서버, 비밀 구성, 연결된 클라이언트를 보여줘요. + 버튼으로 서버나 클라이언트를 더 추가할 수 있어요.
- Tools: 프로필의 서버에서 사용 가능한 모든 도구를 나열해요. 개별 도구를 활성화하거나 비활성화할 수 있어요.
프로필 제거
- Profiles 탭에서 제거할 프로필을 찾습니다.
- 프로필 이름 옆의 ⋮를 선택하고 Delete를 선택합니다.
- 제거를 확인합니다.
주의: 프로필을 제거하면 그 프로필의 모든 서버 설정과 세팅이 삭제되고, 클라이언트 구성도 업데이트됩니다(MCP Toolkit 제거). 이 작업은 되돌릴 수 없어요.
기본 프로필
프로필을 지정하지 않고 MCP Gateway를 실행하거나 MCP Toolkit을 사용하면 Docker MCP는 default라는 이름의 프로필을 사용해요. default 프로필이 없다면 빈 구성을 사용해요.
이전 버전의 MCP Toolkit에서 업그레이드하는 경우 기존 서버 구성이 자동으로 default 프로필로 마이그레이션돼요. 설정을 수동으로 다시 만들 필요 없이 모든 게 이전처럼 계속 동작해요.
게이트웨이 명령에서 --profile 플래그로 항상 다른 프로필을 지정할 수 있어요:
$ docker mcp gateway run --profile web-dev
프로필에 서버 추가
프로필에는 카탈로그에서 선택한 MCP 서버가 들어 있어요. 특정 워크플로를 위해 도구를 구성하려면 서버를 추가하세요.
서버 추가
프로필에 서버를 추가하는 방법은 두 가지예요.
Catalog 탭에서:
- Catalog 탭을 선택합니다.
- 추가할 서버 옆의 체크박스를 선택해 어떤 프로필에 추가할지 지정합니다.
- 드롭다운에서 프로필을 선택합니다.
프로필 안에서:
- Profiles 탭을 선택하고 프로필을 선택합니다.
- Servers 섹션에서 + 버튼을 선택합니다.
- 추가할 서버를 검색하고 선택합니다.
서버에 OAuth 인증이 필요하면 승인하라는 안내가 나와요. 자세한 내용은 OAuth 인증 문서를 참고해 주세요.
프로필의 서버 목록 보기
Profiles 탭에서 프로필을 선택하면 포함된 모든 서버를 볼 수 있어요.
서버 제거
- Profiles 탭을 선택하고 프로필을 선택합니다.
- Servers 섹션에서 제거할 서버를 찾습니다.
- 서버 옆의 삭제 아이콘을 선택합니다.
프로필 구성
서버 구성
일부 서버는 인증 외에 추가 구성이 필요해요. 프로필 안에서 서버 설정을 구성하세요.
- Profiles 탭을 선택하고 프로필을 선택합니다.
- Servers 섹션에서 서버 옆의 구성 아이콘을 선택합니다.
- 필요에 따라 서버의 구성 설정을 조정합니다.
OAuth 자격 증명
OAuth 자격 증명은 모든 프로필에서 공유돼요. GitHub나 Notion 같은 서비스에 대한 접근을 승인하면 그 승인은 어떤 프로필의 서버든 필요로 하는 모든 서버에서 사용할 수 있어요.
즉 모든 프로필이 특정 서비스에 대해 같은 OAuth 자격 증명을 사용해요. 다른 프로젝트에 다른 계정을 사용해야 한다면 프로필을 전환할 때마다 자격 증명을 취소하고 다시 승인해야 해요.
서버 승인에 대한 자세한 내용은 OAuth 인증 문서를 참고해 주세요.
구성 지속성(Configuration persistence)
프로필 구성은 Docker 설치에 영구 저장돼요. Docker Desktop이나 시스템을 다시 시작해도 프로필, 서버, 구성이 그대로 유지돼요.
프로필 공유
프로필은 OCI 호환 레지스트리에 아티팩트로 푸시해 팀과 공유할 수 있어요. 조직 전체에 표준화된 MCP 설정을 배포할 때 유용해요. 보안상의 이유로 공유 프로필에는 자격 증명이 포함되지 않아요. 팀원은 풀한 뒤 OAuth를 별도로 구성해요.
프로필 푸시
- Profiles 탭에서 공유할 프로필을 선택합니다.
- Push to Registry를 선택합니다.
- 레지스트리 대상을 입력합니다(예:
registry.example.com/profiles/web-dev:v1). - 필요하면 인증을 완료합니다.
프로필 풀
- Profiles 탭에서 Pull from Registry를 선택합니다.
- 레지스트리 참조를 입력합니다(예:
registry.example.com/profiles/team-standard:latest). - 필요하면 인증을 완료합니다.
프로필이 다운로드되어 프로필 목록에 추가돼요. 필수 OAuth 자격 증명은 별도로 구성하세요.
팀 협업 워크플로
팀 전체에서 프로필을 공유하는 전형적인 워크플로:
- 팀이 필요한 서버로 프로필을 만들고 구성한다.
- 예상대로 동작하는지 프로필을 테스트한다.
- 버전 태그로 프로필을 팀의 레지스트리에 푸시한다(예:
registry.example.com/profiles/team-dev:v1). - 레지스트리 참조를 팀과 공유한다.
- 팀원이 프로필을 풀하고 필요한 OAuth 자격 증명을 구성한다.
이렇게 하면 모든 사람이 같은 서버 모음과 구성을 사용하게 되어 설정 시간과 불일치가 줄어들어요.
클라이언트와 함께 프로필 사용
AI 클라이언트를 MCP Gateway에 연결할 때 클라이언트가 접근할 수 있는 프로필의 서버를 지정해요.
프로필로 게이트웨이 실행
MCP Toolkit의 Clients 섹션을 통해 클라이언트를 프로필에 연결하세요. 프로필을 만들 때 클라이언트를 추가하거나 나중에 기존 프로필에 추가할 수 있어요.
특정 프로필용 클라이언트 구성
클라이언트를 수동으로 설정할 때 클라이언트가 사용할 프로필을 지정할 수 있어요. 이렇게 하면 서로 다른 클라이언트가 서로 다른 프로필에 연결될 수 있어요.
예를 들어 Claude Desktop 구성은 이렇게 사용할 수 있어요:
{
"mcpServers": {
"MCP_DOCKER": {
"command": "docker",
"args": ["mcp", "gateway", "run", "--profile", "claude-work"]
}
}
}
반면 VS Code 구성은 다른 프로필을 사용해요:
{
"mcp": {
"servers": {
"MCP_DOCKER": {
"command": "docker",
"args": ["mcp", "gateway", "run", "--profile", "vscode-dev"],
"type": "stdio"
}
}
}
}
프로필 전환
클라이언트가 사용하는 프로필을 바꾸려면 게이트웨이 명령 인자의 --profile 값을 다르게 지정하도록 클라이언트 구성을 업데이트하세요.
더 보기
- MCP Toolkit 시작하기
- CLI로 MCP Toolkit 사용하기
- MCP 카탈로그
- MCP Toolkit