MCP-kliens használata iPhone-on: a felsorolt csatlakozók, a saját szerver és a korlátok
Az Orvena MCP-kliens az iPhone-ra. Az asszisztenst a Notionhoz, a Linearhez, a GitHubhoz, a Jira & Confluence szolgáltatáshoz, a Zapierhez és a Home Assistanthez kapcsolja, vagy egy saját üzemeltetésű MCP-szerverhez, és lehetővé teszi, hogy az Apple Intelligence, a Private Cloud Compute, az Orvena saját modellje vagy egy OpenRouter-modell meghívja ezek eszközeit. Ez az útmutató név szerint végigveszi a beállítási képernyőket, bemutatja, milyen szabályoknak kell megfelelnie egy egyéni szervernek, hogyan férnek el az eszközök egy kis kontextusablakban, és milyen jóváhagyásokat látsz, mielőtt bármi módosulna vagy elküldésre kerülne.
Mit csinál egy MCP-kliens az iPhone-on
Az MCP, vagyis a Model Context Protocol, nyílt szabvány szolgáltatások AI-asszisztensekhez való csatlakoztatására. A szolgáltatás egy MCP-szervert futtat, amely felsorolja az eszközeit, mindegyiket a nevével, a leírásával és az általa várt argumentumokkal, a kliens pedig meghív egy eszközt, amikor a modell ezt kéri. Az Orvena a kliens: HTTPS-en keresztül, közvetlenül az iPhone-odról kommunikál az egyes szerverekkel.
Az Orvena csak távoli szerverekhez csatlakozik, MCP streamable HTTP-n keresztül. Helyi stdio-szerver, vagyis az a fajta, amelyet egy asztali app parancsként indít el, nem futhat az Orvenán belül, ezért tedd egy távoli HTTPS-híd mögé, és azt a címet add hozzá.
Az Orvena által felsorolt csatlakozók
Nyisd meg a bal felső menüt, majd a Beállításokat, végül a Kapcsolatokat (a "Kösd össze a dolgaidat" című sort). A 2.0.0-s verzió hat szolgáltatást sorol fel:
| Csatlakozó | Bejelentkezés | Mire használhatod |
|---|---|---|
| Notion | OAuth | Oldalak, adatbázisok és munkaterület-tartalmak keresése és kezelése. |
| Linear | OAuth, olvasás és írás | Issue-k, projektek, csapatok és tervezési adatok keresése és kezelése. |
| GitHub | Egyszeri kód, személyes hozzáférési token nélkül | Tárolók, kód, issue-k és pull requestek keresése és kezelése. |
| Jira & Confluence | OAuth, 13 hatókör, köztük Jira-munkaelemek és Confluence-oldalak írása | Jira-munkaelemek, valamint Confluence-terek, -oldalak és -megjegyzések keresése és kezelése. |
| Zapier | Kapcsolati token | A Zapier MCP-szervereden beállított appok és műveletek használata. |
| Home Assistant | Hozzáférési token és a HTTPS-címed | Az általa elérhetővé tett eszközök, entitások, jelenetek és automatizálások megtekintése és vezérlése. |
A modell ezekből a leírásokból dönti el, melyik szolgáltatásra van szüksége egy kéréshez. Bejelentkezés után minden szerver maga jelenti az eszközeit, és a sor mutatja a számukat. A Slack, a Figma, a Canva, a Todoist és a PayPal azért nem szerepel a listán, mert az Orvena ma még nem tud megfelelni a bejelentkezési követelményeiknek.
- Koppints egy kártyán a Csatlakozás gombra. Premium Unlock nélkül a gomb felirata Prémium, és a vásárlási képernyőt nyitja meg.
- A Notion, a Linear és a Jira & Confluence esetében a szolgáltatás saját bejelentkezési oldala egy ablakban nyílik meg, amint a szerver bejelentkezést kér. Ott hagyd jóvá a hozzáférést.
- A GitHubnál egy "Orvena engedélyezése" című ablak egyszeri kódot mutat. Koppints a "Kód másolása és a GitHub megnyitása" gombra, illeszd be a kódot, és hagyd jóvá. Az ablakban "Várakozás az engedélyezésre…" olvasható, amíg a GitHub meg nem erősíti.
- A szolgáltatás a felső listába kerül, és az állapota "Csatlakozás…" helyett már az eszközei számát mutatja.
Home Assistant MCP iPhone-on, és a Zapier
Mindkettő bejelentkezési oldal helyett tokent használ. A Home Assistantben add hozzá a "Model Context Protocol Server" integrációt, majd hozz létre egy tokent a profilodban, a Security (Biztonság) lapon, a Long-lived access tokens (hosszú élettartamú hozzáférési tokenek) résznél. Az Orvenában koppints a Home Assistant kártyáján a Csatlakozás gombra, a "Hol érhető el?" alatt add meg a címet, például https://your-home:8123/api/mcp, és illeszd be a tokent.
Az Orvena itt a saját hálózatodon is HTTPS-t követel meg, így nem küldi el a tokent http:// kezdetű címre, például a http://homeassistant.local:8123 címre vagy egy helyi IP-címre http:// protokollon. http:// címmel az ablak Csatlakozás gombja nem csinál semmit. A Home Assistanthez érvényes TLS-tanúsítvány vagy megbízható HTTPS reverse proxy kell.
A Zapier csak a tokent kéri: az mcp.zapier.com oldalon hozz létre egy szervert, válaszd ki az appjait, és másold ki a kapcsolati tokent a Connect lapról.
Saját MCP-szerver hozzáadása
A Kapcsolatok utolsó kártyája, a "Saját szerver", az "Egyéni szerver" képernyőt nyitja meg. Az URL-nek https:// kezdetűnek kell lennie, gazdagépnévvel, és nem tartalmazhat felhasználónevet, jelszót vagy # utáni részt (fragmentet). A szervernek MCP streamable HTTP-n kell kommunikálnia, sima JSON-nal vagy SSE-streammel válaszolva, és támogatnia kell a 2025-11-25, a 2025-06-18 vagy a 2025-03-26 protokollverziót. Az átirányításoknak ugyanazon az originen kell maradniuk, és az Orvena nem menti el azt a szervert, amely egyetlen eszközt sem jelent.
- Töltsd ki a Név mezőt és a címmezőt, amelynek helyőrzője https://server.example/mcp.
- Ha a szerver API-kulcsot vagy tokent használ, illeszd be a "Bearer token (optional)" mezőbe. Ha üresen hagyod, az Orvena először nyílt hozzáféréssel próbálkozik, aztán bejelentkezéssel.
- Ha egy OAuth-szerver nem adja meg, milyen hatókörökre van szüksége, írd be őket az "OAuth scopes, space-separated (optional)" mezőbe (OAuth-hatókörök szóközzel elválasztva).
- A "Miben segíthet ez a szerver? (nem kötelező)" mezőbe írj egy mondatot arról, mire való.
- Koppints a "Szerver hozzáadása" gombra. Amíg az Orvena csatlakozik és lekéri az eszközöket, "Ellenőrzés…" olvasható rajta.
Az Orvena csak HTTP 401-es vagy 403-as válasz, illetve WWW-Authenticate kihívás után indítja el az OAuth-folyamatot, és az engedélyezési szervernek támogatnia kell a PKCE-t S256-tal.
A célleírást az Orvena csak arra használja, hogy eldöntse, mikor töltse be a szervert. Ha nincs ilyen, minden szerver összefoglalóját legfeljebb négy eszközleírásból állítja össze, 320 karakterre vágva. Ha bármelyik eszköznek hiányzik a leírása, a sorban ez áll: "Add a purpose so Orvena can choose this server reliably." (adj meg egy célt, hogy az Orvena megbízhatóan választhassa ezt a szervert), ha pedig egyiknek sincs, a szervert csak akkor használja, ha néven nevezed. Ezt a sor ••• menüjében, a "Cél leírása" ponttal javíthatod.
Mihez kell Premium Unlock
Minden kapcsolathoz: a hat felsorolt szolgáltatáshoz és bármely szerverhez, amelyet saját magad adsz hozzá. A Premium Unlock egyszeri, 14,99 dolláros vásárlás, előfizetés nélkül, és emellett hozzáadja a Private Cloud Compute szolgáltatást iOS 27 rendszeren, a felhőmodelleket a saját OpenRouter-kulcsoddal, a hangos beszélgetéseket és az ütemezett feladatokat. Az Apple Intelligence és az Orvena letöltött modellje ingyenes, de a feloldás nélkül a csatlakozók eszközei nélkül válaszolnak.
MCP használata az Apple Intelligence-szel és a többi motorral
A Modellek képernyő mind a négy motorja megkapja a csatlakozók eszközeit. Az Apple Intelligence és a Private Cloud Compute számára az Orvena minden MCP-eszköz JSON-sémáját átalakítja az Apple Foundation Models keretrendszerének sémaformátumára. Ha egy eszköz sémája olyasmit használ, amit a keretrendszer nem tud kifejezni, az Apple modelljei argumentumok nélkül kapják meg az eszközt, ezért ahhoz használd az Orvena modelljét vagy az OpenRoutert. Kivétel az eszköztámogatás nélkül listázott OpenRouter-modell: "Ez a modell nem tud eszközöket használni, ezért az Orvena nélkülük válaszol."
| Motor | Hol fut | Kontextusablak | Ennyit lát a modell egy eszközeredményből |
|---|---|---|---|
| Apple Intelligence | Ezen az iPhone-on, iOS 27 | Futás közben az iOS-től lekérdezve: a tesztelés során iOS 27 rendszeren 8 192 token, bár az Apple dokumentációja 4 096-ot ír | Legfeljebb 2 400 karakter |
| Az Orvena modellje | Ezen az iPhone-on (Qwen 3.5 4B, 3,1 GB) | 16 384 token | Legfeljebb 4 000 karakter |
| Private Cloud Compute | Az Apple szerverein, iOS 27, Premium | 32 768 token | Legfeljebb 4 000 karakter |
| OpenRouter | OpenRouter, saját kulcs, Premium | A modellnél megadott hossz, ha ez nem ismert, 60 000, de legfeljebb 120 000 | Legfeljebb 4 000 karakter |
Az Automatikus, az alapértelmezett motorbeállítás, magától soha nem választja a Private Cloud Compute szolgáltatást vagy az OpenRoutert.
Hogyan férnek el az eszközlisták és az eredmények egy kis ablakban
Egy 8 192 tokenes ablakban kevés hely jut több tucat eszközdefiníciónak, ezért a csatlakozók eszközei soha nem kerülnek egyszerre a modellhez. A modell először a load_connectors hívással kiválaszt egy vagy két szolgáltatást a csatlakoztatott szolgáltatások listájából, amelyben mindegyik leírása legfeljebb 180 karakter (összesen legfeljebb 8 192 karakter). Ezután a load_tools legalább egy, legfeljebb nyolc műveletet választ ki belőlük. Csak ezek hívhatók meg.
Minden modellkör előtt az Orvena összeadja az utasításokat, a betöltött eszközsémákat és 900 token tartalékot. Ha ez meghaladja az ablak méretét mínusz 512 tokent, elhagyja a csatlakozók eszközeit, a legújabbal kezdve, kivéve azokat, amelyeket a kérésnek még meg kell hívnia, majd a legrégebbi képességet (skill). Ha a szükséges művelet így sem fér el, a kör ezzel az üzenettel leáll: "The required connector operation is too large for this model's context window." (a szükséges csatlakozóművelet túl nagy ennek a modellnek a kontextusablakához).
Az eszközleírásokat az Orvena 500 karakterre vágja, az eredményeket pedig nem megbízható adatként jelöli meg, ami azt jelzi a modellnek, hogy egy oldalról vagy issue-ból származó szöveget tartalomként kezeljen, ne utasításként. A kereten felüli eredményt tömöríti: a lapozási mezők kerülnek előre, a linkek és a hosszú hash-ek kimaradnak, a listákban lévő objektumok legfeljebb 12 mezőt tartanak meg, a hosszú szövegek pedig lerövidülnek, és erről egy megjegyzés tájékoztatja a modellt.
Hosszú beszélgetésekben az Orvena a legutóbbi köröket egészben megtartja a motor ablakán belül, a legrégebbieket pedig elhagyja. Összefoglalót nem készít. Ha még ez sem fér el, az Apple Intelligence ezt mutatja: "Ez a beszélgetés túl hosszú az Apple Intelligence-hez. Kezdj új beszélgetést, vagy válts az Orvena letöltött modelljére a Modellek képernyőn."
Jóváhagyások, mielőtt bármi módosulna vagy távozna
Az Orvena minden MCP-eszközt a szervere által megadott jelzések alapján sorol be: a csak olvasó eszközöknél ez áll: "Adatokat olvas, módosítás nélkül.", a destruktívaknál "Töröl, megszakít vagy visszafordíthatatlan műveletet végez.", a többinél pedig "Adatokat hoz létre vagy módosít."
- Az olvasó és író eszközök első alkalommal kérdeznek rá. A "MŰVELET JÓVÁHAGYÁSA" fejlécű ablakban a "Tiltás" és az "Engedélyezés" gomb látható, a menüjében pedig az "Engedélyezés egyszer" vagy az "Engedélyezés mindig".
- A destruktív eszközök minden alkalommal rákérdeznek, és csak az "Engedélyezés egyszer" lehetőséget kínálják.
- Az ablak felsorolja a pontos argumentumokat, a tokeneket, jelszavakat és más hitelesítő adatnak tűnő mezőket [REDACTED CREDENTIAL] formában mutatva, és megmondja, hová kerülnek, például: "Elküldi a művelethez szükséges adatokat a következőnek: Notion."
- Ha ugyanebben a körben az Orvena már olvasott valami személyeset, például a naptáradat vagy egy másik csatlakozó eredményét, a jóváhagyás címe "Send data to" (adatok küldése ide) és a szolgáltatás neve. Egészségügyi adatok után minden alkalommal rákérdez.
A Private Cloud Compute egyszer kérdez, amikor a Modellek képernyőn kiválasztod, és közli, hogy "Minden válasz elküldi a beszélgetését és a szükséges eszközeredményeket az Apple szervereire." A csatlakozók jóváhagyásai ezután célként a "Notion → Private Cloud Compute" feliratot mutatják. Az OpenRouter a beszélgetés első kérése előtt kérdez, majd amint egy csatlakozó eredménye bekerül az előzményekbe, újra, ezzel: "Használja érzékeny adatokkal: OpenRouter?" A mentett engedélyek a Beállítások Adatmegosztás részében találhatók, ahol vissza is vonhatod őket.
Hová kerülnek az adatok
A csatlakozók forgalma közvetlenül az iPhone-ról megy a szolgáltatáshoz, Orvena-szerver nincs közöttük. A szolgáltatás és a bejelentkezési szervere megkapja az általad jóváhagyott argumentumokat, az általuk visszaküldött tartalmat és a bejelentkezési forgalmat. A tokenek az iPhone kulcskarikáján maradnak, csak ezen az eszközön. Az Apple Intelligence és az Orvena modellje esetén az eredményeket a telefon olvassa; a Private Cloud Compute esetén a válaszhoz szükséges eredmények az Apple-höz kerülnek, az OpenRouter esetén pedig a hozzájárulásod után az OpenRouterhez. A Beállítások Tevékenység része legfeljebb 30 napig őrzi meg az eszközök nevét, a műveletek kimenetelét és a célokat, az argumentumokat soha. A Leválasztás eltávolítja a helyi hitelesítő adatokat és eszközöket, a megerősítés pedig emlékeztet, hogy a szolgáltatásnál is vond vissza a hozzáférést, például: "Előfordulhat, hogy az Orvena hozzáférését a(z) Notion fiókbeállításaiban is vissza kell vonnod." A tágabb képet a mitől lesz privát egy AI-asszisztens című cikk mutatja be.
Hibaelhárítás
| Amit látsz | Mit ellenőrizz |
|---|---|
| "Enter a complete HTTPS server URL." (adj meg egy teljes HTTPS-szervercímet) | A címet https:// előtaggal kezdd, és add meg a gazdagépnevet. |
| "A szerver olyan választ adott, amelyet az Orvena nem tud használni." | Töröld a címből az esetleges user:password@ részt és mindent, ami a # után áll. Ha a cím tiszta, a szerver olyan választ küldött, amelyet az Orvena nem tudott értelmezni. |
| "Couldn't reach the server. Check your connection and server address." (a szerver nem érhető el) | A címet, a DNS-t és a TLS-tanúsítványt, onnan nézve, ahol a telefon éppen van. |
| "A szerver visszautasította a kapcsolatot. Ellenőrizze a bejelentkezést vagy a tokent." | Ellenőrizd a tokent, vagy hozz létre újat, és csatlakozz újra. |
| "This server doesn't support compatible sign-in. Use a token if it offers one." (a szerver nem támogat kompatibilis bejelentkezést) | Illessz be egy tokent a "Bearer token (optional)" mezőbe. |
| "Bejelentkezés szükséges" vagy "A csatlakozás nem sikerült" | Újracsatlakozás vagy Újra a ••• menüben. |
| "The latest tool result is too large for this model's context window. Try a narrower request." (a legutóbbi eszközeredmény túl nagy ennek a modellnek) | Kérj egyetlen oldalt vagy issue-t, vagy válassz nagyobb ablakú motort. |
| "A művelet lehet, hogy végrehajtódott. Ellenőrizze a szolgáltatást, mielőtt újra próbálkozna." | Nézd meg a szolgáltatásban, mielőtt megismételnéd a műveletet. |
| "A távoli műveletek helyreállítása ellenőrzést igényel" | Az új távoli műveletek szünetelnek. Ellenőrizz minden szolgáltatást, majd koppints a "Minden célt ellenőriztem" gombra. |
Gyakori kérdések
Futtathatok MCP-szervert az iPhone-omon?
Az Orvenán belül nem. Az Orvena MCP-kliens, amely HTTPS-en, MCP streamable HTTP-vel csatlakozik távoli szerverekhez. Helyi stdio-szerver nem futhat az Orvenán belül, ezért futtasd máshol, egy HTTPS-híd mögött, és azt a címet add hozzá a Saját szerver pontnál.
Használhat az Apple Intelligence MCP-eszközöket?
Az Orvenában igen. iOS 27 rendszeren az Orvena az Apple eszközön futó modelljének és a Private Cloud Compute szolgáltatásnak is átadja a csatlakoztatott szerverek eszközeit, az Apple Foundation Models keretrendszerének formátumára alakítva. Egyszerre egy vagy két szolgáltatás és azok legfeljebb nyolc művelete van betöltve, így az eszközdefiníciók elég kicsik maradnak az eszközön futó modell ablakához.
Hogyan kapcsolhatom a Home Assistantet MCP-n keresztül egy iPhone-os AI-asszisztenshez?
Add hozzá a Home Assistantben a Model Context Protocol Server integrációt, és hozz létre egy hosszú élettartamú hozzáférési tokent a profilodban, a Security (Biztonság) lapon. Az Orvenában koppints a Home Assistant kártyáján a Csatlakozás gombra, add meg a /api/mcp végű HTTPS-címet, és illeszd be a tokent. A sima http-címeket az Orvena elutasítja, az otthoni hálózatodon is.
Használhatom a Notion MCP-szerverét iPhone-on?
Igen. A Notion az Orvena hat felsorolt csatlakozójának egyike. Koppints a Csatlakozás gombra a Beállítások, Kapcsolatok alatt, jelentkezz be a Notionba, és hagyd jóvá a hozzáférést. Az Orvena a Notion által üzemeltetett szervert használja az mcp.notion.com címen, és egy Notion-eszköz első futtatása előtt rákérdez. A kapcsolatok a Premium Unlock részei.
Minden MCP-művelet jóváhagyást kér?
A destruktív műveletek minden alkalommal rákérdeznek. Az adatokat olvasó, létrehozó vagy módosító eszközök első alkalommal kérdeznek, és választhatod az Engedélyezés mindig lehetőséget. Ez az engedély a Beállítások, Adatmegosztás, Engedélyezett eszközök alatt látható, ahol vissza is vonhatod.
Az Orvena ingyenes az App Store-ban iPhone 15 Pro és újabb készülékekre. A Premium Unlock egyetlen vásárlással hozzáadja a hat felsorolt csatlakozót és bármely MCP-szervert, amelyet hozzáadsz.
Letöltés az App Store-ból