MCP 서버 실전 가이드

과도한 권한: 작업에 필요한 최소 도구만 부여하고, 사용하지 않는 파괴적 도구는 제거합니다.
불안정한 셀렉터: 마크업이 바뀌면 UI 자동화가 깨집니다——각 동작 후 상태를 검증하도록 에이전트에 지시합니다.
긴 도구 체인: 한 번에 하나의 논리적 단계만 요청하여 여러 도구 워크플로에 대한 통제를 유지합니다.

MCP(Model Context Protocol) 서버를 연결하여 OpenCode에 실제 세계의 능력을 부여합니다——에이전트에서 직접 데이터베이스를 조회하고, 브라우저를 조종하고, 외부 API를 호출할 수 있습니다.

이 레시피를 사용하는 경우

MCP 서버 설정 추가

OpenCode 설정에 서버를 등록합니다.

{
  "mcp": {
    "playwright": {
      "type": "local",
      "command": ["npx", "@playwright/mcp@latest"]
    }
  }
}

도구 로드 확인

OpenCode를 시작하고 사용 가능한 도구 목록을 요청합니다——서버의 도구(예: browser_navigate, browser_click)가 보여야 합니다.
목표가 있는 작업 정의

스테이징 사이트를 열고, 테스트 계정으로 로그인하고, 설정으로 이동한 뒤 새 토글이 보이는지 알려주세요.
도구 호출 감독

각 도구 호출을 관찰합니다. 민감한 동작(쓰기, 삭제)은 승인하고 예상치 못한 것은 거부합니다.
결과로 반복

에이전트가 페이지를 잘못 읽으면 올바른 셀렉터를 알려주거나 먼저 DOM을 덤프하게 합니다.

playwright MCP 서버를 사용해 [URL]을 열고, 로그인 흐름을 수행한 뒤, 설정에 “데이터 내보내기” 버튼이 있는지 확인하세요. 각 단계에서 본 것을 보고하세요.