Extentos MCP

공식

Extentos는 기존 iOS 및 Android 앱에 스마트 글래스 기능을 추가하기 위한 멀티 벤더 개발 플랫폼입니다. 가장 간단한 비유는 스마트 글래스를 위한 Stripe입니다.

extentos.com에서 보기

Extentos MCP(으)로 무엇을 할 수 있나요?

플랫폼 기능 및 SDK 특징 살펴보기 — 코드를 작성하기 전에 getPlatformInfo를 호출하여 Meta Ray-Ban 기능, 라이브러리 버전 및 공급업체 등급의 전체 목록을 검색하세요.
표준 코드 예제 및 사용 가이드 확인하기 — getCodeExample 및 getCapabilityGuide를 사용하여 음성 어시스턴트, 디스플레이 상호작용, 전사 및 기타 SDK 기본 요소에 대한 Kotlin/Swift 패턴을 확인하세요.
완전한 연결 모듈 구축하기 — generateConnectionModule을 실행하여 Gradle/SPM 연결, 권한, 매니페스트 항목 및 Extentos 연결 페이지를 네이티브 프로젝트에 부트스트랩하세요.
테스트 전 프로젝트 정확성 검증하기 — validateIntegration을 호출하여 매니페스트 선언, 종속성 버전, 권한 범위 및 선언된 기능에 대한 부트스트랩 호출을 확인하세요.
시뮬레이터 세션 프로비저닝 및 실행하기 — createSimulatorSession을 호출하여 브라우저 기반 세션을 생성한 다음, injectTranscript, assertToolCalled 및 getEventLog를 사용하여 사람 없이 에이전트 기반 종단 간 테스트를 실행하세요.
프로덕션 준비 상태 감사하기 — getProductionChecklist 및 getCredentialGuide를 실행하여 출시 전에 자격 증명 연결, 포그라운드 서비스 요구 사항 및 스토어 등록 준비 상태를 확인하세요.

문서

MCP 서버

Extentos MCP 서버(@extentos/mcp-server\)는 AI 에이전트(Claude Code, Cursor, Windsurf, Cline)가 한 번 설치한 후 네이티브 iOS 또는 Android 앱에 Meta Ray-Ban 스마트 글래스 기능을 추가하는 데 사용하는 npm 패키지입니다. 이 서버는 검색, 생성, 에이전트 구성, 자격 증명, 분석, 안내, 유효성 검사, 시뮬레이션, 프로덕션 준비, 문서화 등 10개 카테고리에 걸쳐 긴밀하게 정의된 결정적 도구 세트와 계정 연결, 원격 측정 동의, 업데이트 확인을 위한 CLI를 제공합니다. 이것은 에이전트의 운영 매뉴얼입니다.

MCP 서버는 AI 에이전트(Claude Code, Cursor, Windsurf, Cline 또는 모든 Model Context Protocol 호환 호스트)가 Extentos를 작동하는 방식입니다. 에이전트는 결정적 도구를 호출하고, 서버는 글래스가 노출하는 기능을 에이전트에게 알려주며, Kotlin 및 Swift로 된 표준 SDK 코드 패턴을 반환하고, 프로젝트를 스캐폴딩하며, 시뮬레이터 세션을 중개하고, 디버깅 추적을 쿼리합니다. 서버 자체에는 계획 도구가 없습니다 — 에이전트가 정규식 묶음보다 더 나은 계획자입니다. 도구는 에이전트가 순차적으로 구성하는 유형화된 기본 요소입니다.

이 페이지는 섹션 랜딩 페이지로, 서버의 정의, 도구 개요, 표준 에이전트 주도 흐름, 구성 설정, CLI, 인증 모델 작동 방식을 다룹니다. 하위 페이지에서는 각 항목을 심층적으로 다룹니다.

설치

claude mcp add extentos -- npx -y @extentos/mcp-server@latest

Claude Code가 아닌 호스트의 경우 에이전트 프롬프트 또는 수동 JSON 설치 경로를 참조하세요. 전체 설치 참조는 /docs/mcp-server/install에서 확인할 수 있습니다.

카테고리별 도구

