Een MCP-client gebruiken op iPhone: de connectors, je eigen server en de beperkingen

Orvena is een MCP-client voor de iPhone. De app verbindt de assistent met Notion, Linear, GitHub, Jira & Confluence, Zapier en Home Assistant, of met een MCP-server die je zelf draait, en laat Apple Intelligence, Private Cloud Compute, het eigen model van Orvena of een OpenRouter-model hun tools aanroepen. Deze gids noemt de instelschermen bij naam en behandelt de regels waaraan een eigen server moet voldoen, hoe tools in een klein contextvenster passen, en de goedkeuringen die je ziet voordat er iets wordt gewijzigd of verstuurd.

Wat een MCP-client op iPhone doet

MCP, het Model Context Protocol, is een open standaard om diensten aan AI-assistenten te koppelen. Een dienst draait een MCP-server die zijn tools opsomt, elk met een naam, een beschrijving en de argumenten die de tool accepteert, en de client roept een tool aan als het model daarom vraagt. Orvena is de client en praat met elke server via HTTPS, rechtstreeks vanaf je iPhone.

Orvena maakt alleen verbinding met externe servers via MCP streamable HTTP. Een lokale stdio-server, het soort dat een desktopapp als commando start, kan niet in Orvena draaien. Zet zo'n server achter een externe HTTPS-bridge en voeg dat adres toe.

De connectors die Orvena aanbiedt

Open het menu linksboven, dan Instellingen, dan Verbindingen (de rij met de titel "Verbind je spullen"). Versie 2.0.0 toont zes diensten:

Het model leest deze beschrijvingen om te bepalen welke dienst een verzoek nodig heeft. Elke server meldt na het inloggen zijn eigen tools, en de rij toont hoeveel het er zijn. Slack, Figma, Canva, Todoist en PayPal staan er niet tussen, omdat Orvena op dit moment niet aan hun inlogvereisten kan voldoen.

1. Tik op een kaart op Verbind. Zonder Premium Unlock staat er Premium op de knop, en die opent het aankoopscherm.
2. Bij Notion, Linear en Jira & Confluence opent de inlogpagina van de dienst zelf in een venster zodra de server om inloggen vraagt. Geef daar toegang.
3. Bij GitHub toont een venster met de titel "Autoriseer Orvena" een eenmalige code. Tik op "Kopieer code en open GitHub", plak de code en geef toestemming. In het venster staat "Wachten op autorisatie…" tot GitHub bevestigt.
4. De dienst verschijnt in de bovenste lijst, en de status verandert van "Verbinden…" in het aantal tools.

Home Assistant MCP op iPhone, en Zapier

Beide gebruiken een token in plaats van een inlogpagina. Voeg in Home Assistant de integratie "Model Context Protocol Server" toe en maak daarna een token aan onder je profiel, Beveiliging, Langdurige toegangstokens (Long-lived access tokens). Tik in Orvena bij Home Assistant op Verbind, vul het adres in onder "Waar draait het?", bijvoorbeeld https://your-home:8123/api/mcp, en plak het token.

Orvena eist hier HTTPS, ook op je eigen netwerk, en stuurt het token dus niet naar een http://-adres, zoals http://homeassistant.local:8123 of een lokaal IP-adres via http://. Met een http://-adres doet de knop Verbind in het venster niets. Home Assistant heeft een geldig TLS-certificaat of een vertrouwde HTTPS-reverse proxy nodig.

Zapier vraagt alleen om het token: maak op mcp.zapier.com een server aan, kies de apps en kopieer het verbindingstoken op het tabblad Connect.

Zo voeg je je eigen MCP-server toe

De laatste kaart bij Verbindingen, "Je eigen server", opent "Aangepaste server". De URL moet https:// gebruiken met een hostnaam en mag geen gebruikersnaam, wachtwoord of #fragment bevatten. De server moet MCP streamable HTTP spreken, antwoorden met gewone JSON of een SSE-stream, en protocolversie 2025-11-25, 2025-06-18 of 2025-03-26 ondersteunen. Omleidingen moeten binnen dezelfde origin blijven, en een server die geen tools meldt, wordt niet bewaard.

1. Vul Naam en het adresveld in; de voorbeeldtekst in dat veld is https://server.example/mcp.
2. Gebruikt de server een API-sleutel of token, plak die dan in "Bearer token (optional)" (bearer-token, optioneel). Laat je het veld leeg, dan probeert Orvena eerst open toegang en daarna inloggen.
3. Zegt een OAuth-server niet welke scopes hij nodig heeft, vul ze dan in bij "OAuth scopes, space-separated (optional)" (OAuth-scopes, gescheiden door spaties, optioneel).
4. Schrijf bij "Waarmee kan deze server helpen? (optioneel)" een zin over waar de server voor is.
5. Tik op "Voeg server toe". Er staat "Controleren…" terwijl Orvena verbinding maakt en de tools ophaalt.

