Poradnik

Klient MCP na iPhone'a w praktyce: konektory z listy, własny serwer i ograniczenia

29 WRZEŚNIA 2026 · 9 MIN CZYTANIA · ORVENA LABS

Orvena to klient MCP na iPhone'a. Łączy asystenta z Notion, Linear, GitHub, Jira & Confluence, Zapier i Home Assistant albo z serwerem MCP, który uruchamiasz samodzielnie, i pozwala Apple Intelligence, Private Cloud Compute, własnemu modelowi Orveny lub modelowi z OpenRouter wywoływać ich narzędzia. Ten poradnik opisuje ekrany konfiguracji, podając ich nazwy, zasady, które musi spełnić własny serwer, to, jak narzędzia mieszczą się w małym oknie kontekstu, oraz zgody, które zobaczysz, zanim cokolwiek zostanie zmienione lub wysłane.

Orvena jest darmowa na iPhone'a 15 Pro i nowsze modele. Połączenia wchodzą w skład Premium Unlock, jednorazowego zakupu. Pobierz

Co robi klient MCP na iPhonie

MCP, czyli Model Context Protocol, to otwarty standard łączenia usług z asystentami AI. Usługa uruchamia serwer MCP, który udostępnia listę swoich narzędzi, każde z nazwą, opisem i przyjmowanymi argumentami, a klient wywołuje narzędzie, gdy poprosi o to model. Orvena jest klientem i łączy się z każdym serwerem przez HTTPS bezpośrednio z Twojego iPhone'a.

Orvena łączy się tylko ze zdalnymi serwerami przez MCP streamable HTTP. Lokalny serwer stdio, czyli taki, jaki aplikacja na komputerze uruchamia jako polecenie, nie może działać w Orvenie, więc umieść go za zdalnym mostem HTTPS i dodaj zamiast niego ten adres.

Konektory z listy Orveny

Otwórz menu w lewym górnym rogu, potem Ustawienia, a następnie Połączenia (wiersz z tytułem "Połącz swoje narzędzia"). Wersja 2.0.0 wymienia sześć usług:

KonektorLogowanieDo czego służy
NotionOAuthWyszukiwanie stron, baz danych i zawartości przestrzeni roboczej oraz praca z nimi.
LinearOAuth, odczyt i zapisWyszukiwanie zgłoszeń, projektów, zespołów i danych planowania oraz praca z nimi.
GitHubJednorazowy kod, bez osobistego tokena dostępuWyszukiwanie repozytoriów, kodu, zgłoszeń i pull requestów oraz praca z nimi.
Jira & ConfluenceOAuth, 13 zakresów, w tym zapis elementów pracy w Jira i stron w ConfluenceWyszukiwanie elementów pracy w Jira oraz przestrzeni, stron i komentarzy w Confluence, a także praca z nimi.
ZapierToken połączeniaKorzystanie z aplikacji i akcji skonfigurowanych na Twoim serwerze Zapier MCP.
Home AssistantToken dostępu i Twój adres HTTPSPodgląd urządzeń, encji, scen i automatyzacji, które udostępnia, oraz sterowanie nimi.

Model czyta te opisy, aby zdecydować, której usługi potrzebuje prośba. Każdy serwer po zalogowaniu zgłasza własne narzędzia, a wiersz pokazuje ich liczbę. Slacka, Figmy, Canvy, Todoist i PayPala nie ma na liście, bo Orvena nie jest dziś w stanie spełnić ich wymagań dotyczących logowania.

  1. Stuknij Połącz na karcie. Bez Premium Unlock przycisk ma napis Premium i otwiera ekran zakupu.
  2. W przypadku Notion, Linear oraz Jira & Confluence strona logowania usługi otwiera się w osobnym oknie, gdy tylko serwer poprosi o zalogowanie. Tam zatwierdź dostęp.
  3. W przypadku GitHuba okno z tytułem "Autoryzuj Orvenę" pokazuje jednorazowy kod. Stuknij "Skopiuj kod i otwórz GitHub", wklej kod i zatwierdź. Dopóki GitHub nie potwierdzi, okno pokazuje "Oczekiwanie na autoryzację…".
  4. Usługa przechodzi na górną listę, a jej stan zmienia się z "Łączenie…" na liczbę narzędzi.

Home Assistant MCP na iPhonie oraz Zapier