서버는 10개 카테고리로 구성된 결정적 도구 표면(mcp-server/src/tools/definitions.ts에서 검증됨)을 노출합니다. 카테고리는 에이전트의 심적 지도이며, 도구가 어떤 카테고리에 속하는지 이해하는 에이전트는 언제 호출할지 결정할 수 있습니다. 항상 최신 상태인 전체 카탈로그는 생성된 도구 참조입니다.

1. 검색 및 SDK 참조 (3개 도구)

새로운 작업에서 가장 먼저 호출됩니다. 비용이 저렴하고 모두 로컬에서 실행되며 부작용이 없습니다.

도구	기능
getPlatformInfo	정적 플랫폼 카탈로그(라이브러리 버전, 글래스가 노출하는 SDK 기능 목록, 벤더별 등급)를 반환합니다. 항상 올바른 첫 번째 호출입니다.
getCapabilityGuide	기능별 Kotlin + Swift 최소 사용법(호출 형태, 구성 인수, 주의사항)을 제공합니다. getPlatformInfo(기능 이름 지정)와 함께 사용하여 에이전트가 각 기능을 호출하는 방법을 알려줍니다.
getCodeExample	두 언어로 된 전체 표준 구성을 제공합니다. assistant_agent_loop(4단계 표준 음성 비서 흐름) 및 agent_driven_e2e_full_loop(에이전트 주도 E2E 테스트)로 시작하세요. voice_qa_assistant, barge_in_speak, photo_describe_voice, live_transcription_ui, voice_notes, connection_page_setup, byok_anthropic, display_browse_detail, display_media_gallery, video_frames_ml도 다룹니다. 핸들러 코드를 작성할 때 이 예제들을 참고하세요. 전체 열거 목록은 /docs/reference/mcp-tools에서 생성됩니다.

2. 설정 및 생성

도구	기능
generateConnectionModule	일회성 스캐폴드 — 모듈, Gradle/SPM 배선, 종속성, 권한, 매니페스트를 부트스트랩합니다. 2회 호출 흐름: 배치 없이 첫 번째 호출 시 ExtentosConnectionPage의 위치를 묻는 질문이 반환되고, 선택한 배치로 두 번째 호출 시 전체 파일 세트가 반환됩니다.
getConnectionPageConfig / setConnectionPageConfig	대시보드/서버가 보유한 프로젝트별 연결 페이지 구성(테마 토큰 + 섹션 가시성)을 읽고 씁니다.
regenerateConnectionPageFile / adoptConnectionPageFile	커밋된 extentos.connection-page.json을 서버 구성과 동기화합니다 — regenerate(서버→파일) 또는 adopt(파일→서버).

스캐폴딩 후 에이전트는 getCapabilityGuide / getCodeExample에서 제공하는 SDK 기본 요소에 대해 자체 핸들러 클래스를 작성합니다. 핸들러 코드는 고객의 작성 영역이며, initSpec 또는 DSL 채우기 단계는 없습니다.

3. 에이전트 구성 및 사용량 (3개 도구)

계정 범위 — 연결된 계정이 필요하며 MCP 액세스 권한(기본값 읽기+쓰기)에 따라 프로젝트별로 제어됩니다.

도구	기능
getAssistantConfig / setAssistantConfig	프로젝트의 대시보드 관리 비서 설정(OpenAI Realtime 모델, 음성, 메모리(압축) 모델, 세션 내 메모리 모드)을 읽거나 변경합니다. set은 부분 업데이트이며, 카탈로그에 대해 각 값을 검증하고 모델 변경 시 비용 영향을 알려줍니다.
getGatewayUsage	최근 기간 동안의 프로젝트 관리 게이트웨이 사용량 + 정확한 비용(모델별로 분류된 청구 원장의 토큰 수 및 정가 USD)을 읽습니다. 메타데이터만 해당하며, 트랜스크립트나 콘텐츠는 절대 포함되지 않습니다.

4. 자격 증명 (2개 도구)

계정 범위 + 프로젝트별 제어. 비밀 값이 에이전트를 통과하지 않는 '알지 못한 채 쓰기' 방식입니다.

