Connected 표시만으로 에이전트가 브라우저를 쓸 수 있는지 알 수 없습니다. 처음으로 빠진 결과를 찾으세요. 서버 초기화, 클라이언트 도구 제공, 권한, 페이지 결과를 차례대로 확인합니다.
1. 서버가 시작되고 초기화됐나요?
첫 시작 또는 협상 오류를 확인하세요. stdio에서는 클라이언트 실행 환경에서 명령을 찾을 수 있어야 합니다. 원격이라면 승인된 엔드포인트, 전송 및 인증을 확인합니다. 일부러 없는 명령을 실행하자 FileNotFoundError, errno 2가 발생했고 initialize 결과가 없었습니다.
2. 클라이언트에 도구가 보이나요?
원본 tools/list와 현재 세션 도구를 비교하세요. 서버가 빈 목록을 준 경우와 클라이언트가 걸러 낸 경우는 다릅니다. 스키마, 모드, 탐색 완료 여부를 확인합니다. Playwright MCP 0.0.84는 browser_navigate를 포함해 25개를 반환했습니다. 진단용 필터 적용 후 0개였습니다. 기본 동작은 아닙니다.
MCP · Tools VS Code · MCP servers
3. 브라우저와 대상이 허용됐나요?
워크스페이스 정책, 브라우저와 프로필, 오리진과 동작 권한을 확인합니다. 테스트에서 Playwright 라우팅 필터가 목록에 없는 로컬 오리진을 차단해 net::ERR_BLOCKED_BY_CLIENT를 반환했습니다. 대상 서버의 요청은 0건입니다. 앱의 라우팅 필터와 관리 및 네트워크 제어는 별개입니다.
Playwright MCP · Configuration
4. 에이전트가 실제로 도구를 호출했나요?
기록에서 tools/call을 찾습니다. 계획이나 텍스트로 실행을 증명할 수 없습니다. 스크립트를 탐색 단계에서 멈추면 호출은 0회였습니다. 이후 허용된 오리진에 browser_navigate와 browser_snapshot을 호출해 J01-FIXTURE를 확인했습니다. 모델은 실행하지 않았습니다. 실제 세션에서는 모드와 모델의 도구 지원을 확인하고 도구, URL, 읽기 결과를 명시하세요.
| 단계 | 예상 결과 |
|---|---|
| initialize | FileNotFoundError · errno 2 |
| tools/list | 25 → 0 |
| Origin filter | ERR_BLOCKED_BY_CLIENT · 0 requests |
| tools/call | 0 → J01-FIXTURE |
최소 작업으로 확인하기
승인된 페이지를 열고 최종 URL, 제목과 알려진 표식을 반환하도록 요청합니다. 응답과 도구 결과를 대조하세요. 직접 호출은 되는데 모델이 건너뛰면 도구 선택과 승인 기록을 확인합니다. 실패했다면 도구 이름과 구조화된 오류를 보존하세요.
| 도구 | 예상 결과 |
|---|---|
browser_navigate | URL · title |
browser_snapshot | J01-FIXTURE |
사용자가 보고한 사례
r/mcp에서는 stdio 연결 후 tools/list가 시간 초과된 사례가 있었습니다. r/ClaudeAI에서는 같은 커넥터가 Chat에서 작동하지만 Code에서 도구가 없다는 사례가 있었습니다. 환경이 다르므로 프로토콜과 세션을 모두 점검하세요.
Connected면 브라우저를 쓸 수 있나요?
서버 연결만 표시할 수 있습니다. 현재 세션의 도구, 승인된 호출과 페이지 결과를 각각 확인하세요.
자주 묻는 질문
Connected면 브라우저를 쓸 수 있나요?
서버 연결만 표시할 수 있습니다. 현재 세션의 도구, 승인된 호출과 페이지 결과를 각각 확인하세요.
초기화를 어떻게 확인하나요?
첫 시작 또는 협상 오류를 확인하세요. stdio에서는 클라이언트 실행 환경에서 명령을 찾을 수 있어야 합니다. 원격이라면 승인된 엔드포인트, 전송 및 인증을 확인합니다. 일부러 없는 명령을 실행하자 FileNotFoundError, errno 2가 발생했고 initialize 결과가 없었습니다.
왜 도구가 0개로 표시되나요?
원본 tools/list와 현재 세션 도구를 비교하세요. 서버가 빈 목록을 준 경우와 클라이언트가 걸러 낸 경우는 다릅니다. 스키마, 모드, 탐색 완료 여부를 확인합니다. Playwright MCP 0.0.84는 browser_navigate를 포함해 25개를 반환했습니다. 진단용 필터 적용 후 0개였습니다. 기본 동작은 아닙니다.
권한을 어떻게 확인하나요?
워크스페이스 정책, 브라우저와 프로필, 오리진과 동작 권한을 확인합니다. 테스트에서 Playwright 라우팅 필터가 목록에 없는 로컬 오리진을 차단해 net::ERR_BLOCKED_BY_CLIENT를 반환했습니다. 대상 서버의 요청은 0건입니다. 앱의 라우팅 필터와 관리 및 네트워크 제어는 별개입니다.
도구가 실제 실행됐는지 어떻게 아나요?
기록에서 tools/call을 찾습니다. 계획이나 텍스트로 실행을 증명할 수 없습니다. 스크립트를 탐색 단계에서 멈추면 호출은 0회였습니다. 이후 허용된 오리진에 browser_navigate와 browser_snapshot을 호출해 J01-FIXTURE를 확인했습니다. 모델은 실행하지 않았습니다. 실제 세션에서는 모드와 모델의 도구 지원을 확인하고 도구, URL, 읽기 결과를 명시하세요.