Orvena start OAuth pas na een HTTP 401, 403 of een WWW-Authenticate-challenge, en de autorisatieserver moet PKCE met S256 ondersteunen.

Orvena gebruikt de doelomschrijving alleen om te bepalen wanneer de server wordt geladen. Zonder omschrijving bouwt Orvena de samenvatting van elke server uit maximaal vier toolbeschrijvingen, ingekort tot 320 tekens. Ontbreekt bij een tool de beschrijving, dan toont de rij "Add a purpose so Orvena can choose this server reliably." (voeg een doel toe, zodat Orvena deze server betrouwbaar kan kiezen), en heeft geen enkele tool er een, dan wordt de server alleen gebruikt als je hem bij naam noemt. Los dat op met "Beschrijf het doel" in het •••-menu van de rij.

Waarvoor je Premium Unlock nodig hebt

Alle verbindingen hebben het nodig: de zes diensten uit de lijst en elke server die je zelf toevoegt. Premium Unlock is een eenmalige aankoop van $14,99 zonder abonnement, en voegt daarnaast Private Cloud Compute op iOS 27 toe, cloudmodellen met je eigen OpenRouter-sleutel, spraakgesprekken en geplande taken. Apple Intelligence en het gedownloade model van Orvena zijn gratis, maar zonder Premium Unlock antwoorden ze zonder connectortools.

MCP gebruiken met Apple Intelligence en de andere engines

Alle vier de engines op het scherm Modellen krijgen de connectortools. Voor Apple Intelligence en Private Cloud Compute zet Orvena het JSON-schema van elke MCP-tool om naar het schemaformaat van het Foundation Models-framework van Apple. Gebruikt het schema van een tool iets wat het framework niet kan uitdrukken, dan krijgen de modellen van Apple die tool zonder argumenten; gebruik daarvoor dus het model van Orvena of OpenRouter. Een OpenRouter-model dat zonder toolondersteuning wordt vermeld, is de uitzondering: "Dit model kan geen tools gebruiken, dus Orvena antwoordt zonder."

Automatisch, de standaardinstelling voor de engine, kiest nooit uit zichzelf Private Cloud Compute of OpenRouter.

Hoe toollijsten en resultaten in een klein venster passen

Een venster van 8.192 tokens heeft weinig ruimte voor tientallen tooldefinities, dus connectortools gaan nooit allemaal tegelijk naar het model. Het model roept eerst load_connectors aan om een of twee diensten te kiezen uit een lijst van de verbonden diensten, elk beschreven in maximaal 180 tekens (8.192 tekens in totaal). Daarna kiest load_tools daaruit een tot acht bewerkingen. Alleen die kunnen worden aangeroepen.

Voor elke modelronde telt Orvena de instructies, de geladen toolschema's en 900 tokens speling bij elkaar op. Is dat meer dan het venster min 512 tokens, dan laat Orvena connectortools vallen, de nieuwste eerst, behalve die het verzoek nog moet aanroepen, en daarna de oudste skill. Past de benodigde bewerking dan nog steeds niet, dan stopt de beurt met "The required connector operation is too large for this model's context window." (de benodigde connectorbewerking is te groot voor het contextvenster van dit model).

Toolbeschrijvingen worden ingekort tot 500 tekens, en resultaten worden gemarkeerd als niet-vertrouwde gegevens, zodat het model tekst van een pagina of issue als inhoud behandelt en niet als instructies. Een resultaat dat boven het budget uitkomt, wordt compacter gemaakt: pagineringsvelden komen eerst, links en lange hashes verdwijnen, objecten in een lijst houden maximaal 12 velden, en lange tekenreeksen worden ingekort, met een notitie die het model daarvan op de hoogte brengt.

In lange gesprekken houdt Orvena hele recente beurten binnen het venster van de engine en laat het de oudste vallen. Het maakt geen samenvatting. Past zelfs dat niet, dan toont Apple Intelligence "Dit gesprek is te lang voor Apple Intelligence. Begin een nieuw gesprek of schakel bij Modellen over naar het gedownloade model van Orvena."

Goedkeuringen voordat er iets verandert of vertrekt

Orvena deelt elke MCP-tool in op basis van de hints die de server opgeeft: tools die alleen lezen tonen "Leest gegevens zonder ze te wijzigen.", destructieve tools "Verwijdert, annuleert of voert een onomkeerbare actie uit.", en de rest "Maakt of wijzigt gegevens."

