MCP-asiakas iPhonessa: listatut liitännät, oma palvelimesi ja rajoitukset

Orvena on MCP-asiakas iPhonelle. Se yhdistää avustajan Notioniin, Lineariin, GitHubiin, Jira & Confluence -palveluun, Zapieriin ja Home Assistantiin tai itse ylläpitämääsi MCP-palvelimeen, ja antaa Apple Intelligencen, Private Cloud Computen, Orvenan oman mallin tai OpenRouter-mallin kutsua niiden työkaluja. Tämä opas käy läpi käyttöönoton näkymät nimeltä, säännöt, jotka oman palvelimen on täytettävä, miten työkalut mahtuvat pieneen konteksti-ikkunaan, ja hyväksynnät, jotka näet ennen kuin mitään muutetaan tai lähetetään.

Mitä MCP-asiakas tekee iPhonessa

MCP eli Model Context Protocol on avoin standardi palvelujen liittämiseen tekoälyavustajiin. Palvelu ylläpitää MCP-palvelinta, joka listaa sen työkalut, kunkin nimellä, kuvauksella ja argumenteilla, joita työkalu ottaa vastaan, ja asiakas kutsuu työkalua, kun malli pyytää sitä. Orvena on asiakas, joka viestii kunkin palvelimen kanssa HTTPS:n yli suoraan iPhonestasi.

Orvena yhdistää vain etäpalvelimiin MCP streamable HTTP -siirrolla. Paikallinen stdio-palvelin, jollaisen työpöytäsovellus käynnistää komentona, ei voi toimia Orvenan sisällä, joten sijoita se etäkäytettävän HTTPS-sillan taakse ja lisää sillan osoite.

Orvenan listaamat liitännät

Avaa valikko vasemmasta yläkulmasta, sitten Asetukset ja sitten Yhteydet (rivi, jonka otsikko on "Yhdistä omat palvelusi"). Versio 2.0.0 listaa kuusi palvelua:

Malli lukee nämä kuvaukset päättääkseen, mitä palvelua pyyntö tarvitsee. Kukin palvelin ilmoittaa omat työkalunsa kirjautumisen jälkeen, ja rivillä näkyy niiden määrä. Slack, Figma, Canva, Todoist ja PayPal puuttuvat listalta, koska Orvena ei tällä hetkellä pysty täyttämään niiden kirjautumisvaatimuksia.

1. Napauta kortissa Yhdistä. Ilman Premium Unlockia painikkeessa lukee Premium, ja se avaa ostonäkymän.
2. Notionissa, Linearissa ja Jira & Confluence -palvelussa palvelun oma kirjautumissivu avautuu ikkunaan, kun palvelin pyytää kirjautumista. Hyväksy pääsy siellä.
3. GitHubissa ikkuna, jonka otsikko on "Valtuuta Orvena", näyttää kertakoodin. Napauta "Kopioi koodi ja avaa GitHub", liitä koodi ja hyväksy. Ikkunassa lukee "Odotetaan valtuutusta…", kunnes GitHub vahvistaa.
4. Palvelu siirtyy ylempään listaan, ja sen tila muuttuu tekstistä "Yhdistetään…" sen työkalujen määrään.

Home Assistant MCP iPhonessa sekä Zapier

Molemmat käyttävät kirjautumissivun sijaan tunnusta. Lisää Home Assistantissa "Model Context Protocol Server" -integraatio ja luo sitten tunnus profiilisi kohdasta Security, Long-lived access tokens (pitkäikäiset käyttötunnukset). Napauta Orvenassa Home Assistantin kohdalla Yhdistä, kirjoita osoite kohtaan "Missä se sijaitsee?", esimerkiksi https://your-home:8123/api/mcp, ja liitä tunnus.

Orvena vaatii tässä HTTPS:n myös omassa verkossasi, joten se ei lähetä tunnusta http://-osoitteeseen, kuten http://homeassistant.local:8123, eikä paikalliseen IP-osoitteeseen http://:n kautta. Jos osoite alkaa http://, ikkunan Yhdistä-painike ei tee mitään. Home Assistant tarvitsee kelvollisen TLS-varmenteen tai luotetun HTTPS-käänteisvälityspalvelimen.

