MCP-kliendi kasutamine iPhone'is: loetletud konnektorid, sinu enda server ja piirangud

Orvena on MCP-klient iPhone'ile. See ühendab assistendi teenustega Notion, Linear, GitHub, Jira & Confluence, Zapier ja Home Assistant või MCP serveriga, mida käitad ise, ning laseb Apple Intelligence'il, Private Cloud Compute'il, Orvena enda mudelil või OpenRouteri mudelil nende tööriistu kasutada. See juhend käsitleb seadistuskuvasid nimepidi, reegleid, millele kohandatud server peab vastama, seda, kuidas tööriistad mahuvad väikesesse kontekstiaknasse, ja kinnitusi, mida näed enne, kui midagi muudetakse või saadetakse.

Mida MCP-klient iPhone'is teeb

MCP ehk Model Context Protocol on avatud standard teenuste ühendamiseks AI-assistentidega. Teenus käitab MCP serverit, mis loetleb oma tööriistad, igaüks oma nime, kirjelduse ja argumentidega, ning klient kutsub tööriista välja, kui mudel seda palub. Orvena on klient, mis suhtleb iga serveriga HTTPS-i kaudu otse sinu iPhone'ist.

Orvena ühendub ainult kaugserveritega, kasutades transporti MCP streamable HTTP. Kohalik stdio-server, mida lauaarvutirakendus käivitab käsuna, ei saa Orvenas töötada, seega pane see HTTPS-i kaudu töötava vahendusserveri (bridge) taha ja lisa hoopis selle aadress.

Konnektorid, mida Orvena loetleb

Ava vasakus ülanurgas menüü, siis Seaded ja Ühendused (rida pealkirjaga "Ühenda oma asjad"). Versioon 2.0.0 loetleb kuus teenust:

Mudel loeb neid kirjeldusi, et otsustada, millist teenust päring vajab. Iga server teatab pärast sisselogimist oma tööriistad ja rida näitab nende arvu. Slack, Figma, Canva, Todoist ja PayPal pole loendis, sest Orvena ei suuda praegu nende sisselogimisnõudeid täita.

1. Puuduta kaardil nuppu Ühenda. Ilma Premium Unlockita on nupul kiri Premium ja see avab ostukuva.
2. Notioni, Lineari ning Jira & Confluence'i puhul avaneb teenuse enda sisselogimisleht paneelil, kui server sisselogimist küsib. Kinnita juurdepääs seal.
3. GitHubi puhul näitab paneel pealkirjaga "Autoriseeri Orvena" ühekordset koodi. Puuduta "Kopeeri kood ja ava GitHub", kleebi kood ja kinnita. Paneelil on kiri "Autoriseerimise ootel…", kuni GitHub kinnitab.
4. Teenus liigub ülemisse loendisse ja selle olek "Ühendamine…" asendub tööriistade arvuga.

Home Assistant MCP iPhone'is ja Zapier

Mõlemad kasutavad sisselogimislehe asemel tokenit. Lisa Home Assistantis integratsioon "Model Context Protocol Server" ja loo seejärel oma profiili all token: Security, Long-lived access tokens. Puuduta Orvenas Home Assistanti juures nuppu Ühenda, sisesta aadress välja "Kus see asub?", näiteks https://your-home:8123/api/mcp, ja kleebi token.

Orvena nõuab siin HTTPS-i ka sinu enda võrgus, nii et see ei saada tokenit http://-aadressile, näiteks http://homeassistant.local:8123 või kohalikule IP-aadressile http:// kaudu. http://-aadressiga ei tee paneeli nupp Ühenda midagi. Home Assistant vajab kehtivat TLS-sertifikaati või usaldusväärset HTTPS-pöördproksit.

Zapier küsib ainult tokenit: loo aadressil mcp.zapier.com server, vali selle rakendused ja kopeeri ühendustoken vahekaardilt Connect.

Kuidas lisada oma MCP server

Viimane kaart jaotises Ühendused, "Sinu enda server", avab vaate "Kohandatud server". URL peab kasutama skeemi https:// ja hostinime ega tohi sisaldada kasutajanime, parooli ega #fragmenti. Server peab toetama transporti MCP streamable HTTP, vastama tavalise JSON-i või SSE-vooga ja toetama protokolli versiooni 2025-11-25, 2025-06-18 või 2025-03-26. Ümbersuunamised peavad jääma samale päritolule ja serverit, mis ei teata ühtegi tööriista, ei salvestata.

1. Täida väli Nimi ja aadressiväli, mille kohatäide on https://server.example/mcp.
2. Kui server kasutab API-võtit või tokenit, kleebi see välja "Bearer token (optional)". Kui see jääb tühjaks, proovib Orvena avatud juurdepääsu, seejärel sisselogimist.
3. Kui OAuth-server ei ütle, milliseid skoope see vajab, sisesta need välja "OAuth scopes, space-separated (optional)" (OAuthi skoobid tühikutega eraldatult).
4. Kirjuta välja "Millega see server aidata saab? (valikuline)" lause selle kohta, milleks see on.
5. Puuduta "Lisa server". Kuni Orvena ühendub ja tööriistu loetleb, on nupul kiri "Kontrollimine…".

