Docker MCP Toolkit 시작하기

Docker MCP Toolkit을 사용하면 컨테이너화된 Model Context Protocol(MCP) 서버를 프로필에 설정·관리·실행하고 AI 에이전트에 연결하기 쉬워져요. 보안 기본값과 성장하는 LLM 기반 클라이언트 생태계를 지원해요. 이 페이지에서는 Docker MCP Toolkit을 빠르게 시작하는 방법을 보여드려요.

출처: 문서

본문

가용성: Beta

참고: 이 페이지는 Docker Desktop 4.62 이상의 MCP Toolkit 인터페이스를 설명해요. 이전 버전은 다른 UI를 사용해요. 이 안내를 그대로 따라 하려면 업그레이드하세요.

설정(Setup)

시작하기 전에 Docker MCP Toolkit을 시작하기 위한 다음 요구 사항을 충족하는지 확인하세요.

최신 버전의 Docker Desktop을 다운로드하고 설치합니다.
Docker Desktop 설정을 열고 Beta features를 선택합니다.
Enable Docker MCP Toolkit을 선택합니다.
Apply를 선택합니다.

Docker Desktop의 Learning center는 Docker 제품과 기능을 시작하는 데 도움이 되는 워크스루와 리소스를 제공해요. MCP Toolkit 페이지의 Get started 워크스루가 MCP 서버 설치, 클라이언트 연결, 설정 테스트를 안내해 줘요.

또는 이 페이지의 단계별 안내를 따라 하세요:

프로필 만들기(Create a profile) — 서버를 구성하는 작업 공간
프로필에 MCP 서버 추가(Add MCP servers to your profile) — 카탈로그에서 도구 선택
클라이언트 연결(Connect clients) — AI 애플리케이션을 프로필에 연결
연결 확인(Verify connections) — 모든 게 잘 동작하는지 테스트

일단 구성하면 AI 애플리케이션이 프로필의 모든 서버를 사용할 수 있어요.

팁: 터미널에서 작업하는 걸 선호하나요? docker mcp 명령 사용법은 CLI로 MCP Toolkit 사용하기 문서를 참고해 주세요.

프로필 만들기

프로필은 MCP 서버를 모음으로 구성해요. 작업을 위한 프로필을 만들어 보세요:

참고: 이전 버전의 MCP Toolkit에서 업그레이드하는 경우, 기존 서버 구성이 이미 default 프로필에 있어요. 기본 프로필을 계속 사용하거나 다른 프로젝트를 위해 새 프로필을 만들 수 있어요.

Docker Desktop에서 MCP Toolkit을 선택하고 Profiles 탭을 선택합니다.
Create profile을 선택합니다.
프로필 이름을 입력합니다(예: "Frontend development").
선택 사항으로 이제 서버와 클라이언트를 추가하거나 나중에 추가합니다.
Create를 선택합니다.

새 프로필이 프로필 목록에 나타나요.

MCP 서버 추가

Docker Desktop에서 MCP Toolkit을 선택하고 Catalog 탭을 선택합니다.
카탈로그를 둘러보고 추가할 서버를 선택합니다.
Add to 버튼을 선택하고 서버를 기존 프로필에 추가할지 아니면 새 프로필을 만들지 선택합니다.

서버에 설정이 필요하면 서버 이름 옆에 Configuration Required 배지가 나타나요. 서버를 사용하려면 먼저 필수 구성을 완료해야 해요.

이제 프로필에 MCP 서버를 성공적으로 추가했어요. 다음으로 프로필의 서버를 사용하기 위해 MCP 클라이언트를 연결하세요.

클라이언트 연결

클라이언트를 MCP Toolkit에 연결하려면:

Docker Desktop에서 MCP Toolkit을 선택하고 Clients 탭을 선택합니다.
목록에서 애플리케이션을 찾습니다.
Connect를 선택해 클라이언트를 구성합니다.

클라이언트가 목록에 없으면, 클라이언트가 프로필로 게이트웨이를 실행하도록 구성해 stdio로 MCP Toolkit을 수동으로 연결할 수 있어요:

docker mcp gateway run --profile my_profile

예를 들어 클라이언트가 JSON 파일로 MCP 서버를 구성한다면 다음과 같은 항목을 추가할 수 있어요:

{
  "servers": {
    "MCP_DOCKER": {
      "command": "docker",
      "args": ["mcp", "gateway", "run", "--profile", "my_profile"],
      "type": "stdio"
    }
  }
}

MCP 서버를 수동으로 설정하는 방법은 사용 중인 애플리케이션의 문서를 확인하세요.

연결 확인

설정이 잘 동작하는지 확인하는 방법은 해당 섹션을 참고해 주세요: Claude Code, Claude Desktop, OpenAI Codex, Continue, Cursor, Gemini, Goose, LM Studio, OpenCode, Sema4.ai, Visual Studio Code, Zed, Mistral Vibe

Claude Code

특정 프로젝트를 위해 MCP Toolkit을 구성했다면 해당 프로젝트 디렉터리로 이동한 뒤 claude mcp list를 실행하세요. 출력에 MCP_DOCKER가 "connected" 상태로 보여야 해요:

$ claude mcp list
Checking MCP server health...
MCP_DOCKER: docker mcp gateway run - ✓ Connected

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

$ claude "Use the GitHub MCP server to show me my open pull requests"

Claude Desktop

Claude Desktop을 다시 시작하고 채팅 입력의 Search and tools 메뉴를 확인하세요. MCP_DOCKER 서버가 나열되고 활성화되어 있어야 해요.

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

Use the GitHub MCP server to show me my open pull requests

Codex

활성 MCP 서버와 그 상태를 보려면 codex mcp list를 실행하세요. 목록에 MCP_DOCKER 서버가 "enabled" 상태로 나타나야 해요:

$ codex mcp list
Name       Command  Args        Env  Cwd  Status   Auth
MCP_DOCKER docker   mcp gateway run  -    -    enabled  Unsupported

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

$ codex "Use the GitHub MCP server to show me my open pull requests"

Continue

cn을 실행해 Continue 터미널 UI를 시작하세요. /mcp 명령으로 활성 MCP 서버와 그 상태를 확인하세요. 목록에 MCP_DOCKER 서버가 "connected" 상태로 나타나야 해요:

 MCP Servers
➤ 🟢 MCP_DOCKER (🔧75 📝3)
🔄 Restart all servers
⏹️ Stop all servers
🔍 Explore MCP Servers
Back
↑/↓ to navigate, Enter to select, Esc to go back

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

$ cn "Use the GitHub MCP server to show me my open pull requests"

Cursor

Cursor를 엽니다. 특정 프로젝트를 위해 MCP Toolkit을 구성했다면 해당 프로젝트 디렉터리를 열고, Cursor Settings > Tools & MCP로 이동하세요. Installed MCP Servers 아래에 MCP_DOCKER가 보여야 해요.

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

Use the GitHub MCP server to show me my open pull requests

Gemini

활성 MCP 서버와 그 상태를 보려면 gemini mcp list를 실행하세요. 목록에 MCP_DOCKER가 "connected" 상태로 나타나야 해요.

$ gemini mcp list
Configured MCP servers:
✓ MCP_DOCKER: docker mcp gateway run (stdio) - Connected

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

$ gemini "Use the GitHub MCP server to show me my open pull requests"

Goose

데스크톱 앱: Goose 데스크톱 앱을 열고 사이드바에서 Extensions를 선택하세요. Enabled Extensions 아래에 Mcpdocker라는 확장이 보여야 해요.

CLI: goose info -v를 실행하고 확장 아래에서 mcpdocker라는 항목을 찾으세요. 상태가 enabled: true로 표시되어야 해요:

$ goose info -v
…
mcpdocker:
  args:
  - mcp
  - gateway
  - run
  available_tools: []
  bundled: null
  cmd: docker
  description: The Docker MCP Toolkit allows for easy configuration and consumption of MCP servers from the Docker MCP Catalog
  enabled: true
  env_keys: []
  envs: {}
  name: mcpdocker
  timeout: 300
  type: stdio

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

