setup-mcp-docker

Configure Docker MCP Toolkit gateway with HTTP transport for Claude Code integration.

3|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/gabrielnsmnto/kord-aios --skill setup-mcp-docker-gabrielnsmnto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-mcp-docker
Source: https://github.com/gabrielnsmnto/kord-aios/tree/main/src/features/builtin-skills/kord-aios/utilities/setup-mcp-docker
Command: npx skills add https://github.com/gabrielnsmnto/kord-aios --skill setup-mcp-docker-gabrielnsmnto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up MCP servers individually causes 30-second stdio timeouts and high token consumption; this Skill configures the Docker MCP Toolkit as a persistent HTTP gateway that routes tool calls to containerized MCP servers. ## Core Features & Use Cases - HTTP/SSE Gateway Setup: Runs the Docker MCP gateway as a persistent Docker Compose service on port 8080, avoiding stdio initialization timeouts. - Preset-Based MCP Selection: Installs a minimal preset (context7, desktop-commander, playwright) with no API keys, or a full preset adding exa web search with EXA_API_KEY. - Migration from 1MCP: Backs up existing Claude configuration, stops 1MCP, and replaces it with the docker-gateway HTTP entry in ~/.claude.json. - Use Case: A developer wants Claude Code to access filesystem, GitHub, and browser automation tools without per-server stdio processes; this Skill walks through Docker verification, MCP selection, credential configuration, and connection testing. ## Quick Start Set up the Docker MCP Toolkit gateway with the minimal preset and connect it to Claude Code over HTTP.

Frequently Asked Questions about setup-mcp-docker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Docker MCP Toolkit with Claude Code?▼

Run the gateway as a persistent service with docker compose or docker mcp gateway run --port 8080 --transport sse, then add an HTTP-type entry pointing to http://localhost:8080/mcp in ~/.claude.json. Restart Claude Code and verify with /mcp.

Why use HTTP transport instead of stdio for MCP gateway?▼

Stdio causes Claude Code to spawn the gateway at startup, hitting a 30-second timeout before initialization completes. HTTP transport connects to an already-running gateway, so the connection is immediate.

What MCPs are included in the minimal preset?▼

The minimal preset includes context7 for library documentation, desktop-commander for file management and terminal commands, and playwright for browser automation. None of these require API keys and they consume roughly 10-15k tokens.

Why are my Docker MCP API keys not reaching the container?▼

Docker MCP Toolkit's secrets store and template interpolation do not pass credentials to containers for MCPs with strict config schemas. The workaround is editing ~/.docker/mcp/catalogs/docker-mcp.yaml directly to hardcode env values.

How do I migrate from 1MCP to Docker MCP Toolkit?▼

Back up ~/.claude.json, stop the 1MCP process, remove its entries from the config, start the Docker gateway service, and add a single docker-gateway HTTP entry. Verify the gateway health endpoint before restarting Claude Code.