Cum folosești un client MCP pe iPhone: conectorii din listă, propriul server și limitele

Orvena este un client MCP pentru iPhone. Conectează asistentul la Notion, Linear, GitHub, Jira & Confluence, Zapier și Home Assistant sau la un server MCP pe care îl rulezi chiar tu și le permite lui Apple Intelligence, Private Cloud Compute, modelului propriu Orvena sau unui model OpenRouter să le apeleze instrumentele. Ghidul acesta descrie ecranele de configurare cu numele lor din aplicație, regulile pe care trebuie să le respecte un server personalizat, cum încap instrumentele într-o fereastră de context mică și aprobările pe care le vei vedea înainte ca ceva să fie modificat sau trimis.

Ce face un client MCP pe iPhone

MCP, Model Context Protocol, este un standard deschis pentru conectarea serviciilor la asistenții AI. Un serviciu rulează un server MCP care își listează instrumentele, fiecare cu un nume, o descriere și argumentele pe care le primește, iar clientul apelează un instrument când modelul îl cere. Orvena este clientul și comunică cu fiecare server prin HTTPS, direct de pe iPhone-ul tău.

Orvena se conectează doar la servere la distanță, prin MCP streamable HTTP. Un server stdio local, de felul celor pe care o aplicație desktop le pornește ca pe o comandă, nu poate rula în Orvena, așa că pune-l în spatele unei punți HTTPS la distanță și adaugă în schimb acea adresă.

Conectorii din lista Orvena

Deschide meniul din stânga sus, apoi Configurări, apoi Conexiuni (rândul intitulat "Conectează-ți lucrurile"). Versiunea 2.0.0 listează șase servicii:

Modelul citește aceste descrieri ca să decidă de ce serviciu are nevoie o cerere. Fiecare server își raportează propriile instrumente după autentificare, iar rândul arată câte sunt. Slack, Figma, Canva, Todoist și PayPal nu sunt în listă, pentru că Orvena nu poate îndeplini deocamdată cerințele lor de autentificare.

1. Atinge Conectați pe un card. Fără Premium Unlock, pe buton scrie Premium, iar atingerea lui deschide ecranul de achiziție.
2. Pentru Notion, Linear și Jira & Confluence, pagina de autentificare a serviciului se deschide într-un panou imediat ce serverul cere autentificarea. Aprobă accesul acolo.
3. Pentru GitHub, un panou intitulat "Autorizați Orvena" arată un cod unic. Atinge "Copiați codul și deschideți GitHub", lipește codul și aprobă. Panoul arată "Se așteaptă autorizarea…" până când GitHub confirmă.
4. Serviciul trece în lista de sus, iar starea lui se schimbă din "Se conectează…" în numărul de instrumente.

Home Assistant MCP pe iPhone și Zapier

Amândouă folosesc un token în loc de o pagină de autentificare. În Home Assistant, adaugă integrarea "Model Context Protocol Server", apoi creează un token în profilul tău, la Security, Long-lived access tokens. În Orvena, atinge Conectați pe Home Assistant, introdu adresa la "Unde se află?", de exemplu https://your-home:8123/api/mcp, și lipește tokenul.

Orvena cere HTTPS aici chiar și în rețeaua ta, așa că nu trimite tokenul la o adresă http://, cum ar fi http://homeassistant.local:8123 sau o adresă IP locală prin http://. Cu o adresă http://, butonul Conectați din panou nu face nimic. Home Assistant are nevoie de un certificat TLS valid sau de un reverse proxy HTTPS de încredere.

Zapier cere doar tokenul: pe mcp.zapier.com, creează un server, alege-i aplicațiile și copiază tokenul de conexiune din fila Connect.

Cum adaugi propriul server MCP

Ultimul card din Conexiuni, "Propriul dvs. server", deschide "Server personalizat". URL-ul trebuie să folosească https:// cu un nume de host și să nu conțină nume de utilizator, parolă sau #fragment. Serverul trebuie să folosească MCP streamable HTTP, să răspundă cu JSON simplu sau cu un flux SSE și să accepte versiunea de protocol 2025-11-25, 2025-06-18 sau 2025-03-26. Redirecționările trebuie să rămână pe aceeași origine, iar un server care nu raportează niciun instrument nu este salvat.

1. Completează Nume și câmpul pentru adresă, al cărui text de exemplu este https://server.example/mcp.
2. Dacă serverul folosește o cheie API sau un token, lipește-l în "Bearer token (optional)". Dacă îl lași gol, Orvena încearcă întâi accesul liber, apoi autentificarea.
3. Dacă un server OAuth nu spune de ce scope-uri are nevoie, introdu-le în "OAuth scopes, space-separated (optional)" (scope-uri OAuth, separate prin spații).
4. La "Cu ce poate ajuta acest server? (opțional)", scrie o propoziție despre rolul lui.
5. Atinge "Adăugați un server". Apare "Se verifică…" cât timp Orvena se conectează și listează instrumentele.