도구	기능
getCredentialStatus	프로젝트의 OpenAI API 키(BYOK) 및 Meta DAT 빌드 ID 설정 여부(마스킹된 힌트 + 업데이트 시간만, 값은 절대 아님)를 읽습니다.
setCredential	자격 증명의 '알지 못한 채 쓰기' 입력을 시작합니다 — 로그인한 소유자가 암호화된 저장소에 직접 비밀 값을 붙여넣을 수 있는 대시보드 링크를 반환합니다. 설계상 비밀 인수를 받지 않습니다.

5. 분석 (1개 도구)

도구

기능

getProjectAnalytics

프로젝트의 프로덕션 분석(출시된 App Store / Play Store 설치의 집계 원격 측정 데이터 — 이벤트, 활성 설치 수, 이벤트/일/벤더/플랫폼별)을 읽습니다. 메타데이터만 해당하며, 계정 범위, 소유권 확인, 분석 권한에 의해 제어됩니다. 앱이 출시되어 프로덕션 증명 이벤트를 보내기 전까지는 비어 있습니다(실시간 개발/시뮬레이션 스트림에는 getEventLog 사용).

6. 구현 안내 (2개 도구)

에이전트가 구성 중에 호출하는 보조 도구입니다.

도구	기능
getVoiceCommandGuidance	glasses.audio.transcriptions() 소비자에 연결하기 전에 제안된 웨이크/명령 구문의 UX 문제(충돌, 모호성, 인식하기 어려운 단어, Meta 웨이크 워드 충돌)를 분석합니다.
getPermissions	기능 목록에서 정확한 플랫폼 권한, Meta DAT 요구 사항, 포그라운드 서비스 필요 사항을 도출합니다. 핸들러에서 기본 요소를 추가하거나 제거할 때 실행합니다.

7. 유효성 검사 (2개 도구)

정확성 검증 게이트입니다. 구조적 변경(새 기능 선언, 종속성 업데이트, 매니페스트 편집) 후에 실행합니다.

도구	설명
inspectIntegration	읽기 전용 프로젝트 스냅샷 — 매니페스트, 생성된 파일 해시, 종속성 목록, 연결 페이지 구성. 수동 편집 전에 실행하여 현재 상태를 파악합니다.
validateIntegration	전체 프로젝트 정확성 검사 — 매니페스트, 생성된 파일, 종속성 선언, 권한이 선언된 기능을 포함하는지, 부트스트랩이 ExtentosGlasses.create(...)를 호출하는지, 툴체인 버전, 연속 캡처 흐름을 위한 포그라운드 서비스 힌트. 사전 테스트 관문입니다.

8. 시뮬레이션

브라우저 기반 시뮬레이터 세션을 프로비저닝하고 운영하며, 사람 없이 엔드투엔드 루프를 완성하는 에이전트 주도 테스트 도구를 제공합니다.

도구	설명
createSimulatorSession	extentos.com/s에서 브라우저 모드 세션을 가져오거나 생성합니다. 이 프로젝트에 대해 저장된 시뮬레이션이 있으면 반환하고(상태: "resumed"), 없으면 새로 만듭니다(상태: "active"). 연결 가능한 경우 로컬 브리지를 통해 실행 중인 앱을 자동으로 연결합니다. 그렇지 않으면 BuildConfig.EXTENTOS_SESSION_URL 스니펫(Android) 또는 extentos.session.plist 페이로드(iOS)를 내보냅니다. 깨끗한 상태를 위해 세션 ID를 새로 발급하려면 resetFresh: true를 전달합니다.
ensureSimulatorBrowser	연결된 시뮬레이터 브라우저 탭을 열고 확인합니다 — 카메라 및 주입 흐름의 전제 조건입니다.
completeAuthLink	createSimulatorSession이 status: "auth_required"를 반환한 후(익명 설치 시 세션 발급을 위해 연결 필요), 사용자가 가입을 완료할 때까지 백엔드를 폴링한 다음 베어러 토큰을 ~/.extentos/auth.json에 저장합니다.
getEventLog	세션에서 구조화된 이벤트 추적을 가져옵니다. 필터 값: all (필터 없음) 및 7개의 칩 errors, voice, camera, display, ai, lifecycle, custom — 이벤트당 하나의 칩이며, errors는 양식에 관계없이 심각도≥warn인 이벤트를 흡수합니다. 추적 수준 범위를 위한 cursor, follow, limit도 포함됩니다. 주요 디버깅 도구입니다.
getSimulatorStatus	라이브 세션의 현재 상태(단계, 하드웨어 준비 상태, 연결된 역할, 활성 기능 스트림, 현재 토글 값)를 읽습니다.
injectTranscript / injectAssistantUtterance / assertToolCalled	웨이크 워드 또는 어시스턴트 턴을 구동한 다음 모델이 호출한 도구를 어설션합니다 — 사람이 필요 없는 에이전트 주도 E2E 루프입니다.
setSimVideo / setSimDevice	시뮬레이션된 카메라에 테스트 비디오를 주입합니다. 시뮬레이션된 기기 모델을 전환합니다(예: 디스플레이 경로를 실행하기 위해 rayban_display로 전환).
getDisplayState / injectInput	현재 렌더링된 디스플레이 트리를 읽고 디스플레이 입력(선택 / 탐색 / 뒤로 가기)을 구동합니다.