Zapier pyytää vain tunnusta: luo osoitteessa mcp.zapier.com palvelin, valitse sen sovellukset ja kopioi yhteystunnus Connect-välilehdeltä.

Oman MCP-palvelimen lisääminen

Yhteydet-näkymän viimeinen kortti, "Oma palvelimesi", avaa näkymän "Mukautettu palvelin". Osoitteen on alettava https:// ja sisällettävä isäntänimi, eikä siinä saa olla käyttäjänimeä, salasanaa tai #-fragmenttia. Palvelimen on puhuttava MCP streamable HTTP:tä, vastattava pelkällä JSONilla tai SSE-virralla ja tuettava protokollaversiota 2025-11-25, 2025-06-18 tai 2025-03-26. Uudelleenohjausten on pysyttävä saman alkuperän (origin) sisällä, eikä palvelinta, joka ei ilmoita yhtään työkalua, tallenneta.

1. Täytä Nimi ja osoitekenttä, jonka paikkamerkkinä on https://server.example/mcp.
2. Jos palvelin käyttää API-avainta tai tunnusta, liitä se kenttään "Bearer token (optional)". Jos kenttä jää tyhjäksi, Orvena kokeilee ensin avointa pääsyä ja sitten kirjautumista.
3. Jos OAuth-palvelin ei kerro, mitä käyttöoikeusalueita (scopes) se tarvitsee, kirjoita ne kenttään "OAuth scopes, space-separated (optional)".
4. Kirjoita kenttään "Missä tämä palvelin voi auttaa? (valinnainen)" lause siitä, mihin palvelinta käytetään.
5. Napauta "Lisää palvelin". Painikkeessa lukee "Tarkistetaan…", kun Orvena yhdistää ja listaa työkalut.

Orvena aloittaa OAuthin vasta HTTP-vastauksen 401 tai 403 tai WWW-Authenticate-haasteen jälkeen, ja valtuutuspalvelimen on tuettava PKCE:tä S256-menetelmällä.

Orvena käyttää käyttötarkoitusriviä vain päättäessään, milloin palvelin ladataan. Ilman sitä se muodostaa kunkin palvelimen yhteenvedon enintään neljästä työkalukuvauksesta 320 merkkiin lyhennettynä. Jos jostakin työkalusta puuttuu kuvaus, rivillä näkyy "Add a purpose so Orvena can choose this server reliably." (lisää käyttötarkoitus, jotta Orvena osaa valita palvelimen luotettavasti), ja jos kuvausta ei ole yhdelläkään työkalulla, palvelinta käytetään vain, kun mainitset sen nimeltä. Korjaa tämä rivin •••-valikon kohdasta "Kuvaile käyttötarkoitus".

Mihin tarvitset Premium Unlockin

Kaikki yhteydet vaativat sen, sekä kuusi listattua palvelua että jokainen itse lisäämäsi palvelin. Premium Unlock on 14,99 dollarin kertaostos ilman tilausta, ja se lisää myös Private Cloud Computen iOS 27:ssä, pilvimallit omalla OpenRouter-avaimellasi, äänikeskustelut ja ajastetut tehtävät. Apple Intelligence ja Orvenan ladattu malli ovat ilmaisia, mutta ilman Premium Unlockia ne vastaavat ilman liitäntöjen työkaluja.

MCP:n käyttö Apple Intelligencen ja muiden moottorien kanssa

Kaikki neljä Mallit-näkymän moottoria saavat liitäntöjen työkalut. Apple Intelligenceä ja Private Cloud Computea varten Orvena muuntaa kunkin MCP-työkalun JSON-skeeman Applen Foundation Models -kehyksen skeemamuotoon. Jos työkalun skeema käyttää jotain, mitä kehys ei pysty ilmaisemaan, Applen mallit saavat työkalun ilman argumentteja, joten käytä siihen Orvenan mallia tai OpenRouteria. Poikkeus on OpenRouter-malli, joka on listattu ilman työkalutukea: "Tämä malli ei voi käyttää työkaluja, joten Orvena vastaa ilman niitä."

