MCP 연결 및 문제 해결

Remote MCP는 https://pixso.net/mcp와 OAuth를 설정하고 대상 레이어 링크를 제공합니다. Local MCP는 Pixso 데스크톱을 실행하고 대상 파일을 활성 상태로 유지합니다. 사용하는 연결 방식에 맞게 다음 항목을 확인합니다.

Pixso MCP로 무엇에 접근할 수 있나요?

MCP 도구는 디자인 노드, 스타일, 변수와 컴포넌트를 읽고 스크린샷을 캡처하며 디자인을 코드로 변환하거나 편집하는 작업을 지원합니다. 읽기 도구와 쓰기 도구의 조건은 다릅니다. 지원하는 작업과 권한은 영문 도구 및 명령 참조를 참고합니다.

연결했지만 디자인을 읽을 수 없어요

1. 인증한 계정으로 Pixso 파일을 열어 접근 가능한지 확인합니다.
2. Remote MCP에는 노드 정보가 포함된 레이어 또는 프레임 링크를 제공합니다.
3. 계정의 라이선스 유형과 파일 권한을 확인합니다. 쓰기 작업에는 편집 권한이 필요합니다.
4. Local MCP는 대상 파일 탭을 활성 상태로 유지합니다. 현재 선택 영역을 사용하는 작업이면 해당 레이어를 선택합니다.

코드 생성이 실패하거나 결과 조정이 필요해요

D2C⁺에는 영문 D2C⁺ 빠른 시작 가이드의 기업 라이선스 유형과 공간 조건이 적용됩니다. 접근 조건을 충족하면 범위가 명확한 페이지나 프레임을 선택하고 대상 프레임워크와 컴포넌트 라이브러리를 지정합니다. 복잡한 디자인은 작은 영역으로 나누어 처리한 뒤 레이아웃, 텍스트, 에셋과 상호작용 상태를 원본과 비교합니다.

에이전트에 MCP 메뉴가 없거나 연결되지 않아요

Streamable HTTP를 지원하는 에이전트 버전을 사용합니다. 해당 클라이언트의 설정 형식을 따르고 인증을 완료합니다. Remote MCP는 OAuth와 개인 접근 토큰을 지원합니다. 토큰을 공개 저장소, 스크린샷이나 공유 프롬프트에 포함하지 않습니다. 프라이빗 배포 환경은 자체 서비스 URL을 사용합니다.

Pixso 데스크톱에 MCP 메뉴가 없어요

Remote MCP는 에이전트에서 설정하므로 데스크톱 진입점이 필요하지 않습니다. Local MCP는 Pixso 데스크톱을 2.2.0 이상으로 업데이트하고 디자인 파일을 연 뒤 왼쪽 위의 MCP 설정을 사용합니다.

Local MCP를 켰지만 호출이 실패해요

Pixso에 표시된 현재 서비스 주소를 복사합니다. 포트가 3667과 다를 수 있습니다. SSE가 아니라 HTTP / Streamable HTTP를 사용합니다. 포트 충돌을 줄이도록 로컬 MCP 제공자를 하나만 활성화하고 대상 파일을 열어 활성 상태로 유지합니다. 전체 절차는 영문 Local MCP 가이드를 참고합니다.