Dùng MCP client trên iPhone: trình kết nối có sẵn, máy chủ riêng và các giới hạn

Orvena là một MCP client cho iPhone. Nó kết nối trợ lý với Notion, Linear, GitHub, Jira & Confluence, Zapier và Home Assistant, hoặc với một máy chủ MCP do bạn tự chạy, và cho phép Apple Intelligence, Private Cloud Compute, mô hình riêng của Orvena hoặc một mô hình OpenRouter gọi công cụ của chúng. Hướng dẫn này đi qua từng màn hình thiết lập theo đúng tên gọi, các quy tắc mà máy chủ tùy chỉnh phải đáp ứng, cách công cụ vừa với một cửa sổ ngữ cảnh nhỏ, và các bước phê duyệt bạn sẽ thấy trước khi bất cứ thứ gì bị thay đổi hoặc được gửi đi.

MCP client trên iPhone làm gì

MCP, tức Model Context Protocol, là một tiêu chuẩn mở để kết nối các dịch vụ với trợ lý AI. Một dịch vụ chạy một máy chủ MCP liệt kê các công cụ của nó, mỗi công cụ có tên, mô tả và các tham số nó nhận, và client gọi một công cụ khi mô hình yêu cầu. Orvena đóng vai client, giao tiếp trực tiếp với từng máy chủ qua HTTPS ngay từ iPhone của bạn.

Orvena chỉ kết nối với máy chủ từ xa qua MCP streamable HTTP. Máy chủ stdio cục bộ, loại mà ứng dụng máy tính khởi chạy bằng một lệnh, không thể chạy bên trong Orvena, vì vậy hãy đặt nó sau một cầu nối HTTPS từ xa rồi thêm địa chỉ đó.

Các trình kết nối Orvena liệt kê

Mở menu ở góc trên bên trái, rồi Cài đặt, rồi Kết nối (hàng có tiêu đề "Kết nối những gì bạn dùng"). Phiên bản 2.0.0 liệt kê sáu dịch vụ:

Mô hình đọc các mô tả này để quyết định yêu cầu cần đến dịch vụ nào. Mỗi máy chủ tự báo danh sách công cụ của mình sau khi đăng nhập, và hàng tương ứng hiển thị số công cụ. Slack, Figma, Canva, Todoist và PayPal không có trong danh sách vì hiện Orvena chưa đáp ứng được yêu cầu đăng nhập của các dịch vụ này.

1. Chạm Kết nối trên một thẻ. Nếu chưa có Premium Unlock, nút sẽ ghi Premium và mở màn hình mua.
2. Với Notion, Linear và Jira & Confluence, trang đăng nhập của chính dịch vụ sẽ mở trong một bảng khi máy chủ yêu cầu đăng nhập. Hãy cấp quyền truy cập ở đó.
3. Với GitHub, một bảng có tiêu đề "Ủy quyền cho Orvena" hiển thị mã dùng một lần. Chạm "Sao chép mã và mở GitHub", dán mã và cấp quyền. Bảng hiển thị "Đang chờ ủy quyền…" cho đến khi GitHub xác nhận.
4. Dịch vụ chuyển lên danh sách phía trên, và trạng thái của nó đổi từ "Đang kết nối…" sang số công cụ.

Home Assistant MCP trên iPhone, và Zapier

Cả hai dùng token thay cho trang đăng nhập. Trong Home Assistant, thêm tích hợp "Model Context Protocol Server", rồi tạo một token trong hồ sơ của bạn, mục Security, Long-lived access tokens (token truy cập dài hạn). Trong Orvena, chạm Kết nối trên Home Assistant, nhập địa chỉ vào mục "Máy chủ nằm ở đâu?", chẳng hạn https://your-home:8123/api/mcp, rồi dán token.

Ở đây Orvena bắt buộc HTTPS kể cả trong mạng nhà bạn, nên nó sẽ không gửi token đến một địa chỉ http://, chẳng hạn http://homeassistant.local:8123 hay một địa chỉ IP cục bộ qua http://. Với địa chỉ http://, nút Kết nối trên bảng sẽ không phản hồi. Home Assistant cần một chứng chỉ TLS hợp lệ hoặc một reverse proxy HTTPS đáng tin cậy.