Oletusasetus Automaattinen ei koskaan valitse Private Cloud Computea tai OpenRouteria itsestään.

Miten työkalulistat ja tulokset mahtuvat pieneen ikkunaan

8 192 tokenin ikkunaan ei mahdu kymmeniä työkalumäärittelyjä, joten liitäntöjen työkaluja ei koskaan anneta mallille kaikkia kerralla. Malli kutsuu ensin load_connectors-työkalua ja valitsee yhden tai kaksi palvelua yhdistettyjen palvelujen listasta, jossa kukin on kuvattu enintään 180 merkillä (yhteensä 8 192 merkkiä). Sitten load_tools valitsee niistä yhdestä kahdeksaan toimintoa. Vain ne tulevat kutsuttaviksi.

Ennen jokaista mallikierrosta Orvena laskee yhteen ohjeet, ladatut työkaluskeemat ja 900 tokenin varan. Jos summa ylittää ikkunan koon miinus 512 tokenia, se pudottaa liitäntöjen työkaluja uusimmasta alkaen, lukuun ottamatta niitä, joita pyynnön on vielä kutsuttava, ja sen jälkeen vanhimman taidon. Jos tarvittava toiminto ei vieläkään mahdu, vuoro pysähtyy ilmoitukseen "The required connector operation is too large for this model's context window." (tarvittava liitäntätoiminto on liian suuri tämän mallin konteksti-ikkunaan).

Työkalujen kuvaukset lyhennetään 500 merkkiin, ja tulokset merkitään epäluotettavaksi dataksi, mikä kertoo mallille, että sivulta tai issuesta tuleva teksti on sisältöä eikä ohjeita. Budjetin ylittävä tulos tiivistetään: sivutuskentät tulevat ensin, linkit ja pitkät hajautusarvot poistetaan, listan objekteista säilyy enintään 12 kenttää, ja pitkiä merkkijonoja lyhennetään, mistä mallille kerrotaan erillisellä huomautuksella.

Pitkissä keskusteluissa Orvena säilyttää viimeisimmät kokonaiset vuorot moottorin ikkunan rajoissa ja pudottaa vanhimmat. Se ei tee tiivistelmiä. Kun sekään ei riitä, Apple Intelligence näyttää viestin "Tämä keskustelu on liian pitkä Apple Intelligencelle. Aloita uusi keskustelu tai vaihda Orvenan ladattuun malliin kohdassa Mallit."

Hyväksynnät ennen kuin mitään muuttuu tai lähtee

Orvena luokittelee jokaisen MCP-työkalun sen palvelimen ilmoittamien vihjeiden perusteella: vain lukevissa työkaluissa näkyy "Lukee tietoja muuttamatta niitä.", tuhoavissa "Poistaa, peruu tai tekee toiminnon, jota ei voi kumota." ja muissa "Luo tai muuttaa tietoja."

• Lukevat ja kirjoittavat työkalut kysyvät ensimmäisellä kerralla. Ikkunassa, jonka otsikko on "HYVÄKSY TÄMÄ TOIMINTO", on painikkeet "Älä salli" ja "Salli", ja sen valikossa ovat "Salli kerran" ja "Salli aina".
• Tuhoavat työkalut kysyvät joka kerta, ja vaihtoehtona on vain "Salli kerran".
• Ikkuna listaa tarkat argumentit niin, että tunnukset, salasanat ja muut kirjautumistietojen kaltaiset kentät näkyvät muodossa [REDACTED CREDENTIAL], ja kertoo, minne ne menevät, esimerkiksi "Lähettää tähän toimintoon tarvittavat tiedot kohteeseen Notion."
• Jos sama vuoro on jo lukenut jotain henkilökohtaista, kuten kalenterisi tai toisen liitännän tuloksen, hyväksynnän otsikkona on "Send data to" (lähetä tiedot kohteeseen) ja palvelun nimi. Terveystietojen jälkeen se kysyy joka kerta.