Oba używają tokena zamiast strony logowania. W Home Assistant dodaj integrację "Model Context Protocol Server", a potem utwórz token w swoim profilu, na karcie Bezpieczeństwo, w sekcji Długoterminowe tokeny dostępu. W Orvenie stuknij Połącz przy Home Assistant, wpisz adres w polu "Gdzie to działa?", na przykład https://your-home:8123/api/mcp, i wklej token.

Orvena wymaga tu HTTPS nawet w Twojej własnej sieci, więc nie wyśle tokena na adres http://, taki jak http://homeassistant.local:8123 czy lokalny adres IP przez http://. Przy adresie http:// przycisk Połącz w tym oknie nic nie robi. Home Assistant potrzebuje ważnego certyfikatu TLS albo zaufanego odwrotnego proxy HTTPS.

Zapier prosi tylko o token: na mcp.zapier.com utwórz serwer, wybierz jego aplikacje i skopiuj token połączenia z karty Connect.

Jak dodać własny serwer MCP

Ostatnia karta w Połączeniach, "Twój własny serwer", otwiera "Serwer niestandardowy". Adres URL musi zaczynać się od https://, zawierać nazwę hosta i nie może zawierać nazwy użytkownika, hasła ani #fragmentu. Serwer musi obsługiwać MCP streamable HTTP, odpowiadać zwykłym JSON-em lub strumieniem SSE i obsługiwać wersję protokołu 2025-11-25, 2025-06-18 lub 2025-03-26. Przekierowania muszą pozostać w obrębie tego samego źródła (origin), a serwer, który nie zgłasza żadnych narzędzi, nie zostanie zapisany.

  1. Wypełnij pole Nazwa i pole adresu, którego tekst zastępczy to https://server.example/mcp.
  2. Jeśli serwer używa klucza API lub tokena, wklej go w pole "Bearer token (optional)" (token Bearer, opcjonalnie). Gdy pole jest puste, Orvena próbuje najpierw dostępu otwartego, a potem logowania.
  3. Jeśli serwer OAuth nie podaje, jakich zakresów potrzebuje, wpisz je w pole "OAuth scopes, space-separated (optional)" (zakresy OAuth rozdzielone spacjami, opcjonalnie).
  4. W polu "W czym może pomóc ten serwer? (opcjonalnie)" napisz jedno zdanie o tym, do czego służy.
  5. Stuknij "Dodaj serwer". Gdy Orvena się łączy i pobiera listę narzędzi, przycisk pokazuje "Sprawdzanie…".

Orvena rozpoczyna OAuth dopiero po odpowiedzi HTTP 401, 403 lub wyzwaniu WWW-Authenticate, a serwer autoryzacji musi obsługiwać PKCE z S256.

Orvena używa opisu celu wyłącznie do decyzji, kiedy załadować serwer. Bez niego buduje podsumowanie każdego serwera z maksymalnie czterech opisów narzędzi, skrócone do 320 znaków. Jeśli któremuś narzędziu brakuje opisu, wiersz pokazuje "Add a purpose so Orvena can choose this server reliably." (dodaj cel, aby Orvena mogła niezawodnie wybierać ten serwer), a jeśli opisu nie ma żadne, serwer jest używany tylko wtedy, gdy wymienisz go z nazwy. Naprawisz to opcją "Opisz cel" w menu ••• danego wiersza.

Co wymaga Premium Unlock

Wymagają go wszystkie połączenia: sześć usług z listy i każdy serwer, który dodasz sam. Premium Unlock to jednorazowy zakup za 14,99 USD bez subskrypcji, który dodaje też Private Cloud Compute w iOS 27, modele w chmurze na własnym kluczu OpenRouter, rozmowy głosowe i zaplanowane zadania. Apple Intelligence i pobrany model Orveny są darmowe, ale bez odblokowania odpowiadają bez narzędzi konektorów.

MCP z Apple Intelligence i innymi silnikami

Wszystkie cztery silniki z ekranu Modele dostają narzędzia konektorów. Dla Apple Intelligence i Private Cloud Compute Orvena przekształca schemat JSON każdego narzędzia MCP na format schematu frameworka Foundation Models od Apple. Jeśli schemat narzędzia używa czegoś, czego framework nie potrafi wyrazić, modele Apple dostają to narzędzie bez argumentów, więc do niego użyj modelu Orveny lub OpenRouter. Wyjątkiem jest model z OpenRouter wymieniony bez obsługi narzędzi: "Ten model nie obsługuje narzędzi, więc Orvena odpowie bez nich."

