Ako používať klienta MCP v iPhone: ponúkané konektory, vlastný server a limity
Orvena je klient MCP pre iPhone. Pripojí asistenta k službám Notion, Linear, GitHub, Jira & Confluence, Zapier a Home Assistant alebo k serveru MCP, ktorý prevádzkujete sami, a umožní, aby ich nástroje volala Apple Intelligence, Private Cloud Compute, vlastný model aplikácie Orvena alebo model z OpenRouter. Tento návod opisuje obrazovky nastavenia podľa ich názvov, pravidlá, ktoré musí spĺňať vlastný server, ako sa nástroje zmestia do malého kontextového okna a schválenia, ktoré uvidíte skôr, než sa čokoľvek zmení alebo odošle.
Čo robí klient MCP v iPhone
MCP (Model Context Protocol) je otvorený štandard na pripájanie služieb k AI asistentom. Služba prevádzkuje server MCP, ktorý uvádza svoje nástroje, každý s názvom, popisom a argumentmi, ktoré prijíma, a klient nástroj zavolá, keď oň model požiada. Orvena je klient, ktorý s každým serverom komunikuje cez HTTPS priamo z vášho iPhone.
Orvena sa pripája len k vzdialeným serverom cez MCP streamable HTTP. Lokálny server stdio, aký desktopová aplikácia spúšťa ako príkaz, v aplikácii Orvena bežať nemôže, preto ho umiestnite za vzdialený most HTTPS a pridajte adresu tohto mosta.
Konektory, ktoré Orvena ponúka
Otvorte ponuku vľavo hore, potom Nastavenia a Pripojenia (riadok s názvom "Pripojte svoje veci"). Verzia 2.0.0 ponúka šesť služieb:
| Konektor | Prihlásenie | Čo umožňuje |
|---|---|---|
| Notion | OAuth | Vyhľadávať stránky, databázy a obsah pracovného priestoru a pracovať s nimi. |
| Linear | OAuth, čítanie aj zápis | Vyhľadávať issues, projekty, tímy a plánovacie údaje a pracovať s nimi. |
| GitHub | Jednorazový kód, bez osobného prístupového tokenu | Vyhľadávať repozitáre, kód, issues a pull requesty a pracovať s nimi. |
| Jira & Confluence | OAuth, 13 rozsahov vrátane zápisu pracovných položiek v Jira a stránok v Confluence | Vyhľadávať pracovné položky v Jira a priestory, stránky a komentáre v Confluence a pracovať s nimi. |
| Zapier | Token pripojenia | Používať aplikácie a akcie nastavené na vašom serveri Zapier MCP. |
| Home Assistant | Prístupový token a vaša adresa HTTPS | Prezerať a ovládať zariadenia, entity, scény a automatizácie, ktoré sprístupňuje. |
Model podľa týchto popisov rozhoduje, ktorú službu požiadavka potrebuje. Každý server po prihlásení nahlási vlastné nástroje a riadok ukazuje ich počet. Slack, Figma, Canva, Todoist a PayPal v zozname nie sú, pretože Orvena dnes nevie splniť ich požiadavky na prihlásenie.
- Na karte klepnite na Pripojiť. Bez Premium Unlock je na tlačidle nápis Premium a otvorí obrazovku nákupu.
- Pri službách Notion, Linear a Jira & Confluence sa prihlasovacia stránka danej služby otvorí v okne, keď o prihlásenie požiada server. Tam prístup schváľte.
- Pri GitHube zobrazí okno s názvom "Autorizovať Orvenu" jednorazový kód. Klepnite na "Skopírovať kód a otvoriť GitHub", vložte kód a schváľte prístup. Kým GitHub nepotvrdí, okno ukazuje "Čaká sa na autorizáciu…".
- Služba sa presunie do horného zoznamu a jej stav sa zmení z "Pripája sa…" na počet nástrojov.
Home Assistant MCP v iPhone a Zapier
Obe služby namiesto prihlasovacej stránky používajú token. V Home Assistant pridajte integráciu "Model Context Protocol Server" a potom vo svojom profile v časti Security, Long-lived access tokens vytvorte dlhodobý prístupový token. V aplikácii Orvena klepnite pri Home Assistant na Pripojiť, do poľa "Kde sa nachádza?" zadajte adresu, napríklad https://your-home:8123/api/mcp, a vložte token.
Orvena tu vyžaduje HTTPS aj vo vašej vlastnej sieti, takže token nepošle na adresu http://, ako je http://homeassistant.local:8123 alebo lokálna IP adresa cez http://. S adresou http:// tlačidlo Pripojiť v okne nič neurobí. Home Assistant potrebuje platný certifikát TLS alebo dôveryhodný reverzný proxy server s HTTPS.
Zapier si vypýta len token: na mcp.zapier.com vytvorte server, vyberte jeho aplikácie a na karte Connect skopírujte token pripojenia.
Ako pridať vlastný server MCP
Posledná karta v Pripojeniach, "Váš vlastný server", otvorí "Vlastný server". URL musí používať https:// s názvom hostiteľa a nesmie obsahovať meno používateľa, heslo ani #fragment. Server musí podporovať MCP streamable HTTP, odpovedať čistým JSON alebo prúdom SSE a podporovať verziu protokolu 2025-11-25, 2025-06-18 alebo 2025-03-26. Presmerovania musia zostať v rámci rovnakého pôvodu (origin) a server, ktorý nenahlási žiadne nástroje, sa neuloží.
- Vyplňte Názov a pole adresy, ktorého zástupný text je https://server.example/mcp.
- Ak server používa kľúč API alebo token, vložte ho do poľa "Bearer token (optional)" (voliteľný token). Ak ho necháte prázdne, Orvena skúsi otvorený prístup a potom prihlásenie.
- Ak server OAuth neuvádza, ktoré rozsahy potrebuje, zadajte ich do poľa "OAuth scopes, space-separated (optional)" (rozsahy OAuth oddelené medzerami, voliteľné).
- Do poľa "S čím môže tento server pomôcť? (voliteľné)" napíšte vetu o tom, na čo server slúži.
- Klepnite na "Pridať server". Kým sa Orvena pripája a načítava nástroje, zobrazuje sa "Kontroluje sa…".
Orvena začne OAuth až po odpovedi HTTP 401, 403 alebo výzve WWW-Authenticate a autorizačný server musí podporovať PKCE s S256.
Vetu o účele Orvena používa len na to, aby rozhodla, kedy server načítať. Bez neho zostaví súhrn každého servera z najviac štyroch popisov nástrojov, skrátený na 320 znakov. Ak niektorému nástroju chýba popis, riadok ukáže "Add a purpose so Orvena can choose this server reliably." (doplňte účel, aby Orvena mohla server spoľahlivo vyberať), a ak popis nemá žiadny nástroj, server sa použije len vtedy, keď ho výslovne pomenujete. Napravíte to cez "Opíšte účel" v ponuke ••• daného riadka.
Čo vyžaduje Premium Unlock
Vyžadujú ho všetky pripojenia: šesť ponúkaných služieb aj každý server, ktorý pridáte sami. Premium Unlock je jednorazový nákup za 14,99 USD bez predplatného a pridáva aj Private Cloud Compute v iOS 27, cloudové modely s vaším vlastným kľúčom OpenRouter, hlasové konverzácie a naplánované úlohy. Apple Intelligence a stiahnutý model aplikácie Orvena sú zadarmo, no bez odomknutia odpovedajú bez nástrojov konektorov.
Používanie MCP s Apple Intelligence a ďalšími modelmi
Všetky štyri enginy na obrazovke Modely dostávajú nástroje konektorov. Pre Apple Intelligence a Private Cloud Compute Orvena prevedie schému JSON každého nástroja MCP do formátu schém frameworku Foundation Models od Apple. Ak schéma nástroja používa niečo, čo framework nedokáže vyjadriť, modely Apple dostanú tento nástroj bez argumentov, preto naň použite model aplikácie Orvena alebo OpenRouter. Výnimkou je model z OpenRouter uvedený bez podpory nástrojov: "Tento model nevie používať nástroje, takže Orvena odpovie bez nich."
| Engine | Kde beží | Kontextové okno | Výsledok nástroja, ktorý model vidí |
|---|---|---|---|
| Apple Intelligence | Tento iPhone, iOS 27 | Načítané z iOS počas behu: v testoch 8 192 tokenov v iOS 27, hoci dokumentácia Apple uvádza 4 096 | Najviac 2 400 znakov |
| Model aplikácie Orvena | Tento iPhone (Qwen 3.5 4B, 3,1 GB) | 16 384 tokenov | Najviac 4 000 znakov |
| Private Cloud Compute | Servery Apple, iOS 27, Premium | 32 768 tokenov | Najviac 4 000 znakov |
| OpenRouter | OpenRouter, váš vlastný kľúč, Premium | Dĺžka uvedená pre model, 60 000, ak nie je známa, najviac 120 000 | Najviac 4 000 znakov |
Automaticky, predvolené nastavenie enginu, nikdy samo nevyberie Private Cloud Compute ani OpenRouter.
Ako sa zoznamy nástrojov a výsledky zmestia do malého okna
V okne s 8 192 tokenmi je málo miesta pre desiatky definícií nástrojov, preto sa nástroje konektorov nikdy neposielajú modelu všetky naraz. Model najprv zavolá load_connectors a zo zoznamu pripojených služieb vyberie jednu alebo dve, pričom každá je opísaná najviac 180 znakmi (spolu 8 192 znakov). Potom cez load_tools z nich vyberie jednu až osem operácií. Volať sa dajú len tie.
Pred každým kolom modelu Orvena spočíta inštrukcie, načítané schémy nástrojov a rezervu 900 tokenov. Ak súčet presiahne okno mínus 512 tokenov, vyradí nástroje konektorov, od najnovších, okrem tých, ktoré požiadavka ešte musí zavolať, a potom najstaršiu zručnosť. Ak sa potrebná operácia ani potom nezmestí, odpoveď sa zastaví s hláškou "The required connector operation is too large for this model's context window." (potrebná operácia konektora je pre kontextové okno tohto modelu príliš veľká).
Popisy nástrojov sa skracujú na 500 znakov a výsledky sú označené ako nedôveryhodné údaje, čo modelu hovorí, aby text zo stránky alebo z issue považoval za obsah, nie za pokyny. Výsledok nad limit sa zhustí: stránkovacie polia idú na začiatok, odkazy a dlhé hashe sa odstránia, objekty v zozname si ponechajú najviac 12 polí a dlhé reťazce sa skrátia, spolu s poznámkou, ktorá to modelu oznámi.
V dlhých konverzáciách Orvena ponecháva celé nedávne výmeny v rámci okna modelu a najstaršie vyradí. Nič nezhrňuje. Keď sa nezmestí ani to, Apple Intelligence ukáže "Táto konverzácia je pre Apple Intelligence príliš dlhá. Začnite novú konverzáciu alebo prepnite na stiahnutý model Orveny v časti Modely."
Schválenia predtým, než sa niečo zmení alebo odošle
Orvena zaraďuje každý nástroj MCP podľa príznakov (hints), ktoré deklaruje jeho server: nástroje len na čítanie ukazujú "Číta údaje bez toho, aby ich menil.", deštruktívne "Odstraňuje, ruší alebo vykonáva nezvratnú akciu." a ostatné "Vytvára alebo mení údaje."
- Nástroje na čítanie a zápis sa pýtajú pri prvom použití. Okno s hlavičkou "SCHVÁLIŤ TÚTO AKCIU" má tlačidlá "Nepovoliť" a "Povoliť" a v ponuke "Povoliť raz" alebo "Vždy povoliť".
- Deštruktívne nástroje sa pýtajú zakaždým, a to len s možnosťou "Povoliť raz".
- Okno uvádza presné argumenty, pričom tokeny, heslá a ďalšie polia podobné prihlasovacím údajom sa zobrazia ako [REDACTED CREDENTIAL], a hovorí, kam idú, napríklad "Odošle údaje potrebné na túto akciu do Notion."
- Ak sa v tom istom kole už čítalo niečo osobné, napríklad váš kalendár alebo výsledok iného konektora, schválenie má názov "Send data to" (odoslať údaje do) a za ním názov služby. Po údajoch zo Zdravia sa pýta zakaždým.
Private Cloud Compute sa opýta raz, keď ho vyberiete v Modeloch, a upozorní, že každá odpoveď odošle "vašu konverzáciu a potrebné výsledky nástrojov na servery Apple." Schválenia konektorov potom ako cieľ ukazujú "Notion → Private Cloud Compute". OpenRouter sa pýta pred prvou požiadavkou v konverzácii a znova otázkou "Použiť OpenRouter s citlivými údajmi?", keď je v histórii výsledok konektora. Uložené povolenia sú v Nastaveniach v časti Zdieľanie údajov, kde ich môžete odvolať.
Kam idú údaje
Prevádzka konektorov ide z iPhone priamo do služby, bez servera Orvena medzi nimi. Služba a jej prihlasovací server dostanú argumenty, ktoré ste schválili, obsah, ktorý vracajú, a prihlasovaciu komunikáciu. Tokeny zostávajú v Kľúčenke v iPhone, len v tomto zariadení. Pri Apple Intelligence alebo modeli aplikácie Orvena sa výsledky čítajú v telefóne; pri Private Cloud Compute idú výsledky, ktoré odpoveď potrebuje, do Apple a pri OpenRouter po vašom súhlase do OpenRouter. Časť Aktivita v Nastaveniach uchováva až 30 dní názvy nástrojov, výsledky volaní a ciele, nikdy nie argumenty. Tlačidlo Odpojiť odstráni lokálne prihlasovacie údaje a nástroje a potvrdenie vám pripomenie, aby ste prístup odvolali aj v samotnej službe, napríklad "Orvenu možno budete musieť ešte odvolať v nastaveniach účtu služby Notion." Širší obraz ponúka článok čo robí AI asistenta súkromným.
Riešenie problémov
| Čo vidíte | Čo skontrolovať |
|---|---|
| "Enter a complete HTTPS server URL." (zadajte úplnú URL servera HTTPS) | Adresa musí začínať https:// a obsahovať názov hostiteľa. |
| "Server vrátil odpoveď, ktorú Orvena nemôže použiť." | Z adresy odstráňte časť user:password@ a všetko za #. Ak je adresa čistá, server poslal odpoveď, ktorú Orvena nevedela prečítať. |
| "Couldn't reach the server. Check your connection and server address." (server je nedostupný, skontrolujte pripojenie a adresu) | Adresu, DNS a certifikát TLS, a to z miesta, kde je telefón. |
| "Server toto pripojenie odmietol. Skontrolujte prihlásenie alebo token." | Skontrolujte token alebo vytvorte nový a pripojte sa znova. |
| "This server doesn't support compatible sign-in. Use a token if it offers one." (server nepodporuje kompatibilné prihlásenie, použite token, ak ho ponúka) | Vložte token do poľa "Bearer token (optional)". |
| "Vyžaduje sa prihlásenie" alebo "Pripojenie zlyhalo" | Znova pripojiť alebo Skúsiť znova v ponuke •••. |
| "The latest tool result is too large for this model's context window. Try a narrower request." (posledný výsledok nástroja je pre okno modelu príliš veľký, skúste užšiu požiadavku) | Požiadajte o jednu stránku alebo issue, alebo vyberte model s väčším oknom. |
| "Akcia sa možno vykonala. Pred ďalším pokusom skontrolujte službu." | Pred zopakovaním akcie sa pozrite do služby. |
| "Obnova vzdialených akcií vyžaduje kontrolu" | Nové vzdialené akcie sú pozastavené. Skontrolujte každú službu a potom klepnite na "Všetky ciele skontrolované". |
Časté otázky
Môžem spustiť server MCP priamo v iPhone?
V aplikácii Orvena nie. Orvena je klient MCP, ktorý sa pripája k vzdialeným serverom cez HTTPS pomocou MCP streamable HTTP. Lokálny server stdio v aplikácii Orvena bežať nemôže, preto ho spustite inde za mostom HTTPS a jeho adresu pridajte v časti Váš vlastný server.
Dokáže Apple Intelligence používať nástroje MCP?
V aplikácii Orvena áno. V iOS 27 dá Orvena modelu Apple v zariadení aj Private Cloud Compute nástroje serverov, ktoré pripojíte, prevedené do formátu frameworku Foundation Models od Apple. V každom okamihu sú načítané jedna alebo dve služby a najviac osem ich operácií, vďaka čomu sú definície nástrojov dosť malé na okno modelu v zariadení.
Ako pripojiť Home Assistant k AI asistentovi v iPhone cez MCP?
V Home Assistant pridajte integráciu Model Context Protocol Server a vo svojom profile v časti Security vytvorte dlhodobý prístupový token (Long-lived access token). V aplikácii Orvena klepnite pri Home Assistant na Pripojiť, zadajte adresu HTTPS končiacu na /api/mcp a vložte token. Obyčajné adresy http sa odmietnu, a to aj vo vašej domácej sieti.
Môžem v iPhone používať server Notion MCP?
Áno. Notion je jedným zo šiestich konektorov, ktoré Orvena ponúka. V Nastaveniach v časti Pripojenia klepnite na Pripojiť, prihláste sa do Notion a schváľte prístup. Orvena používa hostovaný server Notion na mcp.notion.com a pred prvým spustením nástroja Notion sa opýta. Pripojenia sú súčasťou Premium Unlock.
Pýta sa každá akcia MCP na schválenie?
Deštruktívne akcie sa pýtajú zakaždým. Nástroje, ktoré čítajú, vytvárajú alebo menia údaje, sa pýtajú pri prvom použití a môžete zvoliť Vždy povoliť. Toto povolenie nájdete v Nastaveniach v časti Zdieľanie údajov, Povolené nástroje, kde ho môžete odvolať.
Orvena je v App Store zadarmo pre iPhone 15 Pro a novšie. Premium Unlock, jeden nákup, pridá šesť ponúkaných konektorov a akýkoľvek server MCP, ktorý pridáte.
Stiahnuť v App Store