Orvena pornește OAuth doar după un HTTP 401, 403 sau o provocare WWW-Authenticate, iar serverul de autorizare trebuie să accepte PKCE cu S256.

Orvena folosește descrierea scopului doar ca să decidă când să încarce serverul. Fără el, construiește rezumatul fiecărui server din cel mult patru descrieri de instrumente, tăiate la 320 de caractere. Dacă vreunui instrument îi lipsește descrierea, rândul arată "Add a purpose so Orvena can choose this server reliably." (adaugă un scop, ca Orvena să aleagă sigur acest server), iar dacă niciunul nu are descriere, serverul este folosit doar când îl numești. Rezolvi asta cu "Descrieți scopul" din meniul ••• al rândului.

Ce are nevoie de Premium Unlock

Toate conexiunile au nevoie de el: cele șase servicii din listă și orice server pe care îl adaugi tu. Premium Unlock este o achiziție unică de 14,99 $, fără abonament, și adaugă și Private Cloud Compute pe iOS 27, modele din cloud cu propria ta cheie OpenRouter, conversații vocale și sarcini programate. Apple Intelligence și modelul Orvena descărcat sunt gratuite, dar fără Premium Unlock răspund fără instrumentele conectorilor.

MCP cu Apple Intelligence și celelalte motoare

Toate cele patru motoare de pe ecranul Modele primesc instrumentele conectorilor. Pentru Apple Intelligence și Private Cloud Compute, Orvena convertește schema JSON a fiecărui instrument MCP în formatul de schemă al framework-ului Foundation Models de la Apple. Dacă schema unui instrument folosește ceva ce framework-ul nu poate exprima, modelele Apple primesc acel instrument fără argumente, așa că pentru el folosește modelul Orvena sau OpenRouter. Excepția este un model OpenRouter listat fără suport pentru instrumente: "Acest model nu poate folosi instrumente, așa că Orvena va răspunde fără ele."

Automat, setarea implicită pentru motor, nu alege niciodată de la sine Private Cloud Compute sau OpenRouter.

Cum încap listele și rezultatele instrumentelor într-o fereastră mică

O fereastră de 8.192 de tokenuri are puțin loc pentru zeci de definiții de instrumente, așa că instrumentele conectorilor nu ajung niciodată toate odată la model. Modelul apelează mai întâi load_connectors ca să aleagă unul sau două servicii dintr-o listă a serviciilor conectate, fiecare descris în cel mult 180 de caractere (8.192 de caractere în total). Apoi load_tools alege dintre ele între una și opt operații. Doar acestea pot fi apelate.

Înainte de fiecare rundă a modelului, Orvena adună instrucțiunile, schemele instrumentelor încărcate și o rezervă de 900 de tokenuri. Dacă totalul depășește fereastra minus 512 tokenuri, renunță la instrumentele conectorilor, începând cu cele mai noi, cu excepția celor pe care cererea trebuie încă să le apeleze, și apoi la cea mai veche abilitate. Dacă operația necesară tot nu încape, răspunsul se oprește cu "The required connector operation is too large for this model's context window." (operația necesară e prea mare pentru fereastra de context a modelului).

Descrierile instrumentelor sunt tăiate la 500 de caractere, iar rezultatele sunt marcate ca date care nu sunt de încredere, ceea ce îi spune modelului să trateze textul dintr-o pagină sau dintr-un issue drept conținut, nu drept instrucțiuni. Un rezultat care depășește bugetul este compactat: câmpurile de paginare trec pe primul loc, linkurile și hash-urile lungi dispar, obiectele dintr-o listă păstrează cel mult 12 câmpuri, iar șirurile lungi sunt scurtate, cu o notă care îi spune modelului acest lucru.

În conversațiile lungi, Orvena păstrează în fereastra motorului cele mai recente schimburi complete și le elimină pe cele mai vechi. Nu face rezumate. Când nici așa nu încape, Apple Intelligence arată "Această conversație este prea lungă pentru Apple Intelligence. Începeți o conversație nouă sau treceți în Modele la modelul Orvena descărcat."

Aprobări înainte ca ceva să se schimbe sau să plece

Orvena clasifică fiecare instrument MCP după indiciile declarate de serverul lui: instrumentele doar de citire arată "Citește date fără a le modifica.", cele distructive "Șterge, anulează sau efectuează o acțiune ireversibilă.", iar restul "Creează sau modifică date."

