문서

MCP로 AI 클라이언트 연결

이 페이지의 내용

MCP를 통해 AI 클라이언트를 워크벤치에 연결한 다음, 카메라 제어를 넘기지 않고 워크플로를 한 번에 하나의 변경씩 반복 개선합니다.

MCP가 추가하는 기능

MCP(Model Context Protocol)를 사용하면 AI 클라이언트가 워크벤치에서 지원하는 도구를 호출할 수 있습니다. 워크플로 확인, 후보 제안, 실험 증거 읽기가 그 예입니다. 이는 동일한 태스크 서비스를 구동하는 두 번째 방법입니다. 카메라 드라이버, 새로운 이미지 엔진, 생산 환경 검증이 추가되는 것은 아닙니다.

질문	검토된 미리보기에서의 답변
클라이언트는 어디에서 실행됩니까?	Windows 워크스테이션에서 실행됩니다. 클라이언트가 로컬 태스크 서비스를 직접 시작하고 표준 입력/출력을 통해 통신합니다.
카메라를 변경합니까?	그것만으로는 변경하지 않습니다. 워크플로 읽기, 오프라인 실험 실행, 카메라 설정 쓰기는 각각 별개의 작업입니다. 카메라 측 튜닝에는 여전히 지원되는 장치 워크플로와 그 확인 절차가 필요합니다.
인터넷이 필요합니까?	아니요. 원격 MCP 액세스는 인증이 필요한 별도의 구성입니다. 권한, 보안 및 데이터를 참조하십시오.

연결하기 전에

설치 및 구성에 설명된 대로 Windows 워크벤치를 설치하고 시작한 다음, 오프라인 워크플로를 하나 실행하여 정상적인 결과가 어떤 모습인지 파악해 두십시오.
워크스테이션 밖으로 나가도 되는 데이터를 결정하십시오. 클라이언트는 수신한 도구 결과를 이미지 샘플을 포함하여 자체 공급자에게 전달합니다.
예상 답변이 레이블로 지정된 샘플 세트를 준비하십시오. 개발용 이미지는 고정된 검증 세트와 분리하여 보관하십시오.
먼저 데모(시뮬레이션) 서비스에 연결하도록 계획하십시오.

클라이언트 구성 내보내기

데스크탑 애플리케이션에서 튜닝 창을 열고 MCP 구성 내보내기를 사용합니다.
클라이언트 형식을 선택합니다. Claude는 JSON, Codex는 TOML입니다.
일반 서비스 또는 데모(시뮬레이션) 서비스를 선택합니다.
텍스트를 복사하거나 저장합니다. 권장 파일 이름은 deyivision-mcp입니다.

내보낸 항목의 이름은 deyivision입니다. 이 항목에는 설치된 태스크 서비스의 전체 경로, --mcp 인수(데모 서비스의 경우 --simulation이 추가됨), 그리고 세 개의 환경 변수 DEYIVISION_TUNING_INSTANCE, DEYIVISION_TUNING_DESKTOP_INSTANCE, DEYIVISION_TUNING_DATA가 들어 있습니다. 토큰, 카메라 자격 증명, 그 밖의 다른 환경 변수는 절대 포함되지 않습니다. 데모 서비스는 자체 데이터를 보관하므로 데모 항목에서는 데이터 폴더가 제외됩니다.

클라이언트에 등록하기

deyivision 항목을 클라이언트의 MCP 구성에 병합합니다. Claude는 JSON 파일의 mcpServers 객체, Codex는 TOML 파일입니다. 이 파일의 위치는 클라이언트와 그 버전에 따라 다르므로 클라이언트 자체 문서를 따르십시오.
클라이언트가 항목을 읽도록 클라이언트를 다시 시작합니다.
클라이언트에 DeYiVision 도구 목록을 표시하도록 요청합니다. 아무것도 나타나지 않으면 워크벤치에서 무엇이든 변경하기 전에 경로와 클라이언트 로그를 확인하십시오.
워크벤치를 이동하거나 다시 설치한 경우, 인스턴스를 변경한 경우, 데이터 루트를 변경한 경우에는 다시 내보내십시오. 항목에는 절대 경로가 저장됩니다.

첫 연결 확인

데모 서비스로 시작합니다. 도구 호출이 성공하면 클라이언트가 서비스를 실행하고 통신할 수 있다는 것이 입증됩니다. 그러나 카메라나 실제 이미지 검사는 실행되지 않으며, 데모 서비스는 장치 모드 데이터와 분리하여 자체 데이터를 보관합니다. 데모 서비스가 장치 모드 데이터 폴더를 가리키게 하지 마십시오. 두 서비스가 동일한 태스크 원장을 두고 경합하게 됩니다.

데모 호출이 정상적으로 동작한 후에만 일반 서비스로 전환합니다. 도구 목록이 표시된다고 해서 카메라가 연결되었다는 증거가 되지는 않습니다. 카메라 연결 및 영상 획득을 참조하십시오.

한 번에 하나씩 변경하며 반복하기

