Usare un client MCP su iPhone: i connettori elencati, il tuo server e i limiti

Orvena è un client MCP per iPhone. Collega l'assistente a Notion, Linear, GitHub, Jira & Confluence, Zapier e Home Assistant, oppure a un server MCP che gestisci tu, e permette ad Apple Intelligence, a Private Cloud Compute, al modello di Orvena o a un modello OpenRouter di chiamarne gli strumenti. Questa guida descrive le schermate di configurazione con il loro nome, le regole che un server personalizzato deve rispettare, come gli strumenti entrano in una finestra di contesto piccola e le approvazioni che vedrai prima che qualcosa venga modificato o inviato.

Cosa fa un client MCP su iPhone

MCP, il Model Context Protocol, è uno standard aperto per collegare servizi agli assistenti IA. Un servizio esegue un server MCP che elenca i suoi strumenti, ciascuno con un nome, una descrizione e gli argomenti che accetta, e il client chiama uno strumento quando il modello lo richiede. Orvena è il client e comunica con ogni server via HTTPS, direttamente dal tuo iPhone.

Orvena si collega solo a server remoti tramite MCP streamable HTTP. Un server stdio locale, quello che un'app desktop avvia come comando, non può funzionare dentro Orvena: mettilo dietro un bridge HTTPS remoto e aggiungi quell'indirizzo.

I connettori elencati da Orvena

Apri il menu in alto a sinistra, poi Impostazioni, poi Connessioni (la riga intitolata "Collega le tue cose"). La versione 2.0.0 elenca sei servizi:

Il modello legge queste descrizioni per decidere di quale servizio ha bisogno una richiesta. Ogni server comunica i propri strumenti dopo l'accesso, e la riga ne mostra il numero. Slack, Figma, Canva, Todoist e PayPal non sono elencati perché oggi Orvena non riesce a soddisfare i loro requisiti di accesso.

1. Tocca Collega su una scheda. Senza Premium Unlock il pulsante mostra Premium e apre la schermata di acquisto.
2. Per Notion, Linear e Jira & Confluence, la pagina di accesso del servizio si apre in una finestra non appena il server chiede l'accesso. Approva l'accesso lì.
3. Per GitHub, una finestra intitolata "Autorizza Orvena" mostra un codice monouso. Tocca "Copia il codice e apri GitHub", incolla il codice e approva. La finestra mostra "In attesa dell'autorizzazione…" finché GitHub non conferma.
4. Il servizio passa all'elenco in alto e il suo stato cambia da "Collegamento…" al numero di strumenti.

Home Assistant MCP su iPhone, e Zapier

Entrambi usano un token invece di una pagina di accesso. In Home Assistant aggiungi l'integrazione "Model Context Protocol Server", poi crea un token di accesso a lunga durata (Long-lived access token) dal tuo profilo, nella scheda Sicurezza. In Orvena tocca Collega su Home Assistant, inserisci l'indirizzo sotto "Dove si trova?", per esempio https://your-home:8123/api/mcp, e incolla il token.

Qui Orvena richiede HTTPS anche sulla tua rete, quindi non invia il token a un indirizzo http://, come http://homeassistant.local:8123 o un indirizzo IP locale via http://. Con un indirizzo http:// il pulsante Collega della finestra non fa nulla. Home Assistant ha bisogno di un certificato TLS valido o di un reverse proxy HTTPS attendibile.

Zapier chiede solo il token: su mcp.zapier.com crea un server, scegli le sue app e copia il token di connessione dalla scheda Connect.

Come aggiungere un tuo server MCP

L'ultima scheda in Connessioni, "Il tuo server", apre "Server personalizzato". L'URL deve usare https:// con un nome host e non deve contenere nome utente, password o #frammento. Il server deve parlare MCP streamable HTTP, rispondendo con JSON semplice o con uno stream SSE, e supportare la versione di protocollo 2025-11-25, 2025-06-18 o 2025-03-26. I reindirizzamenti devono restare sulla stessa origine, e un server che non dichiara alcuno strumento non viene salvato.

1. Compila Nome e il campo dell'indirizzo, il cui segnaposto è https://server.example/mcp.
2. Se il server usa una chiave API o un token, incollalo in "Bearer token (optional)" (facoltativo). Se lo lasci vuoto, Orvena prova l'accesso libero e poi il login.
3. Se un server OAuth non dice di quali scope ha bisogno, inseriscili in "OAuth scopes, space-separated (optional)" (scope separati da spazi, facoltativo).
4. In "In cosa può aiutare questo server? (facoltativo)" scrivi una frase su a cosa serve.
5. Tocca "Aggiungi server". Mentre Orvena si collega ed elenca gli strumenti, compare "Verifica in corso…".

