MCP-клієнт на iPhone: конектори зі списку, ваш власний сервер і обмеження
Orvena є MCP-клієнтом для iPhone. Вона під'єднує асистента до Notion, Linear, GitHub, Jira & Confluence, Zapier і Home Assistant або до сервера MCP, який ви запускаєте самі, і дає Apple Intelligence, Private Cloud Compute, власній моделі Orvena чи моделі OpenRouter викликати їхні інструменти. У цьому посібнику описано екрани налаштування з їхніми назвами, вимоги до власного сервера, як інструменти вміщуються в невелике контекстне вікно і які підтвердження ви побачите, перш ніж щось буде змінено чи надіслано.
Що робить MCP-клієнт на iPhone
MCP, Model Context Protocol, є відкритим стандартом для під'єднання сервісів до ШІ-асистентів. Сервіс запускає сервер MCP, який перелічує свої інструменти, кожен із назвою, описом і аргументами, які він приймає, а клієнт викликає інструмент, коли про це просить модель. Orvena є клієнтом і зв'язується з кожним сервером через HTTPS напряму з вашого iPhone.
Orvena під'єднується лише до віддалених серверів через MCP streamable HTTP. Локальний сервер stdio, який настільний застосунок запускає як команду, не може працювати всередині Orvena, тож розмістіть його за віддаленим HTTPS-мостом і додайте адресу мосту.
Конектори, які пропонує Orvena
Відкрийте меню вгорі ліворуч, потім «Параметри», потім «З'єднання» (рядок із заголовком "Підключіть свої сервіси"). Версія 2.0.0 пропонує шість сервісів:
| Конектор | Вхід | Що він дає змогу робити |
|---|---|---|
| Notion | OAuth | Знаходити сторінки, бази даних і вміст робочого простору та працювати з ними. |
| Linear | OAuth, читання й запис | Знаходити задачі, проєкти, команди й дані планування та працювати з ними. |
| GitHub | Одноразовий код, без персонального токена доступу | Знаходити репозиторії, код, задачі й pull requests та працювати з ними. |
| Jira & Confluence | OAuth, 13 областей дії, зокрема запис робочих елементів Jira і сторінок Confluence | Знаходити робочі елементи Jira, а також простори, сторінки й коментарі Confluence та працювати з ними. |
| Zapier | Токен підключення | Користуватися застосунками й діями, налаштованими на вашому сервері Zapier MCP. |
| Home Assistant | Токен доступу та ваша HTTPS-адреса | Переглядати пристрої, сутності, сцени й автоматизації, які він надає, і керувати ними. |
Модель читає ці описи, щоб вирішити, який сервіс потрібен для запиту. Кожен сервер після входу повідомляє власні інструменти, а рядок показує їхню кількість. Slack, Figma, Canva, Todoist і PayPal у списку немає, бо Orvena поки не може виконати їхні вимоги до входу.
- Торкніться «Під'єднати» на картці. Без Premium Unlock на кнопці написано «Premium», і вона відкриває екран покупки.
- Для Notion, Linear і Jira & Confluence власна сторінка входу сервісу відкривається у вікні, щойно сервер попросить увійти. Надайте доступ там.
- Для GitHub вікно із заголовком "Авторизувати Orvena" показує одноразовий код. Торкніться "Скопіювати код і відкрити GitHub", вставте код і підтвердьте. Доки GitHub не підтвердить, у вікні видно "Очікування авторизації…".
- Сервіс переміщується у верхній список, а його статус змінюється з "Підключення…" на кількість інструментів.
Home Assistant MCP на iPhone і Zapier
Обидва використовують токен замість сторінки входу. У Home Assistant додайте інтеграцію "Model Context Protocol Server", потім створіть токен у своєму профілі, на вкладці безпеки, у розділі довгострокових токенів доступу (Long-lived access tokens). В Orvena торкніться «Під'єднати» на Home Assistant, введіть адресу в полі "Де він розташований?", наприклад https://your-home:8123/api/mcp, і вставте токен.
Тут Orvena вимагає HTTPS навіть у вашій власній мережі, тож не надсилатиме токен на адресу http://, як-от http://homeassistant.local:8123 чи локальну IP-адресу через http://. З адресою http:// кнопка «Під'єднати» у вікні нічого не робить. Для Home Assistant потрібен дійсний сертифікат TLS або довірений зворотний проксі з HTTPS.
Zapier просить лише токен: на mcp.zapier.com створіть сервер, виберіть його застосунки й скопіюйте токен підключення з вкладки Connect.
Як додати власний сервер MCP
Остання картка в розділі «З'єднання», "Ваш власний сервер", відкриває екран "Власний сервер". URL має починатися з https://, містити ім'я хоста й не містити імені користувача, пароля чи #фрагмента. Сервер має працювати через MCP streamable HTTP, відповідаючи звичайним JSON або потоком SSE, і підтримувати версію протоколу 2025-11-25, 2025-06-18 або 2025-03-26. Переспрямування мають залишатися в межах того самого джерела (origin), а сервер, який не повідомляє жодних інструментів, не зберігається.
- Заповніть поле «Назва» та поле адреси, у якому як підказку показано https://server.example/mcp.
- Якщо сервер використовує ключ API чи токен, вставте його в поле "Bearer token (optional)" (токен Bearer, необов'язково). Якщо поле порожнє, Orvena спершу пробує відкритий доступ, а потім вхід.
- Якщо сервер OAuth не вказує, які області дії йому потрібні, введіть їх у поле "OAuth scopes, space-separated (optional)" (області дії OAuth через пробіл, необов'язково).
- У полі "З чим може допомогти цей сервер? (необов'язково)" напишіть речення про те, для чого він.
- Торкніться "Додати сервер". Поки Orvena під'єднується й отримує список інструментів, на кнопці видно "Перевірка…".
Orvena починає OAuth лише після HTTP 401, 403 або виклику WWW-Authenticate, а сервер авторизації має підтримувати PKCE з S256.
Рядок призначення Orvena використовує лише для того, щоб вирішити, коли завантажувати сервер. Без нього вона складає опис кожного сервера щонайбільше з чотирьох описів інструментів, обрізаних до 320 символів. Якщо в якогось інструмента немає опису, рядок показує "Add a purpose so Orvena can choose this server reliably." (додайте призначення, щоб Orvena могла надійно вибирати цей сервер), а якщо опису немає в жодного, сервер використовується лише тоді, коли ви називаєте його. Виправити це можна пунктом "Опишіть призначення" в меню ••• рядка.
Що потребує Premium Unlock
Його потребують усі під'єднання: шість сервісів зі списку й будь-який сервер, який ви додаєте самі. Premium Unlock є одноразовою покупкою за 14,99 $ без підписки, і він також додає Private Cloud Compute в iOS 27, хмарні моделі з вашим власним ключем OpenRouter, голосові розмови й заплановані завдання. Apple Intelligence і завантажена модель Orvena безкоштовні, але без Premium Unlock вони відповідають без інструментів конекторів.
MCP з Apple Intelligence та іншими рушіями
Усі чотири рушії на екрані «Моделі» отримують інструменти конекторів. Для Apple Intelligence і Private Cloud Compute Orvena перетворює JSON-схему кожного інструмента MCP у формат схем фреймворку Foundation Models від Apple. Якщо схема інструмента використовує щось, чого фреймворк не може виразити, моделі Apple отримують цей інструмент без аргументів, тож для нього користуйтеся моделлю Orvena чи OpenRouter. Виняток становить модель OpenRouter, яку вказано без підтримки інструментів: "Ця модель не може використовувати інструменти, тож Orvena відповідатиме без них."
| Рушій | Де працює | Контекстне вікно | Результат інструмента, який бачить модель |
|---|---|---|---|
| Apple Intelligence | Цей iPhone, iOS 27 | Зчитується з iOS під час роботи: під час тестування в iOS 27 це було 8 192 токени, хоча документація Apple називає 4 096 | До 2 400 символів |
| Модель Orvena | Цей iPhone (Qwen 3.5 4B, 3,1 GB) | 16 384 токени | До 4 000 символів |
| Private Cloud Compute | Сервери Apple, iOS 27, Premium | 32 768 токенів | До 4 000 символів |
| OpenRouter | OpenRouter, ваш власний ключ, Premium | Заявлена довжина моделі, 60 000, якщо вона невідома, щонайбільше 120 000 | До 4 000 символів |
«Автоматично», стандартне налаштування рушія, ніколи не вибирає Private Cloud Compute чи OpenRouter самостійно.
Як списки інструментів і результати вміщуються в мале вікно
У вікні на 8 192 токени мало місця для десятків визначень інструментів, тож інструменти конекторів ніколи не передаються моделі всі одразу. Спершу модель викликає load_connectors, щоб вибрати один чи два сервіси зі списку під'єднаних, кожен з яких описано щонайбільше 180 символами (загалом 8 192 символи). Потім load_tools вибирає з них від однієї до восьми операцій. Викликати можна лише їх.
Перед кожним раундом моделі Orvena підсумовує інструкції, схеми завантажених інструментів і 900 токенів запасу. Якщо сума перевищує вікно мінус 512 токенів, вона відкидає інструменти конекторів, починаючи з найновіших, крім тих, які запит ще має викликати, а потім найстарішу навичку. Якщо потрібна операція все одно не вміщується, відповідь переривається з повідомленням "The required connector operation is too large for this model's context window." (потрібна операція конектора завелика для контекстного вікна цієї моделі).
Описи інструментів обрізаються до 500 символів, а результати позначаються як недовірені дані, що вказує моделі сприймати текст зі сторінки чи задачі як вміст, а не як інструкції. Результат, що перевищує бюджет, ущільнюється: першими йдуть поля пагінації, посилання й довгі хеші прибираються, об'єкти у списку зберігають щонайбільше 12 полів, а довгі рядки скорочуються, про що модель отримує примітку.
У довгих розмовах Orvena зберігає останні репліки повністю в межах вікна рушія й відкидає найстаріші. Підсумків вона не робить. Коли не вміщується навіть так, Apple Intelligence показує "Ця розмова задовга для Apple Intelligence. Почніть нову розмову або перейдіть на завантажену модель Orvena в розділі «Моделі»."
Підтвердження, перш ніж щось зміниться чи піде назовні
Orvena класифікує кожен інструмент MCP за підказками, які оголошує його сервер: інструменти лише для читання показують "Читає дані, не змінюючи їх.", руйнівні "Видаляє, скасовує або виконує незворотну дію.", а решта "Створює або змінює дані."
- Інструменти читання й запису запитують першого разу. Вікно із заголовком "ПІДТВЕРДЬТЕ ЦЮ ДІЮ" має кнопки "Не дозволяти" і "Дозволити", а в його меню є "Дозволити один раз" або "Завжди дозволяти".
- Руйнівні інструменти запитують щоразу, лише з варіантом "Дозволити один раз".
- Вікно показує точні аргументи, де токени, паролі й інші поля, схожі на облікові дані, відображаються як [REDACTED CREDENTIAL], і вказує, куди вони підуть, наприклад "Надсилає дані, потрібні для цієї дії, до Notion."
- Якщо під час тієї самої відповіді вже було прочитано щось особисте, як-от ваш календар чи результат іншого конектора, підтвердження має заголовок "Send data to" (надіслати дані до) і назву сервісу. Після даних зі «Здоров'я» воно запитує щоразу.
Private Cloud Compute запитує один раз, коли ви вибираєте його в «Моделі», і повідомляє, що кожна відповідь надсилає "вашу розмову й потрібні їй результати інструментів на сервери Apple." Після цього підтвердження конекторів показують як призначення "Notion → Private Cloud Compute". OpenRouter запитує перед першим запитом у розмові й ще раз, із питанням "Використати OpenRouter з чутливими даними?", щойно в історії з'являється результат конектора. Збережені дозволи можна знайти в «Параметрах», у розділі «Обмін даними», і там же їх відкликати.
Куди йдуть дані
Трафік конекторів іде з iPhone прямо до сервісу, без сервера Orvena посередині. Сервіс і його сервер входу отримують підтверджені вами аргументи, вміст, який вони повертають, і трафік входу. Токени зберігаються у «Зв'язці ключів» iPhone, лише на цьому пристрої. З Apple Intelligence чи моделлю Orvena результати читаються на телефоні; з Private Cloud Compute результати, потрібні для відповіді, ідуть до Apple, а з OpenRouter до OpenRouter, після вашої згоди. Розділ «Активність» у «Параметрах» зберігає до 30 днів назви інструментів, результати виконання й призначення, але ніколи не аргументи. «Від'єднати» видаляє локальні облікові дані й інструменти, а підтвердження нагадує відкликати доступ і в самому сервісі, наприклад "Можливо, доступ Orvena також доведеться відкликати в параметрах облікового запису Notion." Ширшу картину описано в статті що робить ШІ-асистента приватним.
Усунення проблем
| Що ви бачите | Що перевірити |
|---|---|
| "Enter a complete HTTPS server URL." (введіть повну HTTPS-адресу сервера) | Почніть адресу з https:// і вкажіть ім'я хоста. |
| "Сервер повернув відповідь, яку Orvena не може використати." | Приберіть з адреси частину user:password@ і все, що йде після #. Якщо адреса чиста, сервер надіслав відповідь, яку Orvena не змогла прочитати. |
| "Couldn't reach the server. Check your connection and server address." (не вдалося зв'язатися із сервером) | Адресу, DNS і сертифікат TLS, з того місця, де перебуває телефон. |
| "Сервер відхилив це підключення. Перевірте вхід або токен." | Перевірте токен або створіть новий і під'єднайтеся знову. |
| "This server doesn't support compatible sign-in. Use a token if it offers one." (сервер не підтримує сумісного входу) | Вставте токен у поле "Bearer token (optional)". |
| "Потрібно увійти" або "Не вдалося підключитися" | «Перепід'єднати» або «Повторити» в меню •••. |
| "The latest tool result is too large for this model's context window. Try a narrower request." (останній результат інструмента завеликий для цієї моделі) | Попросіть одну сторінку чи задачу або виберіть рушій із більшим вікном. |
| "Можливо, дію вже виконано. Перевірте сервіс, перш ніж повторювати." | Перевірте в сервісі, перш ніж повторювати дію. |
| "Відновлення віддалених дій потребує перевірки" | Нові віддалені дії призупинено. Перевірте кожен сервіс, потім торкніться "Усі призначення перевірено". |
Поширені запитання
Чи можна запустити сервер MCP на iPhone?
Не всередині Orvena. Orvena є MCP-клієнтом, який під'єднується до віддалених серверів через HTTPS за допомогою MCP streamable HTTP. Локальний сервер stdio не може працювати всередині Orvena, тож запустіть його деінде за HTTPS-мостом і додайте цю адресу через картку «Ваш власний сервер».
Чи може Apple Intelligence користуватися інструментами MCP?
В Orvena може. В iOS 27 Orvena дає моделі Apple на пристрої та Private Cloud Compute інструменти під'єднаних вами серверів, перетворені у формат фреймворку Foundation Models від Apple. У кожен момент завантажено один чи два сервіси й щонайбільше вісім їхніх операцій, завдяки чому визначення інструментів лишаються достатньо компактними для вікна моделі на пристрої.
Як під'єднати Home Assistant до ШІ-асистента на iPhone через MCP?
Додайте в Home Assistant інтеграцію Model Context Protocol Server і створіть довгостроковий токен доступу у своєму профілі, на вкладці безпеки. В Orvena торкніться «Під'єднати» на Home Assistant, введіть HTTPS-адресу, що закінчується на /api/mcp, і вставте токен. Звичайні адреси http не приймаються, зокрема й у домашній мережі.
Чи можна користуватися сервером Notion MCP на iPhone?
Так. Notion є одним із шести конекторів у списку Orvena. У «Параметрах», у розділі «З'єднання», торкніться «Під'єднати», увійдіть у Notion і надайте доступ. Orvena використовує розміщений сервер Notion на mcp.notion.com і запитує дозволу, перш ніж інструмент Notion запуститься вперше. Під'єднання входять до Premium Unlock.
Чи кожна дія MCP запитує підтвердження?
Руйнівні дії запитують щоразу. Інструменти, які читають, створюють чи змінюють дані, запитують першого разу, і можна вибрати «Завжди дозволяти». Такий дозвіл можна знайти в «Параметрах», у розділі «Обмін даними», підрозділ «Дозволені інструменти», і там же його відкликати.
Orvena безкоштовна в App Store для iPhone 15 Pro і новіших. Premium Unlock, одна покупка, додає шість конекторів зі списку й будь-який сервер MCP, який ви додасте.
Завантажити в App Store