Extentos MCP
chính thứcExtentos là nền tảng phát triển đa nhà cung cấp để thêm khả năng kính thông minh vào các ứng dụng iOS và Android hiện có. Cách ví von đơn giản nhất là Stripe dành cho kính thông minh.
Bạn có thể làm gì với Extentos MCP?
- Khám phá khả năng nền tảng và tính năng SDK — gọi
getPlatformInfođể xem kính có thể làm gì, sau đógetCapabilityGuideđể biết các mẫu sử dụng Kotlin/Swift cho từng tính năng. - Tạo khung mô-đun kết nối — chạy
generateConnectionModuleđể khởi tạo dự án với kết nối Gradle/SPM, các phụ thuộc, quyền và mục manifest. - Lấy các ví dụ mã chuẩn — sử dụng
getCodeExampleđể truy xuất các tổ hợp Kotlin và Swift đầy đủ cho các mẫu như trợ lý giọng nói, mô tả ảnh hoặc phiên âm trực tiếp. - Xác thực tính đúng đắn của dự án — chạy
validateIntegrationđể kiểm tra manifest, phụ thuộc, quyền và các lệnh gọi khởi tạo trước khi kiểm thử hoặc phát hành. - Gỡ lỗi với dấu vết sự kiện mô phỏng — gọi
getEventLogđể lấy các dấu vết có cấu trúc được lọc theo lỗi, giọng nói, camera, màn hình hoặc sự kiện vòng đời từ một phiên mô phỏng. - Kiểm tra sẵn sàng sản xuất — sử dụng
getProductionChecklistđể kiểm tra trước khi phát hành được cá nhân hóa bao gồm thông tin xác thực, quyền, nhu cầu dịch vụ nền trước và sẵn sàng đăng ký cửa hàng.
Tài liệu
Máy chủ MCP
Máy chủ MCP
Máy chủ Extentos MCP (@extentos/mcp-server\) là một gói npm mà tác nhân AI (Claude Code, Cursor, Windsurf, Cline) cài đặt một lần và sau đó sử dụng để thêm khả năng kính thông minh Meta Ray-Ban vào ứng dụng iOS hoặc Android gốc. Nó cung cấp một tập hợp công cụ xác định chặt chẽ trên 10 danh mục — khám phá, tạo mã, cấu hình tác nhân, thông tin xác thực, phân tích, hướng dẫn, xác thực, mô phỏng, sẵn sàng sản xuất và tài liệu — cùng với CLI để liên kết tài khoản, đồng ý đo lường từ xa và kiểm tra cập nhật. Đây là hướng dẫn vận hành cho tác nhân.
Máy chủ MCP là cách mà một tác nhân AI — Claude Code, Cursor, Windsurf, Cline, hoặc bất kỳ máy chủ tương thích Model Context Protocol nào — vận hành Extentos. Tác nhân gọi các công cụ xác định; máy chủ cung cấp cho tác nhân thông tin về những khả năng mà kính cung cấp, trả về các mẫu mã SDK chuẩn bằng Kotlin và Swift, tạo khung dự án, làm trung gian cho các phiên mô phỏng và truy vấn dấu vết gỡ lỗi. Bản thân máy chủ không có công cụ lập kế hoạch — các tác nhân lập kế hoạch tốt hơn các gói regex. Các công cụ là các nguyên thủy đã được định kiểu mà tác nhân kết hợp theo trình tự.
Trang này là trang đích của phần — máy chủ là gì, tổng quan về các công cụ, luồng công việc chuẩn do tác nhân điều khiển, các nút cấu hình, CLI và cách thức hoạt động của mô hình xác thực. Các trang con sẽ đề cập chi tiết từng phần.
Cài đặt
claude mcp add extentos -- npx -y @extentos/mcp-server@latest
Đối với các máy chủ không phải Claude Code, hãy xem lời nhắc tác nhân hoặc đường dẫn cài đặt JSON thủ công. Tham khảo cài đặt đầy đủ tại /docs/mcp-server/install.
Các công cụ, theo danh mục
Máy chủ cung cấp một bề mặt công cụ xác định (được xác minh trong mcp-server/src/tools/definitions.ts), được tổ chức thành 10 danh mục. Các danh mục là bản đồ tư duy của tác nhân; một tác nhân hiểu công cụ thuộc danh mục nào có thể quyết định khi nào nên gọi nó. Danh mục đầy đủ luôn cập nhật là tham chiếu công cụ được tạo ra.
1. Khám phá và tham chiếu SDK (4 công cụ)
Các lệnh gọi đầu tiên trong bất kỳ tác vụ mới nào. Chi phí thấp, hoàn toàn cục bộ, không có tác dụng phụ.
| Công cụ | Chức năng |
|---|---|
| getPlatformInfo | Trả về danh mục nền tảng tĩnh — phiên bản thư viện, danh sách các khả năng SDK mà kính cung cấp, các cấp độ theo nhà cung cấp. Luôn là lệnh gọi đầu tiên đúng đắn. |
| getCapabilityGuide | Hướng dẫn sử dụng tối thiểu cho từng tính năng bằng Kotlin + Swift — hình dạng lệnh gọi, đối số cấu hình, các điểm cần lưu ý. Kết hợp với getPlatformInfo (công cụ đặt tên cho các tính năng) để cho tác nhân biết cách gọi từng tính năng. |
| getCodeExample | Các tổ hợp chuẩn đầy đủ bằng cả hai ngôn ngữ. Bắt đầu với assistant_agent_loop (luồng trợ lý giọng nói chuẩn Giai đoạn 4) và agent_driven_e2e_full_loop (kiểm thử E2E do tác nhân điều khiển). Cũng bao gồm 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 và video_frames_ml. Tham khảo các ví dụ này khi viết mã xử lý. Danh sách liệt kê đầy đủ được tạo tại /docs/reference/mcp-tools. |
| getMigrationGuide | Dành cho các ứng dụng đã được xây dựng trên Meta DAT thô — trả về một bản đồ ánh xạ các ký hiệu DAT hiện có của bạn tới các nguyên thủy Extentos thay thế chúng, cùng với một kế hoạch chuyển đổi có thứ tự. |
2. Thiết lập và Tạo mã
| Công cụ | Chức năng |
|---|---|
| generateConnectionModule | Tạo khung một lần — mô-đun khởi tạo, cấu hình Gradle/SPM, các phụ thuộc, quyền, tệp kê khai. Luồng hai lệnh gọi: lệnh gọi đầu tiên không có vị trí sẽ trả về câu hỏi hỏi ExtentosConnectionPage nên được đặt ở đâu; lệnh gọi thứ hai với vị trí đã chọn sẽ trả về bộ tệp đầy đủ. |
| getConnectionPageConfig / setConnectionPageConfig | Đọc / ghi cấu hình trang kết nối cho từng dự án (mã thông báo chủ đề + khả năng hiển thị phần) mà bảng điều khiển/máy chủ nắm giữ. |
| regenerateConnectionPageFile / adoptConnectionPageFile | Đồng bộ hóa tệp extentos.connection-page.json đã cam kết với cấu hình máy chủ — tạo lại (máy chủ→tệp) hoặc chấp nhận (tệp→máy chủ). |
Sau khi tạo khung, tác nhân tự viết các lớp xử lý của mình dựa trên các nguyên thủy SDK được cung cấp bởi getCapabilityGuide / getCodeExample. Mã xử lý là bề mặt tác giả của khách hàng — không có bước initSpec hoặc điền DSL.
3. Cấu hình & sử dụng tác nhân (5 công cụ)
Phạm vi tài khoản — yêu cầu tài khoản đã liên kết và được kiểm soát cho từng dự án bởi quyền truy cập MCP (mặc định là Đọc+Ghi).
| Công cụ | Chức năng |
|---|---|
| getAssistantConfig / setAssistantConfig | Đọc hoặc thay đổi cài đặt trợ lý do bảng điều khiển quản lý của dự án — mô hình OpenAI Realtime, giọng nói, mô hình bộ nhớ (nén) và chế độ bộ nhớ trong phiên. set là cập nhật một phần, xác thực từng giá trị dựa trên danh mục và phản ánh tác động chi phí của việc thay đổi mô hình. |
| listProjectSounds / addProjectSound | Liệt kê hoặc tải lên thư viện âm thanh được đặt tên của dự án — các tệp MP3/M4A/AAC/WAV dưới 1 MB mà mã ứng dụng phát bằng glasses.audio.playSound(name) (iOS hiện tại; lộ trình phát lại Android đang được triển khai) — bảng điều khiển cũng có thể chọn một âm thanh làm âm thanh đánh thức. Được kiểm soát bởi quyền assistant_config.sounds. |
| getGatewayUsage | Đọc mức sử dụng cổng được quản lý của dự án + chi phí chính xác trong một khoảng thời gian gần đây — số lượng mã thông báo và USD theo giá niêm yết từ sổ cái thanh toán, được phân tích theo mô hình. Chỉ siêu dữ liệu, không bao giờ là bản ghi hoặc nội dung. |
4. Thông tin xác thực (2 công cụ)
Phạm vi tài khoản + được kiểm soát cho từng dự án. Ghi-mà-không-biết — bí mật không bao giờ đi qua tác nhân.
| Công cụ | Chức năng |
|---|---|
| getCredentialStatus | Đọc xem khóa API OpenAI (BYOK) và danh tính bản dựng Meta DAT của dự án đã được thiết lập hay chưa — chỉ là gợi ý bị che + thời gian cập nhật, không bao giờ là giá trị. |
| setCredential | Bắt đầu nhập thông tin xác thực theo cách ghi-mà-không-biết — trả về một liên kết bảng điều khiển nơi chủ sở hữu đã đăng nhập dán trực tiếp bí mật vào kho lưu trữ được mã hóa. Theo thiết kế, không nhận đối số bí mật. |
5. Phân tích (1 công cụ)
| Công cụ | Chức năng |
|---|---|
| getProjectAnalytics | Đọc phân tích sản xuất của dự án — dữ liệu đo lường từ xa tổng hợp từ các bản cài đặt App Store / Play Store đã phát hành (sự kiện, cài đặt đang hoạt động, theo sự kiện / ngày / nhà cung cấp / nền tảng). Chỉ siêu dữ liệu, phạm vi tài khoản, đã kiểm tra quyền sở hữu, được kiểm soát bởi quyền Analytics. Trống cho đến khi ứng dụng được phát hành và gửi các sự kiện đã được chứng thực sản xuất (sử dụng getEventLog cho luồng trực tiếp dev/sim). |
6. Hướng dẫn triển khai (2 công cụ)
Các công cụ nhiệm vụ phụ mà tác nhân gọi trong quá trình soạn thảo.
| Công cụ | Chức năng |
|---|---|
| getVoiceCommandGuidance | Phân tích các cụm từ đánh thức / lệnh được đề xuất để tìm các vấn đề về UX (xung đột, mơ hồ, từ khó nhận dạng, xung đột từ đánh thức của Meta) trước khi kết nối chúng vào một consumer của glasses.audio.transcriptions(). |
| getPermissions | Suy ra các quyền nền tảng chính xác, yêu cầu Meta DAT và nhu cầu dịch vụ nền trước từ danh sách khả năng. Chạy khi thêm hoặc xóa một primitive khỏi handler của bạn. |
7. Xác thực (2 công cụ)
Các cổng kiểm tra tính đúng đắn. Chạy sau các thay đổi cấu trúc (khai báo khả năng mới, nâng cấp dependency, chỉnh sửa manifest).
| Công cụ | Chức năng |
|---|---|
| inspectIntegration | Ảnh chụp nhanh dự án chỉ đọc — manifest, hash của tệp được tạo, danh sách dependency, cấu hình trang kết nối. Chạy trước khi chỉnh sửa thủ công để hiểu trạng thái hiện tại. |
| validateIntegration | Kiểm tra tính đúng đắn toàn bộ dự án — manifest, các tệp được tạo, dependency đã khai báo, quyền bao phủ các khả năng đã khai báo, lệnh gọi khởi động ExtentosGlasses.create(...), phiên bản toolchain, gợi ý dịch vụ nền trước cho các luồng thu thập liên tục. Cổng kiểm tra trước khi test. |
8. Mô phỏng
Cung cấp và vận hành các phiên trình mô phỏng dựa trên trình duyệt, cùng với các công cụ kiểm thử do agent điều khiển để khép kín vòng lặp end-to-end mà không cần con người.
| Công cụ | Chức năng |
|---|---|
| createSimulatorSession | Lấy hoặc tạo một phiên chế độ trình duyệt tại extentos.com/s. Trả về phiên mô phỏng đã lưu cho dự án này nếu tồn tại (trạng thái: "resumed"), hoặc tạo mới (trạng thái: "active"). Tự động gắn ứng dụng đang chạy qua cầu nối cục bộ khi có thể truy cập; nếu không, phát ra một đoạn mã BuildConfig.EXTENTOS_SESSION_URL (Android) hoặc payload extentos.session.plist (iOS). Truyền resetFresh: true để xoay sessionId cho một phiên sạch. |
| ensureSimulatorBrowser | Mở + xác nhận một tab trình duyệt mô phỏng đã kết nối — điều kiện tiên quyết cho các luồng camera và inject. |
| completeAuthLink | Sau khi createSimulatorSession trả về trạng thái: "auth_required" (cài đặt ẩn danh cần liên kết để tạo phiên), thăm dò backend cho đến khi người dùng hoàn tất đăng ký, sau đó lưu bearer token vào ~/.extentos/auth.json. |
| getEventLog | Lấy các dấu vết sự kiện có cấu trúc từ một phiên. Giá trị lọc: all (không lọc) cộng với bảy chip errors, voice, camera, display, ai, lifecycle, custom — mỗi chip cho một sự kiện, với errors hấp thụ severity≥warn bất kể phương thức. Cộng với cursor, follow, limit cho phạm vi cấp độ dấu vết. Công cụ gỡ lỗi chính. |
| getSimulatorStatus | Đọc trạng thái hiện tại của một phiên trực tiếp — phase, hardware-ready, các vai trò đã gắn, các luồng khả năng đang hoạt động, giá trị toggle hiện tại. |
| injectTranscript / injectAssistantUtterance / assertToolCalled | Điều khiển một cụm từ đánh thức hoặc một lượt trợ lý, sau đó xác nhận công cụ nào mà mô hình đã gọi — vòng lặp E2E do agent điều khiển, không cần con người. |
| injectHardwareButton | Nhấn nút chụp phần cứng của kính mô phỏng — chạm tạm dừng/tiếp tục luồng camera trực tiếp, giữ để dừng — để agent có thể thực hiện các cử chỉ riêng tư của người đeo (và kiểm tra CaptureError.StreamPaused kết quả) mà không cần con người. |
| setSimVideo / setSimDevice | Đưa một video kiểm thử vào camera mô phỏng; chuyển đổi mẫu thiết bị mô phỏng (ví dụ: rayban_display để thực thi đường dẫn hiển thị). |
| getDisplayState / injectInput | Đọc cây hiển thị hiện đang được kết xuất + điều khiển đầu vào hiển thị (chọn / điều hướng / quay lại). |
9. Sản xuất (2 công cụ)
Kiểm tra trước khi xuất xưởng.
| Công cụ | Chức năng |
|---|---|
| getProductionChecklist | Danh sách kiểm tra sẵn sàng sản xuất được cá nhân hóa dựa trên các khả năng đã khai báo + tên handler — kết nối credential, kiểm tra quyền, yêu cầu dịch vụ nền trước (khi sử dụng thu thập liên tục), loại bỏ URL trình mô phỏng khỏi bản dựng phát hành, sẵn sàng niêm yết cửa hàng. |
| getCredentialGuide | Hướng dẫn từng bước thiết lập credential cho các nhà cung cấp AI sản xuất — anthropic, openai, google_cloud_vision, google_translate, google_gemini, deepl, azure_cognitive, aws_bedrock, huggingface, hoặc custom — cộng với đăng ký Meta DAT. |
10. Tài liệu & tìm kiếm (1 công cụ)
| Công cụ | Chức năng |
|---|---|
| searchDocs | Tìm kiếm tài liệu Extentos theo chủ đề hoặc từ khóa. Đối với trợ lý giọng nói, đọc assistant_runtime trước; conversation_runtime là runtime Phase-3 đã lỗi thời (chỉ dùng để tham khảo di chuyển). Các chủ đề liên quan khác: voice_integration, agent_e2e_testing, managed_gateway, conversation_memory, display, cộng với bộ khái niệm ổn định — getting_started, custom_handlers (tài liệu SDK-composition chính tắc), simulator_browser_mode, event_log_schema, toggles, library_api, permissions, multi_platform_projects. ID chủ đề ổn định; đầu vào công cụ trực tiếp là có thẩm quyền. |
Tham khảo đầy đủ từng công cụ với lược đồ đầu vào, hình dạng phản hồi và ví dụ đã thực hiện: /docs/mcp-server/tools.
Luồng chuẩn do agent điều khiển
Trong một dự án mới, agent gọi các công cụ theo thứ tự này:
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
Để lặp lại: chỉnh sửa mã handler → xây dựng lại + cài đặt lại → ứng dụng tự động gắn vào cùng một phiên mô phỏng (không tạo lại, URL ổn định). Trước khi xuất xưởng: getProductionChecklist và getCredentialGuide.
Cấu hình
Máy chủ MCP đọc các biến môi trường này (được xác minh trong mcp-server/src/):
| Biến | Mặc định | Chức năng |
|---|---|---|
| EXTENTOS_BACKEND_URL | Backend production | Ghi đè URL backend (tools/util/backendClient.ts). Dành cho phát triển cục bộ của chính Extentos. |
| EXTENTOS_CONFIG_DIR | ~/.extentos | Ghi đè thư mục config/auth (telemetry/consent.ts). |
| EXTENTOS_TELEMETRY | chưa đặt (mặc định đồng ý) | Đặt thành 0 để từ chối đo lường từ xa mà không cần chạy lệnh CLI đồng ý. |
| EXTENTOS_NO_AUTO_OPEN | chưa đặt | Đặt thành 1 để tắt tự động mở trình duyệt khi tạo phiên giả lập (hữu ích trong môi trường không giao diện). |
Tham khảo cấu hình đầy đủ: /docs/mcp-server/configuration.
Các lệnh con CLI
Chạy npx @extentos/mcp-server@latest không có đối số sẽ khởi động máy chủ MCP qua stdio (đường dẫn mà tác nhân sử dụng). Với một lệnh con, nó hoạt động như một CLI dành cho nhà phát triển:
| Lệnh con | Chức năng |
|---|---|
| login | Liên kết bản cài đặt này với tài khoản Extentos qua luồng mã thiết bị (chủ động — hữu ích trước phiên giả lập đầu tiên, hoặc sau khi đăng xuất để liên kết lại). |
| logout | Xóa ~/.extentos/auth.json. Bản cài đặt trở về bậc ẩn danh; lệnh gọi phiên giả lập tiếp theo sẽ kích hoạt lại luồng mã thiết bị. |
| whoami | Chưa được triển khai (bản sơ khai Giai đoạn 0). Sẽ in installId, accountId (nếu đã liên kết), bậc, thời hạn xác thực. |
| setup | Kiểm tra trước môi trường build cục bộ — kiểm tra GitHub Packages PAT (read:packages) mà các tạo phẩm Meta DAT bắc cầu cần, cùng các điều kiện tiên quyết phụ thuộc khác. |
| accept-privacy | Ghi nhận đồng ý quyền riêng tư (cho phép tải lên dữ liệu đo lường từ xa). |
| decline-privacy | Ghi nhận từ chối quyền riêng tư (tắt tải lên dữ liệu đo lường từ xa). |
| status | In trạng thái đồng ý, ID cài đặt, tài khoản liên kết, phiên bản MCP/thư viện. |
| update | Kiểm tra cập nhật máy chủ MCP (không có tác dụng với bản cài đặt npx @latest). |
Tham khảo CLI đầy đủ: /docs/mcp-server/auth.
Mô hình xác thực
Máy chủ MCP ưu tiên ẩn danh. Khám phá, hướng dẫn khả năng, ví dụ mã, xác thực, tìm kiếm tài liệu, giả lập trên thiết bị và kiểm thử phần cứng thực đều hoạt động mà không cần đăng nhập. Ba thứ cần tài khoản miễn phí: tạo phiên giả lập trình duyệt (createSimulatorSession, HTTP 402), bước scaffold generateConnectionModule (nó tạo khóa dự án gắn với tài khoản của bạn — cùng luồng mã thiết bị 402; lệnh gọi thông tin đầu tiên là ẩn danh), và các công cụ dự án phạm vi tài khoản (cấu hình trợ lý, thông tin xác thực, ghi trang kết nối, phân tích — HTTP 401).
Luồng mã thiết bị: lệnh gọi có rào cản đầu tiên trả về status: "auth_required" với URL xác minh. Tác nhân gọi completeAuthLink để thăm dò backend; nhà phát triển đăng ký tài khoản miễn phí chỉ cần email tại URL đó (Google hoặc email + mật khẩu, không thanh toán); backend phát hành token; lệnh gọi công cụ ban đầu tự động thử lại. Sau khi liên kết, các phiên giả lập là không giới hạn.
Các công cụ, tạo mã, xác thực, SDK và trình giả lập trình duyệt của Extentos đều miễn phí — không có phí theo chỗ ngồi hay đăng ký để xây dựng và phân phối. Bề mặt duy nhất đo lường mức sử dụng là cổng AI được quản lý đứng sau trợ lý giọng nói Giai đoạn 4. Mô hình xác thực đầy đủ: /docs/mcp-server/auth; giá cả: /docs/resources/pricing.
Quyền riêng tư và đo lường từ xa
Khi chạy lần đầu, máy chủ MCP chèn thông báo quyền riêng tư một lần vào phản hồi. Đo lường từ xa là ẩn danh (được gắn thẻ bằng installId, không có mã nguồn hay dữ liệu cá nhân) và được bỏ qua bằng cách tiếp tục theo mặc định — mô hình giống như Vercel CLI, Astro, Vite. Từ chối bất cứ lúc nào:
npx @extentos/mcp-server@latest decline-privacy
# or
EXTENTOS_TELEMETRY=0 (env var, persistent for the shell)
Nội dung thông báo quyền riêng tư nằm trong mcp-server/src/index.ts (hằng số PRIVACY_NOTICE). Thông báo được hiển thị một lần cho mỗi bản cài đặt qua claimFirstPrivacyNotice — không bao giờ lặp lại.
Các máy chủ MCP tương thích
Đã được xác minh hoạt động với:
- Claude Code — mục tiêu chính. Cài đặt một dòng qua
claude mcp add. - Cursor — cấu hình JSON trong
~/.cursor/mcp.json. - Windsurf — cấu hình JSON trong
~/.codeium/windsurf/mcp_config.json. - Cline — cấu hình JSON trong cài đặt MCP của Cline.
- Bất kỳ máy chủ tương thích MCP nào — thả khối JSON
mcpServers.extentostiêu chuẩn vào.
Máy chủ MCP giao tiếp qua giao thức MCP tiêu chuẩn qua stdio (@modelcontextprotocol/sdk); không có đường dẫn mã cụ thể cho máy chủ nào ở phía máy chủ. Các bước cài đặt cho từng máy chủ: /docs/mcp-server/agents.
Cầu nối cục bộ — vòng lặp phát triển tự động liên kết
Khi máy chủ khởi động, nó mở một trình nghe HTTP 127.0.0.1:31337/whoami (mcp-server/src/localBridge.ts). Thư viện Extentos trên ứng dụng của nhà phát triển thăm dò điểm cuối này khi chạy để biết installId của máy chủ MCP. Kết quả: mọi lệnh gọi createSimulatorSession từ tác nhân tự động gắn ứng dụng đang chạy vào phiên mới — không cần build lại, không cần dán URL.
Các đường dẫn tiếp cận:
- Trình giả lập Android:
http://10.0.2.2:31337/whoami(bí danh NAT loopback máy chủ) - Trình giả lập iOS:
http://localhost:31337/whoami(chia sẻ không gian tên mạng máy chủ) - Điện thoại Android vật lý qua USB:
adb reverse tcp:31337 tcp:31337một lần, sau đólocalhost:31337từ thiết bị - Điện thoại di động hoặc tác nhân đám mây: thăm dò hết thời gian chờ. Tác nhân sử dụng đường dẫn nhúng URL thay thế —
createSimulatorSessiontrả về đoạn mãBuildConfig.EXTENTOS_SESSION_URL(Android) hoặc tải trọngextentos.session.plist(iOS) mà nhà phát triển dán vào, sau đó build lại ứng dụng một lần. Kém tinh tế hơn tự động liên kết nhưng hoạt động trên mọi cấu trúc liên kết.
Chỉ liên kết với 127.0.0.1. installId không phải là bí mật — đó là cùng một giá trị mà MCP gửi đến api.extentos.com trên mỗi lệnh gọi công cụ. Không cần xác thực ở lớp này.
Nếu cổng 31337 đang được sử dụng (hiếm gặp; một phiên bản MCP khác đang chạy), khởi động sẽ ghi cảnh báo và tiếp tục. Tự động liên kết âm thầm thất bại cho phiên đó; nhà phát triển sử dụng đường dẫn nhúng URL cho đến khi cổng được giải phóng.
Trạng thái
- Gói:
@extentos/mcp-servertrên npm (giấy phép MIT) - Môi trường: Node.js 20+
- Trước 1.0 — API có thể thay đổi giữa các phiên bản nhỏ cho đến khi vòng lặp kiểm thử phần cứng đóng lại. Ghim vào một phiên bản chính xác nếu bạn cần khả năng tái tạo giữa các phiên.
Liên quan
- Bắt đầu nhanh với tác nhân AI — cài đặt máy chủ và thực hiện một vòng lặp phát triển thực tế
- Tham khảo công cụ — API đầy đủ cho từng công cụ
- Cấu hình — biến môi trường, tệp cấu hình, cài đặt thời điểm cài đặt
- Xác thực — luồng mã thiết bị, liên kết tài khoản, lệnh CLI xác thực
- Các tác nhân được hỗ trợ — hướng dẫn cài đặt cho từng máy chủ
- Kiến trúc — cách máy chủ MCP phù hợp với hệ thống Extentos rộng lớn hơn
- Truyền tải so với giả lập ứng dụng — trình giả lập mà MCP làm trung gian thực sự làm gì
Liên quan
Bắt đầu nhanh với tác nhân AI
Cài đặt máy chủ Extentos MCP và để tác nhân AI của bạn tạo khung khả năng kính thông minh Meta Ray-Ban vào ứng dụng iOS hoặc Android gốc. Miễn phí để bắt đầu.
Kiến trúc
Cách Extentos kết hợp với nhau — tác nhân AI, máy chủ MCP, SDK Kotlin/Swift gốc, ba phương thức truyền tải (Meta DAT, trình giả lập trình duyệt, trình giả lập trong bộ nhớ cục bộ), và backend.
Truyền tải so với giả lập ứng dụng
Bộ Mock Device Kit của Meta giả lập lớp truyền tải; Extentos giả lập lớp ứng dụng — giọng nói, chụp ảnh và trải nghiệm đeo. Cả hai đều quan trọng.
Cài đặt máy chủ MCP
Cách cài đặt máy chủ Extentos MCP (@extentos/mcp-server) trong bất kỳ tác nhân mã hóa AI tương thích MCP nào — Claude Code, Cursor, Windsurf, Cline và các tác nhân khác. Lệnh cài đặt cho từng máy chủ, vị trí tệp cấu hình, đoạn JSON sao chép-dán, các bước khởi động lại và xác minh, ghim phiên bản, cập nhật, khắc phục sự cố lỗi phổ biến và hướng dẫn gỡ cài đặt. Các đường dẫn cài đặt đã được xác minh cho từng máy chủ được hỗ trợ.
Tham khảo công cụ
Máy chủ Extentos MCP cung cấp một tập hợp công cụ xác định chặt chẽ trên các danh mục xác định — khám phá + tham khảo SDK, tạo, hướng dẫn, xác thực, giả lập, sản xuất, cấu hình tác nhân và tìm kiếm. Tham khảo từng công cụ bao gồm tham số đầu vào, hình dạng phản hồi, khi nào gọi từng công cụ và các ví dụ đã làm. Được xác minh từ các định nghĩa công cụ thực tế và triển khai trình xử lý trong @extentos/mcp-server.
Cấu hình
Cấu hình @extentos/mcp-server — biến môi trường, tệp trạng thái ~/.extentos (id cài đặt, xác thực, đồng ý), và nhà cung cấp mặc định.
Xác thực
Cách xác thực Extentos hoạt động. Khám phá, hướng dẫn, xác thực và tìm kiếm chạy không cần tài khoản; tài khoản miễn phí (được liên kết qua luồng mã thiết bị OAuth 2.0) mở khóa các phiên giả lập trình duyệt, bước scaffold và các công cụ dự án phạm vi tài khoản. Không thanh toán.
Các tác nhân được hỗ trợ
Sự khác biệt giữa các máy chủ cho các tác nhân mã hóa AI chạy Extentos — Claude Code, Cursor, Windsurf, Cline, tích hợp sẵn trong IDE. Phạm vi, khả năng tiếp cận đa nền tảng, hỗ trợ MCP.
Kính thông minh Apple
Kính thông minh Apple cho nhà phát triển bên thứ ba — truy cập SDK, mô hình ứng dụng, phân phối, khả năng & AI, và vị trí của nó trong bối cảnh kính thông minh năm 2026.
Cài đặt máy chủ MCP