Private Cloud Compute kysyy kerran, kun valitset sen Mallit-näkymässä, ja kertoo, että jokainen vastaus lähettää "keskustelusi ja tarvittavat työkalutulokset Applen palvelimille". Liitäntöjen hyväksynnöissä kohteena näkyy silloin "Notion → Private Cloud Compute". OpenRouter kysyy ennen keskustelun ensimmäistä pyyntöä ja uudelleen kysymyksellä "Käytetäänkö kohdetta OpenRouter arkaluonteisten tietojen kanssa?", kun historiassa on liitännän tulos. Tallennetut luvat löytyvät kohdasta Asetukset, Tietojen jakaminen, jossa voit perua ne.

Minne tiedot menevät

Liitäntöjen liikenne kulkee iPhonesta suoraan palveluun, eikä välissä ole Orvena-palvelinta. Palvelu ja sen kirjautumispalvelin saavat hyväksymäsi argumentit, palauttamansa sisällön ja kirjautumisliikenteen. Tunnukset pysyvät iPhonen avainnipussa, vain tällä laitteella. Apple Intelligencellä tai Orvenan mallilla tulokset luetaan puhelimessa; Private Cloud Computella vastauksen tarvitsemat tulokset menevät Applelle ja OpenRouterilla OpenRouterille, kun olet antanut suostumuksen. Asetusten Toiminta-kohta säilyttää enintään 30 päivän ajalta työkalujen nimet, lopputulokset ja kohteet, ei koskaan argumentteja. Katkaise yhteys -toiminto poistaa paikalliset kirjautumistiedot ja työkalut, ja vahvistus muistuttaa perumaan pääsyn myös palvelussa, esimerkiksi "Orvenan valtuutus voi silti olla tarpeen perua palvelun Notion tiliasetuksissa." Laajempi kuva on artikkelissa mikä tekee tekoälyavustajasta yksityisen.

Vianmääritys

Usein kysyttyä

Voinko ajaa MCP-palvelinta iPhonessani?

Et Orvenan sisällä. Orvena on MCP-asiakas, joka yhdistää etäpalvelimiin HTTPS:n yli MCP streamable HTTP -siirrolla. Paikallinen stdio-palvelin ei voi toimia Orvenan sisällä, joten aja se muualla HTTPS-sillan takana ja lisää sillan osoite kohdassa Oma palvelimesi.

Voiko Apple Intelligence käyttää MCP-työkaluja?

Orvenassa voi. iOS 27:ssä Orvena antaa Applen laitteella toimivalle mallille ja Private Cloud Computelle yhdistämiesi palvelimien työkalut Applen Foundation Models -kehyksen muotoon muunnettuina. Kerrallaan ladattuna on yksi tai kaksi palvelua ja enintään kahdeksan niiden toimintoa, mikä pitää työkalumäärittelyt tarpeeksi pieninä laitteella toimivan mallin ikkunaan.

Miten yhdistän Home Assistantin iPhonen tekoälyavustajaan MCP:n kautta?

Lisää Home Assistantissa Model Context Protocol Server -integraatio ja luo pitkäikäinen käyttötunnus (long-lived access token) profiilisi Security-kohdassa. Napauta Orvenassa Home Assistantin kohdalla Yhdistä, kirjoita /api/mcp-päätteinen HTTPS-osoite ja liitä tunnus. Pelkät http-osoitteet hylätään, myös kotiverkossa.

Voinko käyttää Notionin MCP-palvelinta iPhonessa?

Kyllä. Notion on yksi Orvenan kuudesta listatusta liitännästä. Napauta Yhdistä kohdassa Asetukset, Yhteydet, kirjaudu Notioniin ja hyväksy pääsy. Orvena käyttää Notionin ylläpitämää palvelinta osoitteessa mcp.notion.com ja kysyy luvan ennen kuin Notion-työkalu suoritetaan ensimmäisen kerran. Yhteydet kuuluvat Premium Unlockiin.

Kysyykö jokainen MCP-toiminto hyväksyntää?

Tuhoavat toiminnot kysyvät joka kerta. Tietoja lukevat, luovat tai muuttavat työkalut kysyvät ensimmäisellä kerralla, ja voit valita Salli aina. Lupa näkyy kohdassa Asetukset, Tietojen jakaminen, Sallitut työkalut, jossa voit perua sen.