• Lees- en schrijftools vragen het de eerste keer. Het venster, met de kop "KEUR DEZE ACTIE GOED", heeft "Sta niet toe" en "Sta toe", met "Sta eenmalig toe" of "Sta altijd toe" in het menu.
• Destructieve tools vragen het elke keer, en dan alleen met "Sta eenmalig toe".
• Het venster toont de exacte argumenten, waarbij tokens, wachtwoorden en andere velden die op inloggegevens lijken als [REDACTED CREDENTIAL] verschijnen, en zegt waar ze heen gaan, bijvoorbeeld "Stuurt de gegevens die voor deze actie nodig zijn naar Notion."
• Heeft dezelfde beurt al iets persoonlijks gelezen, zoals je agenda of het resultaat van een andere connector, dan heet de goedkeuring "Send data to" (gegevens versturen naar) met de naam van de dienst erachter. Na gezondheidsgegevens vraagt het elke keer.

Voor Private Cloud Compute vraagt Orvena één keer om toestemming, wanneer je het kiest bij Modellen, en meldt dat elk antwoord "je gesprek, en de toolresultaten die ervoor nodig zijn, naar de servers van Apple" stuurt. Goedkeuringen voor connectors tonen daarna "Notion → Private Cloud Compute" als bestemming. Voor OpenRouter vraagt Orvena toestemming vóór het eerste verzoek in een gesprek, en opnieuw met "OpenRouter gebruiken met gevoelige gegevens?" zodra er een connectorresultaat in de geschiedenis staat. Bewaarde toestemmingen staan onder Instellingen, Gegevensdeling, waar je ze kunt intrekken.

Waar de gegevens heen gaan

Connectorverkeer gaat van de iPhone rechtstreeks naar de dienst, zonder Orvena-server ertussen. De dienst en zijn inlogserver ontvangen de argumenten die je hebt goedgekeurd, de inhoud die ze teruggeven en het inlogverkeer. Tokens blijven in de sleutelhanger van de iPhone, alleen op dit toestel. Met Apple Intelligence of het model van Orvena worden de resultaten op de telefoon gelezen; met Private Cloud Compute gaan de resultaten die een antwoord nodig heeft naar Apple, en met OpenRouter naar OpenRouter nadat je toestemming hebt gegeven. Onder Instellingen, Activiteit worden tot 30 dagen toolnamen, uitkomsten en bestemmingen bewaard, nooit argumenten. Verbreek verbinding verwijdert de lokale inloggegevens en tools, en de bevestiging herinnert je eraan om de toegang ook bij de dienst in te trekken, bijvoorbeeld "Mogelijk moet je Orvena nog intrekken in de accountinstellingen van Notion." Het bredere plaatje staat in wat een AI-assistent privé maakt.

Problemen oplossen

Veelgestelde vragen

Kan ik een MCP-server op mijn iPhone draaien?

Niet in Orvena. Orvena is een MCP-client die via HTTPS verbinding maakt met externe servers, met MCP streamable HTTP. Een lokale stdio-server kan niet in Orvena draaien, dus draai hem ergens anders achter een HTTPS-bridge en voeg dat adres toe onder Je eigen server.

Kan Apple Intelligence MCP-tools gebruiken?

In Orvena wel. Op iOS 27 geeft Orvena het model van Apple op het toestel en Private Cloud Compute de tools van de servers die je verbindt, omgezet naar het formaat van het Foundation Models-framework van Apple. Er zijn op elk moment een of twee diensten geladen en maximaal acht van hun bewerkingen, zodat de tooldefinities klein genoeg blijven voor het venster op het toestel.

Hoe verbind ik Home Assistant via MCP met een AI-assistent op iPhone?

Voeg in Home Assistant de integratie Model Context Protocol Server toe en maak onder je profiel, Beveiliging, een langdurig toegangstoken aan. Tik in Orvena bij Home Assistant op Verbind, vul het HTTPS-adres in dat eindigt op /api/mcp en plak het token. Gewone http-adressen worden geweigerd, ook op je thuisnetwerk.

Kan ik de Notion MCP-server op iPhone gebruiken?

Ja. Notion is een van de zes connectors in de lijst van Orvena. Tik op Verbind onder Instellingen, Verbindingen, log in bij Notion en geef toegang. Orvena gebruikt de gehoste server van Notion op mcp.notion.com en vraagt om goedkeuring voordat een Notion-tool voor het eerst wordt uitgevoerd. Verbindingen horen bij Premium Unlock.

Vraagt elke MCP-actie om goedkeuring?

Destructieve acties vragen het elke keer. Tools die gegevens lezen, maken of wijzigen vragen het de eerste keer, en dan kun je Sta altijd toe kiezen. Die toestemming staat onder Instellingen, Gegevensdeling, Toegestane tools, waar je die kunt intrekken.