Orvena avvia OAuth solo dopo una risposta HTTP 401 o 403 o una richiesta WWW-Authenticate, e il server di autorizzazione deve supportare PKCE con S256.

Orvena usa la frase sullo scopo solo per decidere quando caricare il server. Se manca, costruisce il riepilogo di ogni server da un massimo di quattro descrizioni di strumenti, tagliato a 320 caratteri. Se a uno strumento manca la descrizione, la riga mostra "Add a purpose so Orvena can choose this server reliably." (aggiungi uno scopo perché Orvena possa scegliere questo server in modo affidabile), e se non ce l'ha nessuno, il server viene usato solo quando lo nomini. Puoi rimediare con "Descrivi lo scopo" nel menu ••• della riga.

Cosa richiede Premium Unlock

Tutte le connessioni lo richiedono, sia i sei servizi elencati sia qualsiasi server che aggiungi tu. Premium Unlock è un acquisto una tantum da 14,99 $, senza abbonamento, e aggiunge anche Private Cloud Compute su iOS 27, i modelli cloud con la tua chiave OpenRouter, le conversazioni vocali e le attività pianificate. Apple Intelligence e il modello scaricato di Orvena sono gratis, ma senza lo sblocco rispondono senza gli strumenti dei connettori.

Usare MCP con Apple Intelligence e gli altri motori

Tutti e quattro i motori della schermata Modelli ricevono gli strumenti dei connettori. Per Apple Intelligence e Private Cloud Compute, Orvena converte lo schema JSON di ogni strumento MCP nel formato di schema del framework Foundation Models di Apple. Se lo schema di uno strumento usa qualcosa che il framework non sa esprimere, i modelli di Apple ricevono quello strumento senza argomenti, quindi per quello strumento usa il modello di Orvena o OpenRouter. Fa eccezione un modello OpenRouter indicato come privo di supporto agli strumenti: "Questo modello non può usare gli strumenti, quindi Orvena risponderà senza."

Automatico, l'impostazione predefinita del motore, non sceglie mai da solo Private Cloud Compute o OpenRouter.

Come elenchi e risultati degli strumenti entrano in una finestra piccola

Una finestra da 8.192 token lascia poco spazio a decine di definizioni di strumenti, quindi gli strumenti dei connettori non arrivano mai al modello tutti insieme. Prima il modello chiama load_connectors per scegliere uno o due servizi da un elenco dei servizi collegati, ciascuno descritto in al massimo 180 caratteri (8.192 caratteri in tutto). Poi load_tools sceglie tra questi da una a otto operazioni. Solo quelle diventano richiamabili.

Prima di ogni passaggio del modello, Orvena somma le istruzioni, gli schemi degli strumenti caricati e 900 token di margine. Se il totale supera la finestra meno 512 token, scarta gli strumenti dei connettori, a partire dai più recenti, tranne quelli che la richiesta deve ancora chiamare, e poi la skill più vecchia. Se l'operazione necessaria continua a non entrare, il turno si ferma con "The required connector operation is too large for this model's context window." (l'operazione del connettore richiesta è troppo grande per la finestra di contesto di questo modello).

Le descrizioni degli strumenti vengono tagliate a 500 caratteri, e i risultati vengono marcati come dati non attendibili, il che dice al modello di trattare il testo di una pagina o di una issue come contenuto, non come istruzioni. Un risultato che supera il budget viene compattato: i campi di paginazione vengono per primi, link e hash lunghi vengono eliminati, gli oggetti di un elenco mantengono al massimo 12 campi e le stringhe lunghe vengono accorciate, con una nota che lo segnala al modello.

Nelle conversazioni lunghe Orvena mantiene interi i turni recenti che rientrano nella finestra del motore e scarta i più vecchi. Non fa riassunti. Quando nemmeno così la conversazione rientra, Apple Intelligence mostra "Questa conversazione è troppo lunga per Apple Intelligence. Avvia una nuova conversazione o passa al modello scaricato di Orvena in Modelli."

Approvazioni prima che qualcosa cambi o esca dal telefono

Orvena classifica ogni strumento MCP in base alle indicazioni dichiarate dal suo server: gli strumenti di sola lettura mostrano "Legge dati senza modificarli.", quelli distruttivi "Elimina, annulla o esegue un'azione irreversibile." e gli altri "Crea o modifica dati."