Orvena alustab OAuthi alles pärast HTTP 401, 403 või WWW-Authenticate väljakutset ja autoriseerimisserver peab toetama PKCE-d meetodiga S256.

Orvena kasutab otstarbe rida ainult selleks, et otsustada, millal server laadida. Kui seda pole, koostab Orvena iga serveri kokkuvõtte kuni neljast tööriistakirjeldusest, lühendatuna 320 märgini. Kui mõnel tööriistal kirjeldus puudub, näitab rida teadet "Add a purpose so Orvena can choose this server reliably." (lisa otstarve, et Orvena saaks selle serveri usaldusväärselt valida), ja kui kirjeldust pole ühelgi, kasutatakse serverit ainult siis, kui sa selle nimetad. Paranda see rea ••• menüüs valikuga "Kirjelda otstarvet".

Mis vajab Premium Unlocki

Kõik ühendused vajavad seda, nii kuus loetletud teenust kui ka iga server, mille ise lisad. Premium Unlock on ühekordne ost hinnaga 14,99 $ ilma tellimuseta ning lisab ka Private Cloud Compute'i iOS 27-s, pilvemudelid sinu enda OpenRouteri võtmega, häälvestlused ja ajastatud ülesanded. Apple Intelligence ja Orvena allalaaditud mudel on tasuta, kuid ilma Premium Unlockita vastavad need ilma konnektorite tööriistadeta.

MCP kasutamine Apple Intelligence'i ja teiste mootoritega

Kõik neli mootorit Mudelite kuval saavad konnektorite tööriistad. Apple Intelligence'i ja Private Cloud Compute'i jaoks teisendab Orvena iga MCP tööriista JSON-skeemi Apple'i raamistiku Foundation Models skeemivormingusse. Kui tööriista skeem kasutab midagi, mida raamistik väljendada ei suuda, saavad Apple'i mudelid selle tööriista ilma argumentideta, seega kasuta selle jaoks Orvena mudelit või OpenRouterit. Erand on OpenRouteri mudel, mis on loetletud ilma tööriistade toeta: "See mudel ei saa tööriistu kasutada, seega vastab Orvena ilma nendeta."

Mootori vaikeseade Automaatne ei vali kunagi ise Private Cloud Compute'i ega OpenRouterit.

Kuidas tööriistade loendid ja tulemused väikesesse aknasse mahuvad

8 192 tokeni suuruses aknas on kümnete tööriistamääratluste jaoks vähe ruumi, seega ei lähe konnektorite tööriistad mudelile kunagi korraga. Esmalt kutsub mudel välja load_connectors, et valida ühendatud teenuste loendist üks või kaks teenust; iga teenust kirjeldatakse kuni 180 märgiga (kokku 8 192 märki). Seejärel valib load_tools nende hulgast ühest kaheksani toimingut. Ainult need muutuvad väljakutsutavaks.

Enne iga mudelivooru liidab Orvena kokku juhised, laaditud tööriistaskeemid ja 900 tokenit varu. Kui summa ületab akna suuruse miinus 512 tokenit, eemaldab Orvena konnektorite tööriistu, alustades uusimatest, välja arvatud need, mida päring peab veel välja kutsuma, ja seejärel vanima oskuse. Kui vajalik toiming ikka ei mahu, peatub voor teatega "The required connector operation is too large for this model's context window." (vajalik konnektori toiming on selle mudeli kontekstiakna jaoks liiga suur).

Tööriistakirjeldused lühendatakse 500 märgini ja tulemused märgitakse mitteusaldusväärseteks andmeteks, mis ütleb mudelile, et lehe või issue tekst on sisu, mitte juhised. Eelarvet ületav tulemus tihendatakse: lehitsemise (pagination) väljad tõstetakse ettepoole, lingid ja pikad räsid eemaldatakse, loendi objektid säilitavad kuni 12 välja ja pikki stringe lühendatakse ning mudelile lisatakse selle kohta märkus.

Pikkades vestlustes hoiab Orvena mootori akna piires terveid hiljutisi voore ja eemaldab kõige vanemad. See ei tee kokkuvõtteid. Kui ka see ei mahu, näitab Apple Intelligence teadet "See vestlus on funktsiooni Apple Intelligence jaoks liiga pikk. Alusta uut vestlust või vali jaotises Mudelid Orvena allalaaditud mudel."

Kinnitused enne, kui midagi muudetakse või välja saadetakse

Orvena liigitab iga MCP tööriista vihjete põhjal, mille server tööriista kohta esitab: ainult lugevate tööriistade juures on kiri "Loeb andmeid neid muutmata.", destruktiivsete juures "Kustutab, tühistab või teeb pöördumatu toimingu." ja ülejäänute juures "Loob või muudab andmeid."