9. 프로덕션 (도구 2개)

출시 전 점검 사항입니다.

도구	설명
getProductionChecklist	선언된 기능 및 핸들러 이름을 기반으로 한 개인 맞춤형 프로덕션 준비 체크리스트 — 자격 증명 연결, 권한 감사, 포그라운드 서비스 요구 사항(연속 캡처 사용 시), 릴리스 빌드에서 시뮬레이터 URL 제거, 스토어 등록 준비 상태.
getCredentialGuide	프로덕션 AI 제공업체(anthropic, openai, google_cloud_vision, google_translate, google_gemini, deepl, azure_cognitive, aws_bedrock, huggingface 또는 custom) 및 Meta DAT 등록을 위한 단계별 자격 증명 설정 안내.

10. 문서 및 검색 (도구 1개)

도구

설명

searchDocs

주제 또는 키워드로 Extentos 문서를 검색합니다. 음성 어시스턴트의 경우 assistant_runtime을 먼저 읽으십시오. conversation_runtime은 더 이상 사용되지 않는 Phase-3 런타임입니다(마이그레이션 참조용). 기타 관련 주제: voice_integration, agent_e2e_testing, managed_gateway, conversation_memory, display 및 안정적인 개념 세트 — getting_started, custom_handlers(표준 SDK 구성 문서), simulator_browser_mode, event_log_schema, toggles, library_api, permissions, multi_platform_projects. 주제 ID는 안정적이며, 라이브 도구 입력이 권위적입니다.

도구별 전체 참조(입력 스키마, 응답 형태, 실제 예제 포함): /docs/mcp-server/tools.

표준 에이전트 주도 흐름

새 프로젝트에서 에이전트는 다음 순서로 도구를 호출합니다.

1. getPlatformInfo({ sections: ["version", "capabilities"], glasses: "meta_rayban" })
2. getCodeExample({ pattern: "assistant_agent_loop" })  // Phase-4 voice assistant; or whatever pattern fits
3. getCapabilityGuide({ feature: "<each primitive the handler will use>" })
4. generateConnectionModule({ platform, glasses, appPackage })
   → returns "needs_placement" question
5. generateConnectionModule({ ... placement: "<chosen>" })
   → writes scaffold files (ExtentosBootstrap, manifest, etc.)
6. <agent writes handler class(es)> against the SDK primitives
   <agent updates extentos.manifest.json's `capabilities` array>
7. validateIntegration()
   → ✓ all good (or returns structured errors to fix)
8. createSimulatorSession({ glasses })
   → returns sessionId; auto-opens browser at extentos.com/s/<id>
   → if running app is reachable via local bridge, it auto-attaches
9. <developer interacts with the simulator; capability events flow into the backend>
10. getEventLog({ sessionId, filter: "errors" })  → debug
    getSimulatorStatus({ sessionId })             → status

반복 작업: 핸들러 코드 편집 → 재빌드 + 재설치 → 앱이 동일한 시뮬레이터 세션에 자동으로 연결됩니다(재발급 없음, URL은 안정적임). 출시 전: getProductionChecklist 및 getCredentialGuide.

