mcp-setup

MCP server setup and troubleshooting

설치 방법

기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.

npx skills add https://github.com/AxGord/claude-workflow --skill mcp-setup

명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.

로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.

설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.

SKILL.md

소스 지침 · 읽기 전용 미리보기

name	mcp-setup
description	MCP server setup and troubleshooting

NEVER guess package names → npm info <name> to verify before installing
Validate before adding → npm info → npx -y <pkg> --help → claude mcp add. Caveat: many MCP servers don't implement --help and just wait on stdio — wrap validation in timeout 10 … so it can't hang.
Think UX upfront → headless mode, timeouts, flags — ask user BEFORE installing
Restarts: /mcp can reconnect already-registered servers, but registering a NEW server requires a session restart. Get the config right the first time.

Python servers: claude mcp add <name> -- uvx <pkg> — uvx launches PyPI packages over stdio, no venv management.
Remote servers: claude mcp add --transport http <name> <url> (also --transport sse for legacy SSE servers).
Scopes: project scope lives in .mcp.json at the repo root (checked in); local scope lives in ~/.claude.json under that project's entry (NOT in the repo); user scope is global in ~/.claude.json.
Plugin-bundled servers get tool names mcp__plugin_<plugin>_<server>__<tool> — the full name must stay under the 64-char API limit, so keep plugin/server names short.

"Browser is already in use … use --isolated" = the persistent Chrome profile (~/Library/Caches/ms-playwright-mcp/mcp-chrome-* on macOS, ~/.cache/ms-playwright-mcp/mcp-chrome-* on Linux) is locked by a stale SingletonLock symlink (often pointing at an unrelated regular Chrome pid). The MCP server refuses even after browser_close.
Fix without killing the user's Chrome: if more than one browser MCP server is configured, each has its own profile — switch to the other server rather than killing the pid the lock points at (it may be the user's real browser). Stay with ONE browser server per session; alternating between two hits the lock again.