• Gli strumenti di lettura e scrittura chiedono conferma la prima volta. La finestra, intitolata "APPROVA QUESTA AZIONE", ha "Non consentire" e "Consenti", con "Consenti una volta" o "Consenti sempre" nel suo menu.
• Gli strumenti distruttivi chiedono conferma ogni volta, solo con "Consenti una volta".
• La finestra elenca gli argomenti esatti, con token, password e altri campi simili a credenziali mostrati come [REDACTED CREDENTIAL], e dice dove vanno, per esempio "Invia a Notion i dati necessari per questa azione."
• Se nello stesso turno è già stato letto qualcosa di personale, come il tuo calendario o il risultato di un altro connettore, l'approvazione ha come titolo "Send data to" (invia dati a) seguito dal nome del servizio. Dopo che sono stati letti dati di Salute, chiede conferma ogni volta.

Private Cloud Compute chiede conferma una volta, quando lo scegli in Modelli, e avvisa che ogni risposta invia "la tua conversazione, e i risultati degli strumenti necessari, ai server Apple". Le approvazioni dei connettori mostrano poi "Notion → Private Cloud Compute" come destinazione. OpenRouter chiede conferma prima della prima richiesta in una conversazione, e di nuovo con "Usare OpenRouter con dati sensibili?" quando nella cronologia c'è il risultato di un connettore. Le autorizzazioni salvate si trovano in Impostazioni, Condivisione dati, dove puoi revocarle.

Dove vanno i dati

Il traffico dei connettori va dall'iPhone direttamente al servizio, senza alcun server Orvena in mezzo. Il servizio e il suo server di accesso ricevono gli argomenti che hai approvato, i contenuti che restituiscono e il traffico di accesso. I token restano nel portachiavi dell'iPhone, solo su questo dispositivo. Con Apple Intelligence o con il modello di Orvena i risultati vengono letti sul telefono; con Private Cloud Compute i risultati necessari a una risposta vanno ad Apple, e con OpenRouter vanno a OpenRouter dopo il tuo consenso. La sezione Attività delle Impostazioni conserva fino a 30 giorni di nomi di strumenti, esiti e destinazioni, mai gli argomenti. Scollega rimuove le credenziali e gli strumenti locali, e la conferma ti ricorda di revocare l'accesso anche sul servizio, per esempio "Potrebbe essere comunque necessario revocare Orvena nelle impostazioni dell'account di Notion." Il quadro generale è in cosa rende privato un assistente IA.

Risoluzione dei problemi

Domande frequenti

Posso eseguire un server MCP sul mio iPhone?

Non dentro Orvena. Orvena è un client MCP che si collega a server remoti via HTTPS con MCP streamable HTTP. Un server stdio locale non può funzionare dentro Orvena, quindi eseguilo altrove dietro un bridge HTTPS e aggiungi quell'indirizzo dalla scheda Il tuo server.

Apple Intelligence può usare gli strumenti MCP?

In Orvena sì. Su iOS 27, Orvena dà al modello di Apple sul dispositivo e a Private Cloud Compute gli strumenti dei server che colleghi, convertiti nel formato del framework Foundation Models di Apple. In ogni momento tiene caricati uno o due servizi e al massimo otto delle loro operazioni, così le definizioni degli strumenti restano abbastanza piccole per la finestra del modello sul dispositivo.

Come collego Home Assistant a un assistente IA su iPhone tramite MCP?

In Home Assistant aggiungi l'integrazione Model Context Protocol Server e crea un token di accesso a lunga durata dal tuo profilo, nella scheda Sicurezza. In Orvena tocca Collega su Home Assistant, inserisci l'indirizzo HTTPS che termina con /api/mcp e incolla il token. Gli indirizzi http semplici vengono rifiutati, anche sulla rete di casa.

Posso usare il server MCP di Notion su iPhone?

Sì. Notion è uno dei sei connettori elencati da Orvena. Tocca Collega in Impostazioni, Connessioni, accedi a Notion e approva l'accesso. Orvena usa il server ospitato da Notion su mcp.notion.com e chiede conferma prima che uno strumento di Notion venga eseguito per la prima volta. Le connessioni fanno parte di Premium Unlock.

Ogni azione MCP chiede un'approvazione?

Le azioni distruttive chiedono conferma ogni volta. Gli strumenti che leggono, creano o modificano dati chiedono conferma la prima volta, e puoi scegliere Consenti sempre. Quell'autorizzazione compare in Impostazioni, Condivisione dati, Strumenti consentiti, dove puoi revocarla.