구성

MCP 서버는 다음 환경 변수를 읽습니다(mcp-server/src/에서 확인됨).

변수	기본값	설명
EXTENTOS_BACKEND_URL	프로덕션 백엔드	백엔드 URL을 재정의합니다(tools/util/backendClient.ts). Extentos 자체의 로컬 개발용입니다.
EXTENTOS_CONFIG_DIR	~/.extentos	구성/인증 디렉터리를 재정의합니다(telemetry/consent.ts).
EXTENTOS_TELEMETRY	설정 안 됨 (동의 기본값)	CLI 동의 명령을 실행하지 않고 원격 측정을 거부하려면 0으로 설정합니다.
EXTENTOS_NO_AUTO_OPEN	설정 안 됨	시뮬레이터 세션 생성 시 브라우저 자동 열기를 비활성화하려면 1로 설정합니다(헤드리스 환경에서 유용).

전체 구성 참조: /docs/mcp-server/configuration.

CLI 하위 명령

인수 없이 npx @extentos/mcp-server@latest을 실행하면 stdio를 통해 MCP 서버가 시작됩니다(에이전트가 사용하는 경로). 하위 명령과 함께 사용하면 개발자 CLI로 작동합니다.

하위 명령어	기능
login	기기 코드 흐름을 통해 이 설치를 Extentos 계정에 연결합니다(사전 조치 — 첫 시뮬레이터 세션 전이나 재연결을 위한 로그아웃 후에 유용).
logout	~/.extentos/auth.json을 지웁니다. 설치는 익명 등급으로 돌아가며, 다음 시뮬레이터 세션 호출 시 기기 코드 흐름이 다시 시작됩니다.
whoami	아직 구현되지 않음(Phase-0 스텁). installId, accountId(연결된 경우), 등급, 인증 만료 시간을 출력합니다.
setup	로컬 빌드 환경을 사전 점검합니다 — 전이적 Meta DAT 아티팩트에 필요한 GitHub Packages PAT(read:packages) 및 기타 종속성 전제 조건을 확인합니다.
accept-privacy	개인정보 보호 동의를 기록합니다(원격 측정 업로드 활성화).
decline-privacy	개인정보 보호 거부를 기록합니다(원격 측정 업로드 비활성화).
status	동의 상태, 설치 ID, 연결된 계정, MCP/라이브러리 버전을 출력합니다.
update	MCP 서버 업데이트를 확인합니다(npx @latest 설치 시 아무 작업도 하지 않음).

전체 CLI 참조: /docs/mcp-server/auth.

인증 모델

MCP 서버는 익명 우선입니다. 검색, 기능 가이드, 코드 예제, 유효성 검사, 문서 검색, 온디바이스 시뮬레이션 및 실제 하드웨어 테스트는 로그인 없이 모두 작동합니다. 무료 계정을 연결하는 세 가지 요소: 브라우저 시뮬레이터 세션 발행(createSimulatorSession, HTTP 402), generateConnectionModule 스캐폴드 단계(계정 바인딩 프로젝트 키 발행 — 동일한 402 기기 코드 흐름; 정보 제공용 첫 호출은 익명), 그리고 계정 범위 프로젝트 도구(어시스턴트 구성, 자격 증명, 연결 페이지 쓰기, 분석 — HTTP 401)입니다.

기기 코드 흐름: 첫 번째 제한된 호출은 확인 URL과 함께 status: "auth_required"를 반환합니다. 에이전트는 completeAuthLink를 호출하여 백엔드를 폴링합니다. 개발자는 해당 URL에서 무료 이메일 전용 계정(Google 또는 이메일 + 비밀번호, 결제 불필요)으로 가입하고, 백엔드가 토큰을 발급하면 원래 도구 호출이 자동으로 재시도됩니다. 연결 후에는 시뮬레이터 세션이 무제한입니다.

Extentos의 도구, 코드 생성, 유효성 검사, SDK 및 브라우저 시뮬레이터는 무료입니다 — 빌드 및 배포에 좌석당 또는 구독료가 없습니다. 사용량을 측정하는 유일한 부분은 Phase-4 음성 어시스턴트 뒤에 있는 관리형 AI 게이트웨이입니다. 전체 인증 모델: /docs/mcp-server/auth; 가격: /docs/resources/pricing.