• Instrumentele de citire și de scriere întreabă prima dată. Panoul, cu antetul "APROBAȚI ACEASTĂ ACȚIUNE", are "Nu permite" și "Permiteți", iar în meniul lui "Permiteți o dată" sau "Permiteți întotdeauna".
• Instrumentele distructive întreabă de fiecare dată, doar cu "Permiteți o dată".
• Panoul listează argumentele exacte, cu tokenurile, parolele și alte câmpuri care seamănă cu date de autentificare afișate ca [REDACTED CREDENTIAL], și spune unde ajung, de exemplu "Trimite datele necesare pentru această acțiune către Notion."
• Dacă în cadrul aceluiași răspuns s-a citit deja ceva personal, cum ar fi calendarul tău sau rezultatul altui conector, aprobarea are titlul "Send data to" (trimite date către) urmat de numele serviciului. După date din Sănătate, întreabă de fiecare dată.

Private Cloud Compute întreabă o dată, când îl alegi în Modele, și spune că fiecare răspuns trimite "conversația dvs. și rezultatele necesare ale instrumentelor către serverele Apple." Aprobările pentru conectori arată apoi "Notion → Private Cloud Compute" ca destinație. OpenRouter întreabă înainte de prima cerere dintr-o conversație și din nou, cu "Folosiți OpenRouter cu date sensibile?", după ce un rezultat de conector ajunge în istoric. Permisiunile salvate se află în Configurări, Partajarea datelor, unde le poți revoca.

Unde ajung datele

Traficul conectorilor merge de pe iPhone direct la serviciu, fără vreun server Orvena la mijloc. Serviciul și serverul lui de autentificare primesc argumentele pe care le-ai aprobat, conținutul pe care îl returnează și traficul de autentificare. Tokenurile rămân în Keychain pe iPhone, doar pe acest dispozitiv. Cu Apple Intelligence sau cu modelul Orvena, rezultatele sunt citite pe telefon; cu Private Cloud Compute, rezultatele de care are nevoie un răspuns ajung la Apple, iar cu OpenRouter ajung la OpenRouter, după ce îți dai acordul. Configurări, Activitate păstrează timp de până la 30 de zile numele instrumentelor, rezultatele și destinațiile, niciodată argumentele. Butonul Deconectați elimină datele de autentificare locale și instrumentele, iar confirmarea îți amintește să revoci accesul și în serviciu, de exemplu "Este posibil să fie nevoie să revocați Orvena și din configurările contului Notion." Imaginea de ansamblu o găsești în ce face ca un asistent AI să fie privat.

Depanare

Întrebări frecvente

Pot rula un server MCP pe iPhone?

Nu în Orvena. Orvena este un client MCP care se conectează la servere la distanță prin HTTPS, folosind MCP streamable HTTP. Un server stdio local nu poate rula în Orvena, așa că rulează-l în altă parte, în spatele unei punți HTTPS, și adaugă acea adresă la Propriul dvs. server.

Poate Apple Intelligence să folosească instrumente MCP?

În Orvena, da. Pe iOS 27, Orvena le oferă modelului Apple de pe dispozitiv și lui Private Cloud Compute instrumentele serverelor pe care le conectezi, convertite în formatul framework-ului Foundation Models de la Apple. În orice moment are încărcate unul sau două servicii și cel mult opt dintre operațiile lor, astfel încât definițiile instrumentelor rămân suficient de mici pentru fereastra de pe dispozitiv.

Cum conectez Home Assistant la un asistent AI pe iPhone prin MCP?

Adaugă în Home Assistant integrarea Model Context Protocol Server și creează un token de acces de lungă durată (long-lived access token) în profilul tău, la Security. În Orvena, atinge Conectați pe Home Assistant, introdu adresa HTTPS care se termină cu /api/mcp și lipește tokenul. Adresele http simple sunt refuzate, inclusiv în rețeaua de acasă.

Pot folosi serverul MCP Notion pe iPhone?

Da. Notion este unul dintre cei șase conectori din lista Orvena. Atinge Conectați în Configurări, Conexiuni, autentifică-te în Notion și aprobă accesul. Orvena folosește serverul găzduit de Notion la mcp.notion.com și întreabă înainte ca un instrument Notion să ruleze prima dată. Conexiunile fac parte din Premium Unlock.

Fiecare acțiune MCP cere aprobare?

Acțiunile distructive întreabă de fiecare dată. Instrumentele care citesc, creează sau modifică date întreabă prima dată, iar tu poți alege Permiteți întotdeauna. Această permisiune apare în Configurări, Partajarea datelor, Instrumente permise, unde o poți revoca.