• Lugevad ja kirjutavad tööriistad küsivad esimesel korral. Paneelil pealkirjaga "KINNITA SEE TOIMING" on nupud "Ära luba" ja "Luba" ning menüüs valikud "Luba üks kord" ja "Luba alati".
• Destruktiivsed tööriistad küsivad iga kord ja pakuvad ainult valikut "Luba üks kord".
• Paneel loetleb täpsed argumendid, kusjuures tokenid, paroolid ja muud mandaaditaolised väljad kuvatakse kujul [REDACTED CREDENTIAL], ning ütleb, kuhu need lähevad, näiteks "Saadab selle toimingu jaoks vajalikud andmed teenusele Notion."
• Kui sama voor on juba lugenud midagi isiklikku, näiteks sinu kalendrit või teise konnektori tulemust, on kinnituse pealkiri "Send data to" (saada andmed) ja teenuse nimi. Pärast terviseandmeid küsitakse iga kord.

Private Cloud Compute küsib ühe korra, kui valid selle kuval Mudelid, ja ütleb, et iga vastus saadab "teie vestluse ja vajalikud tööriistade tulemused Apple'i serveritesse." Konnektorite kinnitused näitavad siis sihtkohana "Notion → Private Cloud Compute". OpenRouter küsib enne vestluse esimest päringut ja uuesti küsimusega "Kas kasutada tundlike andmete puhul: OpenRouter?", kui ajaloos on konnektori tulemus. Salvestatud load on jaotises Seaded, Andmete jagamine, kus saad need tagasi võtta.

Kuhu andmed lähevad

Konnektorite liiklus liigub iPhone'ist otse teenusesse, ilma vahepealse Orvena serverita. Teenus ja selle sisselogimisserver saavad argumendid, mille kinnitasid, sisu, mille nad tagastavad, ja sisselogimisliikluse. Tokenid jäävad iPhone'i Keychaini, ainult sellesse seadmesse. Apple Intelligence'i või Orvena mudeliga loetakse tulemusi telefonis; Private Cloud Compute'iga lähevad vastuseks vajalikud tulemused Apple'ile ja OpenRouteriga pärast sinu nõusolekut OpenRouterile. Jaotis Seaded, Tegevus säilitab kuni 30 päeva tööriistade nimed, toimingute tulemused ja sihtkohad, mitte kunagi argumente. Nupp Katkesta ühendus eemaldab kohalikud sisselogimisandmed ja tööriistad ning kinnitusteade tuletab meelde, et juurdepääs tuleb tühistada ka teenuses, näiteks "Võimalik, et pead Orvena juurdepääsu tühistama ka teenuse Notion kontoseadetes." Laiem pilt on artiklis mis teeb AI-assistendi privaatseks.

Tõrkeotsing

Korduma kippuvad küsimused

Kas saan MCP serverit oma iPhone'is käitada?

Orvenas mitte. Orvena on MCP-klient, mis ühendub kaugserveritega HTTPS-i kaudu, kasutades transporti MCP streamable HTTP. Kohalik stdio-server ei saa Orvenas töötada, seega käita seda mujal HTTPS-i kaudu töötava vahendusserveri taga ja lisa selle aadress kaardil Sinu enda server.

Kas Apple Intelligence saab MCP tööriistu kasutada?

Orvenas saab. iOS 27-s annab Orvena Apple'i seadmesisesele mudelile ja Private Cloud Compute'ile sinu ühendatud serverite tööriistad, teisendatuna Apple'i raamistiku Foundation Models vormingusse. Korraga on laaditud üks või kaks teenust ja kuni kaheksa nende toimingut, nii et tööriistamääratlused mahuvad seadmesisese mudeli aknasse.

Kuidas ühendada Home Assistant MCP kaudu iPhone'i AI-assistendiga?

Lisa Home Assistantis integratsioon Model Context Protocol Server ja loo oma profiili all (Security) pikaajaline juurdepääsutoken. Puuduta Orvenas Home Assistanti juures nuppu Ühenda, sisesta HTTPS-aadress, mis lõpeb osaga /api/mcp, ja kleebi token. Orvena keeldub tavalistest http-aadressidest, ka sinu koduvõrgus.

Kas saan iPhone'is kasutada Notioni MCP serverit?

Jah. Notion on üks Orvena kuuest loetletud konnektorist. Puuduta jaotises Seaded, Ühendused nuppu Ühenda, logi Notioni sisse ja kinnita juurdepääs. Orvena kasutab Notioni hostitud serverit aadressil mcp.notion.com ja küsib luba enne, kui Notioni tööriist esimest korda käivitub. Ühendused sisalduvad Premium Unlockis.

Kas iga MCP toiming küsib kinnitust?

Destruktiivsed toimingud küsivad iga kord. Tööriistad, mis loevad, loovad või muudavad andmeid, küsivad esimesel korral ja saad valida "Luba alati". See luba on kirjas jaotises Seaded, Andmete jagamine, Lubatud tööriistad, kus saad selle tagasi võtta.