개인정보 보호 및 원격 측정

처음 실행 시 MCP 서버는 일회성 개인정보 보호 고지를 응답에 삽입합니다. 원격 측정은 익명이며(installId로 태그 지정, 소스 코드나 개인 데이터 없음) 기본적으로 계속 진행하면 해제됩니다 — Vercel CLI, Astro, Vite와 동일한 패턴입니다. 언제든지 거부할 수 있습니다:

npx @extentos/mcp-server@latest decline-privacy
# or
EXTENTOS_TELEMETRY=0 (env var, persistent for the shell)

개인정보 보호 고지 내용은 mcp-server/src/index.ts에 있습니다(PRIVACY_NOTICE 상수). 고지는 claimFirstPrivacyNotice를 통해 설치당 한 번만 표시되며 반복되지 않습니다.

호환 MCP 호스트

다음과의 작동이 확인되었습니다:

Claude Code — 주요 대상. claude mcp add을 통한 한 줄 설치.
Cursor — ~/.cursor/mcp.json의 JSON 구성.
Windsurf — ~/.codeium/windsurf/mcp_config.json의 JSON 구성.
Cline — Cline의 MCP 설정 내 JSON 구성.
모든 MCP 호환 호스트 — 표준 mcpServers.extentos JSON 블록을 넣으세요.

MCP 서버는 stdio(@modelcontextprotocol/sdk)를 통해 표준 MCP 프로토콜을 사용하며, 서버 측에 호스트별 코드 경로는 존재하지 않습니다. 호스트별 설치 단계: /docs/mcp-server/agents.

로컬 브리지 — 자동 바인딩 개발 루프

서버가 시작되면 127.0.0.1:31337/whoami HTTP 리스너(mcp-server/src/localBridge.ts)를 엽니다. 개발자 앱의 Extentos 라이브러리는 런타임에 이 엔드포인트를 탐색하여 호스트 MCP의 installId을 학습합니다. 결과: 에이전트의 모든 createSimulatorSession 호출이 실행 중인 앱을 새 세션에 자동으로 연결합니다 — 재빌드나 URL 붙여넣기가 필요 없습니다.

연결 경로:

Android 에뮬레이터: http://10.0.2.2:31337/whoami (호스트 루프백 NAT 별칭)
iOS 시뮬레이터: http://localhost:31337/whoami (호스트 네트워크 네임스페이스 공유)
USB를 통한 실제 Android 휴대폰: adb reverse tcp:31337 tcp:31337 한 번 실행 후 기기에서 localhost:31337
셀룰러 휴대폰 또는 클라우드 호스팅 에이전트: 탐색 시간 초과. 에이전트는 대신 URL 베이크 경로를 사용합니다 — createSimulatorSession는 개발자가 붙여넣은 후 앱을 한 번 재빌드하는 BuildConfig.EXTENTOS_SESSION_URL 스니펫(Android) 또는 extentos.session.plist 페이로드(iOS)를 반환합니다. 자동 바인딩보다 덜 우아하지만 모든 토폴로지에서 작동합니다.

127.0.0.1에만 바인딩됩니다. installId은 비밀이 아닙니다 — 모든 도구 호출 시 MCP가 api.extentos.com로 전송하는 값과 동일합니다. 이 계층에서는 인증이 필요하지 않습니다.

포트 31337가 사용 중인 경우(드물게; 다른 MCP 인스턴스가 이미 실행 중), 시작 시 경고를 기록하고 계속 진행합니다. 해당 세션 동안 자동 바인딩은 자동으로 실패하며, 개발자는 포트가 해제될 때까지 URL 베이크 경로를 사용합니다.

상태

패키지: npm의 @extentos/mcp-server (MIT 라이선스)
엔진: Node.js 20+
Pre-1.0 — 하드웨어 테스트 루프가 닫힐 때까지 마이너 버전 간에 API가 변경될 수 있습니다. 세션 간 재현성이 필요한 경우 정확한 버전으로 고정하세요.