Zapier chỉ yêu cầu token: tại mcp.zapier.com, tạo một máy chủ, chọn các ứng dụng cho nó, rồi sao chép token kết nối từ tab Connect.

Cách thêm máy chủ MCP của riêng bạn

Thẻ cuối cùng trong Kết nối, "Máy chủ của riêng bạn", mở màn hình "Máy chủ tùy chỉnh". URL phải dùng https:// kèm tên host và không chứa tên người dùng, mật khẩu hay #fragment. Máy chủ phải dùng MCP streamable HTTP, trả lời bằng JSON thuần hoặc một luồng SSE, và hỗ trợ phiên bản giao thức 2025-11-25, 2025-06-18 hoặc 2025-03-26. Chuyển hướng phải ở cùng origin, và máy chủ không báo công cụ nào sẽ không được lưu.

1. Điền Tên và trường địa chỉ, có chữ gợi ý là https://server.example/mcp.
2. Nếu máy chủ dùng khóa API hoặc token, dán nó vào "Bearer token (optional)" (không bắt buộc). Nếu để trống, Orvena sẽ thử truy cập mở, rồi đến đăng nhập.
3. Nếu máy chủ OAuth không nói rõ cần phạm vi nào, hãy nhập chúng vào "OAuth scopes, space-separated (optional)" (phạm vi OAuth, cách nhau bằng dấu cách, không bắt buộc).
4. Trong "Máy chủ này có thể giúp gì? (tùy chọn)", viết một câu về công dụng của máy chủ.
5. Chạm "Thêm máy chủ". Nút hiển thị "Đang kiểm tra…" trong lúc Orvena kết nối và liệt kê công cụ.

Orvena chỉ bắt đầu OAuth sau một phản hồi HTTP 401, 403 hoặc một yêu cầu WWW-Authenticate, và máy chủ ủy quyền phải hỗ trợ PKCE với S256.

Orvena chỉ dùng dòng mục đích để quyết định khi nào tải máy chủ. Nếu không có dòng này, nó tạo phần tóm tắt của từng máy chủ từ tối đa bốn mô tả công cụ, cắt còn 320 ký tự. Nếu có công cụ nào thiếu mô tả, hàng đó hiển thị "Add a purpose so Orvena can choose this server reliably." (hãy thêm mục đích để Orvena chọn máy chủ này chính xác hơn), và nếu không công cụ nào có mô tả, máy chủ chỉ được dùng khi bạn gọi đích danh. Khắc phục bằng "Mô tả mục đích" trong menu ••• của hàng đó.

Những gì cần Premium Unlock

Mọi kết nối đều cần, cả sáu dịch vụ trong danh sách lẫn bất kỳ máy chủ nào bạn tự thêm. Premium Unlock là một lần mua duy nhất giá 14,99 USD, không thuê bao, và còn thêm Private Cloud Compute trên iOS 27, mô hình đám mây dùng khóa OpenRouter của riêng bạn, trò chuyện bằng giọng nói và tác vụ theo lịch. Apple Intelligence và mô hình đã tải về của Orvena đều miễn phí, nhưng khi chưa mở khóa, chúng trả lời mà không có công cụ của trình kết nối.

Dùng MCP với Apple Intelligence và các mô hình khác

Cả bốn mô hình trên màn hình Mô hình đều nhận được công cụ của trình kết nối. Với Apple Intelligence và Private Cloud Compute, Orvena chuyển JSON schema của từng công cụ MCP sang định dạng schema của framework Foundation Models của Apple. Nếu schema của một công cụ dùng thứ mà framework không biểu diễn được, các mô hình của Apple sẽ nhận công cụ đó mà không có tham số, nên hãy dùng mô hình của Orvena hoặc OpenRouter cho công cụ ấy. Ngoại lệ là mô hình OpenRouter được liệt kê là không hỗ trợ công cụ: "Mô hình này không thể dùng công cụ, nên Orvena sẽ trả lời mà không có chúng."

Tự động, lựa chọn mặc định của cài đặt Công nghệ, không bao giờ tự chọn Private Cloud Compute hay OpenRouter.