SilnikGdzie działaOkno kontekstuWynik narzędzia widziany przez model
Apple IntelligenceTen iPhone, iOS 27Odczytywane z iOS w trakcie działania: 8 192 tokeny w iOS 27 w testach, choć dokumentacja Apple podaje 4 096Do 2 400 znaków
Model OrvenyTen iPhone (Qwen 3.5 4B, 3,1 GB)16 384 tokenyDo 4 000 znaków
Private Cloud ComputeSerwery Apple, iOS 27, Premium32 768 tokenówDo 4 000 znaków
OpenRouterOpenRouter, Twój własny klucz, PremiumDługość podana dla modelu, 60 000, jeśli jest nieznana, najwyżej 120 000Do 4 000 znaków

"Automatycznie", domyślne ustawienie silnika, nigdy samo nie wybiera Private Cloud Compute ani OpenRouter.

Jak listy narzędzi i wyniki mieszczą się w małym oknie

Okno o pojemności 8 192 tokenów ma mało miejsca na dziesiątki definicji narzędzi, więc narzędzia konektorów nigdy nie trafiają do modelu wszystkie naraz. Model najpierw wywołuje load_connectors, aby wybrać jedną lub dwie usługi z listy połączonych usług, z których każda jest opisana w maksymalnie 180 znakach (łącznie 8 192 znaki). Następnie load_tools wybiera spośród nich od jednej do ośmiu operacji. Tylko one stają się dostępne do wywołania.

Przed każdą rundą modelu Orvena sumuje instrukcje, schematy załadowanych narzędzi i 900 tokenów zapasu. Jeśli wynik przekracza okno pomniejszone o 512 tokenów, usuwa narzędzia konektorów, zaczynając od najnowszych, z wyjątkiem tych, które prośba nadal musi wywołać, a potem najstarszą umiejętność. Jeśli potrzebna operacja nadal się nie mieści, tura kończy się komunikatem "The required connector operation is too large for this model's context window." (wymagana operacja konektora jest za duża dla okna kontekstu tego modelu).

Opisy narzędzi są skracane do 500 znaków, a wyniki są oznaczane jako niezaufane dane, co mówi modelowi, by tekst ze strony lub zgłoszenia traktował jako treść, a nie polecenia. Wynik przekraczający budżet jest kompaktowany: pola stronicowania idą na początek, linki i długie hashe są usuwane, obiekty na liście zachowują najwyżej 12 pól, a długie ciągi znaków są skracane, z adnotacją, która informuje o tym model.

W długich rozmowach Orvena zachowuje w oknie silnika całe ostatnie tury i odrzuca najstarsze. Niczego nie streszcza. Gdy nawet to się nie mieści, Apple Intelligence pokazuje "Ta rozmowa jest za długa dla Apple Intelligence. Rozpocznij nową rozmowę albo przełącz się na pobrany model Orveny w sekcji Modele."

Zgody, zanim cokolwiek się zmieni lub wyjdzie z telefonu

Orvena klasyfikuje każde narzędzie MCP na podstawie wskazówek deklarowanych przez jego serwer: narzędzia tylko do odczytu pokazują "Odczytuje dane bez ich zmiany.", destrukcyjne "Usuwa, anuluje lub wykonuje nieodwracalną czynność.", a pozostałe "Tworzy lub zmienia dane."

Private Cloud Compute pyta raz, gdy wybierzesz go w sekcji Modele, i informuje, że każda odpowiedź wysyła "Twoją rozmowę i potrzebne wyniki narzędzi na serwery Apple." Zgody konektorów pokazują wtedy jako miejsce docelowe "Notion → Private Cloud Compute". OpenRouter pyta przed pierwszym zapytaniem w rozmowie i ponownie komunikatem "Użyć OpenRouter z danymi wrażliwymi?", gdy w historii pojawi się wynik konektora. Zapisane zgody znajdziesz w Ustawieniach, w sekcji Udostępnianie danych, gdzie możesz je cofnąć.

Dokąd trafiają dane

Ruch konektorów trafia z iPhone'a prosto do usługi, bez żadnego serwera Orvena po drodze. Usługa i jej serwer logowania otrzymują zatwierdzone przez Ciebie argumenty, treść, którą same zwracają, oraz ruch związany z logowaniem. Tokeny pozostają w pęku kluczy iPhone'a, tylko na tym urządzeniu. Z Apple Intelligence lub modelem Orveny wyniki są odczytywane na telefonie; z Private Cloud Compute wyniki potrzebne do odpowiedzi trafiają do Apple, a z OpenRouter, po Twojej zgodzie, do OpenRouter. W Ustawieniach, w sekcji Aktywność, przechowywane są nazwy narzędzi, rezultaty i miejsca docelowe z maksymalnie 30 dni, nigdy argumenty. Przycisk Rozłącz usuwa lokalne dane logowania i narzędzia, a potwierdzenie przypomina, by cofnąć dostęp również w usłudze, na przykład "Konieczne może być też odwołanie dostępu Orveny w ustawieniach konta Notion." Szerszy obraz przedstawia artykuł co sprawia, że asystent AI jest prywatny.