첫 실행 전에 샘플 세트와 예상 답변을 고정합니다.
클라이언트에 현재 워크플로 리비전과 최신 결과를 확인하도록 요청합니다. 리비전, 노드 설정, 입력 ID, 출력 또는 판정, 경과 시간, 불일치 사항이 있으면 함께 기록합니다.
변경하는 후보는 하나만 둡니다. 지원되는 노드 또는 매개변수 하나만 변경합니다. 후보를 제출하면 제안이 저장될 뿐 실행되지는 않습니다.
동일한 고정 이미지에서 후보를 실행합니다. 실행하면 태스크의 PC 평가판 예산이 소모됩니다. 새로운 카메라 노출이나 카메라 매개변수 쓰기가 아닙니다.
증거는 직접 검토합니다. 이미지, 출력, 버전, 실패 사례를 확인하십시오. 겉보기에 더 깨끗한 이미지라도 잘못된 판정이 나올 수 있습니다.
후보를 유지하거나 폐기한 다음 반복합니다. 그 사이에 사람이나 다른 클라이언트가 워크플로를 변경했다면, 먼저 최신 리비전과 담당자 검토를 읽으십시오. 오래된 초안으로 현재 리비전을 덮어써서는 안 되며, 오래된 검토 리비전에 연결된 후보는 거부됩니다.

리비전, 제출, 실행 컨트롤은 워크플로 만들기 및 실행을 참조하십시오.

사람이 계속 통제하는 항목

카메라 쓰기. MCP 클라이언트라도 작업 및 검사 결과에 설명된 통제를 우회할 수 없습니다. 카메라에 쓰려면 여전히 올바른 장치와 세션, 권한, 적격 상태, 기록된 기준 상태, 다시 읽기 검사가 필요합니다.
권한. 모델 액세스는 본질적으로 읽기 전용이 아닙니다. 인증된 모델이 쓰기 가능 도구를 가질 수 있습니다. 클라이언트를 연결하기 전에 클라이언트가 접근할 수 있는 범위를 결정하고, 연결 후에는 클라이언트가 수행한 작업을 검토하십시오.
알 수 없는 결과. 쓰기의 결과가 불확실하면 원래 요청 영수증을 읽으십시오. 새 요청 ID로 쓰기를 반복하지 마십시오.
승인. 저장된 이미지에 대한 오프라인 실험은 새 프레임이 생산 라인에서 어떻게 동작하는지 증명하지 않습니다. 운영상의 주장을 하기 전에 샘플과 승인 한계에 합의하십시오.

데이터 및 개인 정보

클라이언트는 도구가 반환하는 내용을 이미지 샘플을 포함하여 선택한 공급자에게 전송합니다. 먼저 수신자, 데이터 권리, 공급자의 정책을 검토하십시오. 요청 수준 저장소 기본 설정은 모든 다운스트림 당사자의 보존을 보장하지 않습니다.

내보낸 구성에는 로컬 경로와 폴더 이름만 들어 있습니다. 시작 출력에는 로컬 액세스 토큰이 포함될 수 있으므로 지원 메시지에 붙여 넣지 마십시오.

문제 해결

증상	확인 및 다음 단계
클라이언트에 DeYiVision 도구가 나열되지 않음	항목이 클라이언트의 실제 구성 파일에 병합되었는지 확인하고, 클라이언트를 다시 시작하고, 명령이 설치된 태스크 서비스 실행 파일을 가리키는지 확인합니다. 워크벤치를 이동한 경우 다시 내보내십시오.
서비스가 시작된 후 실패함	인스턴스 및 데이터 변수를 실행 중인 워크벤치와 비교합니다. 일치하는 쌍을 사용하고, 데모 서비스와 일반 서비스가 하나의 데이터 폴더를 공유하게 해서는 절대 안 됩니다.
작동하다가 재설치 또는 이동 후 중지됨	항목에는 절대 경로가 저장됩니다. 구성을 다시 내보내고 이전 항목을 교체하십시오.
후보가 오래되었다는 이유로 거부됨	최신 워크플로 리비전과 담당자 검토를 읽은 다음 변경을 다시 제안하십시오.
쓰기 결과를 알 수 없음	새 작업이 적절한지 판단하기 전에 원래 요청 영수증을 읽으십시오.

이 안내서의 한계

정확한 도구 목록과 도구 이름은 연결된 서비스에서 가져오며 빌드에 따라 달라질 수 있습니다. 클라이언트에 목록을 표시하도록 요청하십시오. 내보내기는 Claude(JSON) 및 Codex(TOML) 형식을 지원하며, 각 클라이언트 버전에서의 동작은 여기서 검증되지 않았습니다.

2026년 9월 23일, 격리된 Windows 빌드에서 수행한 엔지니어링 점검에서 원격 MCP 클라이언트를 통해 원본 이미지와 처리된 이미지를 가져왔습니다. 두 번의 실행 모두 NoRead(0/1)를 반환했습니다. 이 점검은 워크플로 인계, 리비전 관리, 증거 검색은 보여 주었지만, 바코드 판독률, 실제 카메라 호환성, 생산 안정성은 입증하지 못했습니다.