Cách danh sách công cụ và kết quả vừa với một cửa sổ nhỏ

Cửa sổ 8.192 token không còn mấy chỗ cho hàng chục định nghĩa công cụ, nên công cụ của trình kết nối không bao giờ được gửi cho mô hình cùng lúc. Đầu tiên mô hình gọi load_connectors để chọn một hoặc hai dịch vụ từ danh sách các dịch vụ đã kết nối, mỗi dịch vụ được mô tả trong tối đa 180 ký tự (tổng cộng 8.192 ký tự). Sau đó load_tools chọn từ một đến tám thao tác trong số đó. Chỉ những thao tác này mới gọi được.

Trước mỗi vòng của mô hình, Orvena cộng phần hướng dẫn, schema của các công cụ đã tải và 900 token dự phòng. Nếu tổng vượt quá cửa sổ trừ đi 512 token, nó bỏ bớt công cụ của trình kết nối, mới nhất trước, trừ những công cụ mà yêu cầu vẫn phải gọi, rồi đến kỹ năng cũ nhất. Nếu thao tác cần thiết vẫn không vừa, lượt đó dừng lại với "The required connector operation is too large for this model's context window." (thao tác cần thiết của trình kết nối quá lớn so với cửa sổ ngữ cảnh của mô hình này).

Mô tả công cụ được cắt còn 500 ký tự, và kết quả được đánh dấu là dữ liệu không đáng tin, để mô hình coi văn bản từ một trang hay một issue là nội dung chứ không phải chỉ dẫn. Kết quả vượt ngân sách sẽ được nén gọn: các trường phân trang được giữ trước tiên, liên kết và chuỗi hash dài bị bỏ, mỗi đối tượng trong danh sách giữ tối đa 12 trường, và chuỗi dài được rút ngắn, kèm một ghi chú báo cho mô hình biết điều đó.

Trong các cuộc trò chuyện dài, Orvena giữ nguyên các lượt gần đây trong cửa sổ của mô hình và bỏ những lượt cũ nhất. Nó không tóm tắt. Khi ngay cả như vậy vẫn không vừa, Apple Intelligence hiển thị "Cuộc trò chuyện này quá dài đối với Apple Intelligence. Hãy bắt đầu cuộc trò chuyện mới, hoặc chuyển sang mô hình đã tải về của Orvena trong Mô hình."

Phê duyệt trước khi có gì bị thay đổi hoặc rời đi

Orvena phân loại từng công cụ MCP dựa trên các gợi ý mà máy chủ của nó khai báo: công cụ chỉ đọc hiển thị "Đọc dữ liệu mà không thay đổi.", công cụ mang tính phá hủy hiển thị "Xóa, hủy hoặc thực hiện một hành động không thể hoàn tác.", và phần còn lại hiển thị "Tạo hoặc thay đổi dữ liệu."

• Công cụ đọc và ghi hỏi ở lần đầu. Bảng phê duyệt, với tiêu đề "PHÊ DUYỆT HÀNH ĐỘNG NÀY", có "Không cho phép" và "Cho phép", cùng "Cho phép một lần" hoặc "Luôn cho phép" trong menu của nó.
• Công cụ mang tính phá hủy hỏi mỗi lần, và chỉ có "Cho phép một lần".
• Bảng liệt kê chính xác các tham số, trong đó token, mật khẩu và các trường giống thông tin xác thực khác hiện thành [REDACTED CREDENTIAL], và cho biết chúng được gửi đến đâu, ví dụ "Gửi dữ liệu cần thiết cho tác vụ này đến Notion."
• Nếu cùng lượt đó đã đọc thông tin cá nhân, như lịch của bạn hoặc kết quả của một trình kết nối khác, bảng phê duyệt có tiêu đề "Send data to" (gửi dữ liệu đến) kèm tên dịch vụ. Sau khi có dữ liệu Sức khỏe, nó hỏi mỗi lần.