Rozwiązywanie problemów

Co widziszCo sprawdzić
"Enter a complete HTTPS server URL."Zacznij adres od https:// i podaj nazwę hosta.
"Serwer zwrócił odpowiedź, której Orvena nie może użyć."Usuń z adresu część user:password@ i wszystko po znaku #. Jeśli adres jest czysty, serwer wysłał odpowiedź, której Orvena nie potrafiła odczytać.
"Couldn't reach the server. Check your connection and server address."Adres, DNS i certyfikat TLS, sprawdzane z miejsca, w którym jest telefon.
"Serwer odrzucił to połączenie. Sprawdź logowanie lub token."Sprawdź token albo utwórz nowy i połącz ponownie.
"This server doesn't support compatible sign-in. Use a token if it offers one."Wklej token w pole "Bearer token (optional)".
"Wymagane logowanie" lub "Połączenie nie powiodło się"Połącz ponownie albo Spróbuj ponownie w menu •••.
"The latest tool result is too large for this model's context window. Try a narrower request."Poproś o jedną stronę lub jedno zgłoszenie albo wybierz silnik z większym oknem.
"Czynność mogła zostać wykonana. Sprawdź usługę, zanim spróbujesz ponownie."Zajrzyj do usługi, zanim powtórzysz działanie.
"Odzyskiwanie zdalnych działań wymaga sprawdzenia"Nowe zdalne działania są wstrzymane. Sprawdź każdą usługę, a potem stuknij "Sprawdzono każde miejsce docelowe".

Częste pytania

Czy mój iPhone może uruchomić serwer MCP?

Nie w Orvenie. Orvena to klient MCP, który łączy się ze zdalnymi serwerami przez HTTPS za pomocą MCP streamable HTTP. Lokalny serwer stdio nie może działać w Orvenie, więc uruchom go gdzie indziej, za mostem HTTPS, i dodaj ten adres na karcie Twój własny serwer.

Czy Apple Intelligence może używać narzędzi MCP?

W Orvenie tak. W iOS 27 Orvena daje modelowi Apple na urządzeniu i Private Cloud Compute narzędzia podłączonych serwerów, przekształcone do formatu frameworka Foundation Models od Apple. W każdej chwili ma załadowane jedną lub dwie usługi i najwyżej osiem ich operacji, dzięki czemu definicje narzędzi są na tyle małe, że mieszczą się w oknie modelu na urządzeniu.

Jak połączyć Home Assistant z asystentem AI na iPhone'a przez MCP?

Dodaj w Home Assistant integrację Model Context Protocol Server i utwórz długoterminowy token dostępu w swoim profilu, na karcie Bezpieczeństwo. W aplikacji Orvena stuknij Połącz przy Home Assistant, wpisz adres HTTPS kończący się na /api/mcp i wklej token. Zwykłe adresy http są odrzucane, także w sieci domowej.

Czy serwera MCP Notion można używać z iPhone'a?

Tak. Notion jest jednym z sześciu konektorów z listy Orveny. Stuknij Połącz w Ustawieniach, w sekcji Połączenia, zaloguj się do Notion i zatwierdź dostęp. Orvena korzysta z hostowanego serwera Notion pod adresem mcp.notion.com i pyta o zgodę, zanim narzędzie Notion zostanie uruchomione po raz pierwszy. Połączenia wchodzą w skład Premium Unlock.

Czy każde działanie MCP wymaga zgody?

Działania destrukcyjne pytają za każdym razem. Narzędzia, które odczytują, tworzą lub zmieniają dane, pytają za pierwszym razem i możesz wybrać Zawsze zezwalaj. Taka zgoda jest widoczna w Ustawieniach, w sekcji Udostępnianie danych, Dozwolone narzędzia, gdzie możesz ją cofnąć.

Połączenia trafiają prosto do usługi.

Orvena jest darmowa w App Store na iPhone'a 15 Pro i nowsze modele. Premium Unlock, jeden zakup, dodaje sześć konektorów z listy i każdy serwer MCP, który dodasz.

Pobierz w App Store