Use the GitHub MCP server to show me my open pull requests

LM Studio

LM Studio를 다시 시작하고 새 채팅을 시작하세요. 통합 메뉴를 열고 mcp/mcp-docker라는 항목을 찾으세요. 토글을 사용해 서버를 활성화하세요.

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

Use the GitHub MCP server to show me my open pull requests

OpenCode

OpenCode 구성 파일(기본적으로 ~/.config/opencode/opencode.json)에 MCP Toolkit 설정이 들어 있어요:

{
  "mcp": {
    "MCP_DOCKER": {
      "type": "local",
      "command": ["docker", "mcp", "gateway", "run"],
      "enabled": true
    }
  },
  "$schema": "https://opencode.ai/config.json"
}

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

$ opencode "Use the GitHub MCP server to show me my open pull requests"

Sema4.ai Studio

Sema4.ai Studio에서 사이드바의 Actions를 선택한 뒤 MCP Servers 탭을 선택하세요. 목록에 Docker MCP Toolkit이 보여야 해요.

Sema4.ai와 함께 MCP Toolkit을 사용하려면 에이전트 작업(agent action)으로 추가하세요. MCP Toolkit에 연결할 에이전트를 찾아 에이전트 편집기를 엽니다. Add Action을 선택하고 목록에서 Docker MCP Toolkit을 활성화한 뒤 에이전트를 저장하세요.

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

Use the GitHub MCP server to show me my open pull requests

Visual Studio Code

Visual Studio Code를 엽니다. 특정 프로젝트를 위해 MCP Toolkit을 구성했다면 해당 프로젝트 디렉터리를 열고 Extensions 창을 엽니다. 설치된 MCP 서버 아래에 MCP_DOCKER 서버가 나열되어 보여야 해요.

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

Use the GitHub MCP server to show me my open pull requests

Zed

Zed를 실행하고 에이전트 설정을 엽니다. MCP Servers 섹션에 MCP_DOCKER가 나열되고 활성화되어 있는지 확인하세요.

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

Use the GitHub MCP server to show me my open pull requests

Mistral Vibe

Mistral Vibe는 ~/.vibe/config.toml의 TOML 구성 파일을 사용해요. [[mcp_servers]] 섹션에 MCP Toolkit을 stdio MCP 서버로 추가하세요:

[[mcp_servers]]
name = "MCP_DOCKER"
transport = "stdio"
command = ["docker"]
args = ["mcp", "gateway", "run", "--profile", "my_profile"]
startup_timeout_sec = 60
disabled = false

Windows에서는 Docker 설치 경로(C:\Program Files\Docker\...)에 공백이 포함돼요. command에 docker.exe의 전체 경로를 리스트로 사용하고, MCP Python SDK가 기본적으로 상속하지 않는 PROGRAMFILES와 PROGRAMDATA 환경 변수를 추가하세요:

[[mcp_servers]]
name = "MCP_DOCKER"
transport = "stdio"
command = ["C:/Program Files/Docker/Docker/resources/bin/docker.exe"]
args = ["mcp", "gateway", "run", "--profile", "my_profile"]
env = { PROGRAMFILES = "C:\\Program Files", PROGRAMDATA = "C:\\ProgramData" }
startup_timeout_sec = 60
disabled = false

Docker MCP Gateway는 시작하는 데 약 15~25초가 걸리므로 startup_timeout_sec = 60을 권장해요. 기본 타임아웃은 10초로 게이트웨이가 초기화되기에는 부족해요.

Vibe를 다시 시작하세요. Vibe CLI 세션에서 /mcp를 실행해 활성 MCP 서버를 확인하세요. MCP_DOCKER 서버가 목록에 나타나야 해요:

$ vibe
> /mcp

설치된 MCP 서버 중 하나를 호출하는 프롬프트를 제출해 연결을 테스트하세요:

$ vibe "Use the GitHub MCP server to show me my open pull requests"

Docker MCP Toolkit 시작하기