Private Cloud Compute hỏi một lần, khi bạn chọn nó trong Mô hình, và cho biết mỗi câu trả lời sẽ gửi "cuộc trò chuyện của bạn và các kết quả công cụ cần thiết tới máy chủ của Apple". Sau đó, các lần phê duyệt trình kết nối hiển thị "Notion → Private Cloud Compute" làm đích đến. OpenRouter hỏi trước yêu cầu đầu tiên trong một cuộc trò chuyện, và hỏi lại với "Dùng OpenRouter với dữ liệu nhạy cảm?" khi lịch sử đã có kết quả từ trình kết nối. Các quyền đã lưu nằm trong Cài đặt, Chia sẻ dữ liệu, nơi bạn có thể thu hồi chúng.

Dữ liệu đi đâu

Lưu lượng của trình kết nối đi thẳng từ iPhone đến dịch vụ, không qua máy chủ Orvena nào. Dịch vụ và máy chủ đăng nhập của nó nhận các tham số bạn đã phê duyệt, nội dung chúng trả về và lưu lượng đăng nhập. Token nằm trong Chuỗi khóa của iPhone, chỉ trên thiết bị này. Với Apple Intelligence hoặc mô hình của Orvena, kết quả được đọc ngay trên điện thoại; với Private Cloud Compute, những kết quả mà câu trả lời cần sẽ được gửi đến Apple, còn với OpenRouter thì đến OpenRouter sau khi bạn đồng ý. Mục Hoạt động trong Cài đặt lưu tối đa 30 ngày tên công cụ, kết quả thực hiện và đích đến, không bao giờ lưu tham số. Ngắt kết nối sẽ xóa thông tin xác thực và công cụ trên máy, và hộp xác nhận nhắc bạn thu hồi quyền truy cập ở phía dịch vụ nữa, ví dụ "Bạn có thể vẫn cần thu hồi quyền của Orvena trong cài đặt tài khoản của Notion." Bức tranh toàn cảnh có trong bài điều gì làm nên một trợ lý AI riêng tư.

Khắc phục sự cố

Câu hỏi thường gặp

Tôi có thể chạy máy chủ MCP trên iPhone không?

Không phải bên trong Orvena. Orvena là một MCP client kết nối với máy chủ từ xa qua HTTPS bằng MCP streamable HTTP. Máy chủ stdio cục bộ không thể chạy bên trong Orvena, vì vậy hãy chạy nó ở nơi khác sau một cầu nối HTTPS rồi thêm địa chỉ đó trong Máy chủ của riêng bạn.

Apple Intelligence có dùng được công cụ MCP không?

Trong Orvena thì có. Trên iOS 27, Orvena cung cấp cho mô hình trên thiết bị của Apple và Private Cloud Compute các công cụ của những máy chủ bạn kết nối, đã chuyển sang định dạng của framework Foundation Models của Apple. Tại mỗi thời điểm, nó chỉ tải một hoặc hai dịch vụ và tối đa tám thao tác của chúng, nhờ đó các định nghĩa công cụ đủ nhỏ để vừa với cửa sổ trên thiết bị.

Làm sao kết nối Home Assistant với trợ lý AI trên iPhone qua MCP?

Thêm tích hợp Model Context Protocol Server trong Home Assistant và tạo một long-lived access token (token truy cập dài hạn) trong hồ sơ của bạn, mục Security. Trong Orvena, chạm Kết nối trên Home Assistant, nhập địa chỉ HTTPS kết thúc bằng /api/mcp, rồi dán token. Địa chỉ http thông thường sẽ bị từ chối, kể cả trong mạng gia đình của bạn.

Tôi có thể dùng máy chủ MCP của Notion trên iPhone không?

Có. Notion là một trong sáu trình kết nối có sẵn của Orvena. Chạm Kết nối trong Cài đặt, Kết nối, đăng nhập Notion và cấp quyền truy cập. Orvena dùng máy chủ do Notion vận hành tại mcp.notion.com và hỏi trước khi một công cụ Notion chạy lần đầu. Kết nối thuộc Premium Unlock.

Có phải mọi hành động MCP đều cần phê duyệt không?

Hành động mang tính phá hủy hỏi mỗi lần. Công cụ đọc, tạo hoặc thay đổi dữ liệu hỏi ở lần đầu, và bạn có thể chọn Luôn cho phép. Quyền đó được liệt kê trong Cài đặt, Chia sẻ dữ liệu, Công cụ được phép, nơi bạn có thể thu hồi nó.