#

도구 이름

매개변수

설명

1

get_webhook_urls

_dummy=""

사용 가능한 모든 localhost, LAN 및 공개 Cloudflare 캡처 URL을 반환합니다.

2

start_tunnel

port="4040"

포트 4040을 공개적으로 노출하도록 임시 Cloudflare Quick Tunnel을 시작합니다.

3

stop_tunnel

_dummy=""

Cloudflare 터널 하위 프로세스를 종료합니다.

4

get_tunnel_status

_dummy=""

활성 터널 URL, 상태 및 업타임을 반환합니다.

5

list_requests

limit="20", method="", path_filter=""

캡처된 요청을 메타데이터와 함께 요약합니다.

6

get_request_details

request_id="<uuid>"

요청 ID의 전체 헤더, 파싱된/원본 본문 및 클라이언트 IP를 가져옵니다.

7

wait_for_request

timeout_seconds="30", path_contains="", method="", body_contains=""

제한 시간 내에 수신 요청이 경로, 메서드 또는 본문과 일치할 때까지 폴링합니다.

8

configure_mock_response

status_code="200", content_type="application/json", response_body="{...}", delay_ms="0", custom_headers_json="{}"

동적 HTTP 상태, 콘텐츠 유형, 본문, 지연 시간 및 사용자 지정 헤더를 설정합니다.

9

reset_mock_response

_dummy=""

mock 엔진을 기본값인 200 OK JSON으로 재설정합니다.

10

clear_requests

_dummy=""

캡처된 요청의 인메모리 링 버퍼를 비웁니다.

11

delete_request

request_id="<uuid>"

ID를 기준으로 단일 요청 레코드를 제거합니다.

12

replay_request

target_url, method="GET", headers_json="{}", body="", timeout_seconds="10"

모든 대상 URL에 HTTP 요청을 전송하고 응답을 캡처합니다.

13

get_server_status

_dummy=""

서버 상태, 활성 포트, 업타임 및 캡처된 요청 수를 반환합니다.

증상

원인

해결 방법

docker mcp catalog import not recognized

Docker Desktop 4.40+에서 제거된 명령어

대신 docker mcp profile server add default --server file://... 사용

docker mcp server enable not recognized

Docker Desktop 4.40+에서 제거된 명령어

docker mcp profile server add로 대체됨

docker mcp client connect fails: missing flag

이제 --profile이 필수

docker mcp client connect claude-desktop --global --profile default 사용

Claude에서 도구가 표시되지 않음

프로세스가 잘못된 Docker 컨텍스트 사용

--context desktop-linux 인수를 docker run에 추가

"gateway panic" / 도구가 사라짐

여러 줄 tool docstring

모든 @mcp.tool() docstring을 정확히 한 줄로 유지

4000/4040 포트 충돌

포트가 이미 사용 중

환경 변수에 WEBHOOK_PORT=4041 설정

도구에 "가 표시됨"

이전 세션의 캐시

Claude Desktop을 재시작하고 새 대화를 시작