iPhoneでMCPクライアントを使う：用意されたコネクタ、自分のサーバー、そして制限

OrvenaはiPhoneのMCPクライアントです。アシスタントをNotion、Linear、GitHub、Jira & Confluence、Zapier、Home Assistant、あるいは自分で運用するMCPサーバーに接続し、Apple Intelligence、Private Cloud Compute、Orvena独自のモデル、OpenRouterのモデルからそれらのツールを呼び出せるようにします。このガイドでは、設定画面を名前で示しながら、カスタムサーバーが満たすべきルール、小さなコンテキストウィンドウにツールを収める仕組み、何かが変更されたり送信されたりする前に表示される承認を説明します。

iPhoneのMCPクライアントがすること

MCP（Model Context Protocol）は、サービスをAIアシスタントに接続するためのオープンな標準です。サービスはMCPサーバーを運用し、そこでツールを一覧にします。各ツールには名前、説明、受け取る引数があり、モデルが求めるとクライアントがツールを呼び出します。Orvenaはこのクライアントで、あなたのiPhoneから各サーバーとHTTPSで直接通信します。

Orvenaが接続するのは、MCP streamable HTTPを使うリモートサーバーだけです。デスクトップアプリがコマンドとして起動するようなローカルのstdioサーバーはOrvenaの中では動かせないので、リモートのHTTPSブリッジの背後に置き、そのアドレスを追加してください。

Orvenaに用意されているコネクタ

左上のメニューを開き、「設定」、「接続」の順に進みます（「使っているものを接続」という見出しの行です）。バージョン2.0.0では、6つのサービスが並んでいます。

モデルはこれらの説明を読んで、リクエストにどのサービスが必要かを判断します。各サーバーはサインイン後に自分のツールを報告し、行にはその数が表示されます。Slack、Figma、Canva、Todoist、PayPalが一覧にないのは、現時点ではOrvenaがそれぞれのサインインの要件を満たせないためです。

1. カードの「接続」をタップします。Premium Unlockがない場合、ボタンは「プレミアム」と表示され、購入画面が開きます。
2. Notion、Linear、Jira & Confluenceでは、サーバーがサインインを求めると、サービス自身のサインインページがシートで開きます。そこでアクセスを承認します。
3. GitHubでは、「Orvena を承認」というタイトルのシートにワンタイムコードが表示されます。「コードをコピーして GitHub を開く」をタップし、コードを貼り付けて承認します。GitHubが確認するまで、シートには「承認を待機中…」と表示されます。
4. サービスが上の一覧に移り、状態が「接続中…」からツールの数に変わります。

iPhoneでHome AssistantのMCPを使う、そしてZapier

どちらもサインインページの代わりにトークンを使います。Home Assistantで「Model Context Protocol Server」統合を追加し、プロフィールの「セキュリティ」にある「長期間有効なアクセストークン」でトークンを作成します。Orvenaでは、Home Assistantの「接続」をタップし、「どこにありますか?」の欄に https://your-home:8123/api/mcp のようなアドレスを入力して、トークンを貼り付けます。

Orvenaはここでは自宅のネットワーク内でもHTTPSを必須にしているので、http://homeassistant.local:8123 や、http:// で指定したローカルIPアドレスのような http:// のアドレスにはトークンを送りません。http:// のアドレスでは、シートの「接続」ボタンを押しても何も起きません。Home Assistantには有効なTLS証明書か、信頼できるHTTPSリバースプロキシが必要です。

Zapierで必要なのはトークンだけです。mcp.zapier.comでサーバーを作成してアプリを選び、「Connect」タブから接続トークンをコピーします。

自分のMCPサーバーを追加する方法

「接続」の最後のカード「自分のサーバ」を開くと、「カスタムサーバ」が表示されます。URLは https:// とホスト名を使い、ユーザー名、パスワード、#フラグメントを含まないものでなければなりません。サーバーはMCP streamable HTTPに対応し、プレーンなJSONかSSEストリームで応答し、プロトコルバージョン2025-11-25、2025-06-18、2025-03-26のいずれかをサポートしている必要があります。リダイレクトは同じオリジン内に限られ、ツールを1つも報告しないサーバーは保存されません。

1. 「名前」とアドレスの欄を入力します。アドレス欄のプレースホルダーは https://server.example/mcp です。
2. サーバーがAPIキーやトークンを使う場合は、「Bearer token (optional)」（Bearerトークン、任意）に貼り付けます。空欄のままにすると、Orvenaはオープンアクセスを試し、次にサインインを試します。
3. OAuthサーバーが必要なスコープを示さない場合は、「OAuth scopes, space-separated (optional)」（OAuthスコープ、スペース区切り、任意）に入力します。
4. 「このサーバは何に役立ちますか?(任意)」に、そのサーバーの用途を1文で書きます。
5. 「サーバを追加」をタップします。Orvenaが接続してツールを一覧にする間は「確認中…」と表示されます。

OrvenaがOAuthを始めるのは、HTTP 401、403、またはWWW-Authenticateのチャレンジを受けたときだけで、認可サーバーはS256のPKCEに対応している必要があります。

Orvenaが用途の説明を使うのは、そのサーバーをいつ読み込むかを判断するときだけです。説明がない場合は、最大4つのツールの説明から各サーバーの概要を作り、320文字で切ります。説明のないツールが1つでもあると、行に「Add a purpose so Orvena can choose this server reliably.」（Orvenaがこのサーバーを確実に選べるよう目的を追加してください）と表示され、どのツールにも説明がなければ、そのサーバーは名前を挙げたときにしか使われません。行の•••メニューにある「目的を入力」で解決できます。

Premium Unlockが必要なもの

一覧にある6つのサービスも、自分で追加したサーバーも、接続にはすべてPremium Unlockが必要です。Premium Unlockは14.99ドルの一度きりの購入でサブスクリプションはなく、iOS 27のPrivate Cloud Compute、自分のOpenRouterキーで使うクラウドモデル、音声会話、予約タスクも加わります。Apple IntelligenceとOrvenaのダウンロード済みモデルは無料ですが、Premium Unlockがなければコネクタのツールなしで答えます。

Apple IntelligenceやほかのエンジンでMCPを使う

「モデル」画面にある4つのエンジンはすべて、コネクタのツールを使えます。Apple IntelligenceとPrivate Cloud Computeでは、OrvenaがMCPツールごとのJSONスキーマを、AppleのFoundation Modelsフレームワークのスキーマ形式に変換します。フレームワークで表現できない要素をツールのスキーマが使っている場合、Appleのモデルにはそのツールが引数なしで渡されるので、そのツールにはOrvenaのモデルかOpenRouterを使ってください。例外は、ツールに対応していないと表示されるOpenRouterのモデルです。「このモデルはツールを使えないため、Orvena はツールなしで回答します。」

デフォルトのエンジン設定である「自動」が、Private Cloud ComputeやOpenRouterを勝手に選ぶことはありません。

ツールの一覧と結果を小さなウィンドウに収める仕組み

8,192トークンのウィンドウには、何十ものツール定義を入れる余地はほとんどありません。そのため、コネクタのツールが一度にまとめてモデルに渡されることはありません。モデルはまずload_connectorsを呼び出し、接続済みサービスの一覧から1つか2つのサービスを選びます。一覧の各サービスは180文字以内（全体で8,192文字）で説明されています。次にload_toolsで、そこから1〜8個の操作を選びます。呼び出せるようになるのは、それらの操作だけです。

モデルを実行する各ラウンドの前に、Orvenaは指示、読み込んだツールのスキーマ、900トークンの余白を合計します。それがウィンドウから512トークンを引いた値を超えると、リクエストがまだ呼び出す必要のあるものを除いて、新しいものから順にコネクタのツールを外し、次に最も古いスキルを外します。それでも必要な操作が収まらなければ、そのターンは「The required connector operation is too large for this model's context window.」（必要なコネクタの操作が、このモデルのコンテキストウィンドウには大きすぎます）で止まります。

ツールの説明は500文字で切られ、結果は信頼できないデータとして印が付けられます。これにより、ページやIssueのテキストを指示ではなく内容として扱うようモデルに伝えます。予算を超えた結果は圧縮されます。ページ送りの項目を先頭に置き、リンクと長いハッシュを取り除き、リスト内のオブジェクトは最大12項目に絞り、長い文字列は短くしたうえで、その旨をモデルに伝える注記を添えます。

長い会話では、Orvenaはエンジンのウィンドウに収まる範囲で最近のターンを丸ごと残し、最も古いターンから外していきます。要約はしません。それでも収まらない場合、Apple Intelligenceでは「この会話は Apple Intelligence には長すぎます。新しい会話を始めるか、「モデル」でダウンロード済みの Orvena のモデルに切り替えてください。」と表示されます。

何かが変わる前、外に出る前の承認

Orvenaは、サーバーが宣言するヒントをもとに各MCPツールを分類します。読み取り専用のツールには「データを変更せずに読み取ります。」、破壊的なツールには「削除、キャンセル、または取り消せない操作を実行します。」、それ以外には「データを作成または変更します。」と表示されます。

• 読み取りと書き込みのツールは、最初の1回だけ確認します。「この操作を承認」という見出しのシートには「許可しない」と「許可」があり、メニューから「1回のみ許可」か「常に許可」を選べます。
• 破壊的なツールは毎回確認し、選べるのは「1回のみ許可」だけです。
• シートには正確な引数が並び、トークン、パスワードなど認証情報に当たる項目は[REDACTED CREDENTIAL]と表示されます。送信先も示され、たとえば「このアクションに必要なデータをNotionに送信します。」のように表示されます。
• 同じターンですでにカレンダーや別のコネクタの結果など個人的なものを読み取っている場合、承認のタイトルは「Send data to」（データの送信先）とサービス名になります。ヘルスケアのデータを読んだあとは、毎回確認します。

Private Cloud Computeは「モデル」で選んだときに一度だけ確認し、「回答のたびに、会話と必要なツールの結果が Apple のサーバに送信されます。」と説明します。以後、コネクタの承認には送信先として「Notion → Private Cloud Compute」と表示されます。OpenRouterは会話の最初のリクエストの前に確認し、コネクタの結果が履歴に入ると「機密性の高いデータで OpenRouter を使用しますか?」ともう一度確認します。保存された許可は「設定」の「データ共有」にあり、そこで取り消せます。

データの行き先

コネクタの通信は、あいだにOrvenaのサーバーを挟まず、iPhoneからサービスへ直接届きます。サービスとそのサインインサーバーが受け取るのは、あなたが承認した引数、サービスが返すコンテンツ、そしてサインインの通信です。トークンはiPhoneのキーチェーンに、このデバイス専用として保存されます。Apple IntelligenceやOrvenaのモデルでは結果はスマートフォン上で読み取られ、Private Cloud Computeでは回答に必要な結果がAppleに、OpenRouterでは同意したあとにOpenRouterに送られます。「設定」の「アクティビティ」には、ツール名、結果、送信先が最大30日分残りますが、引数は残りません。「接続解除」はローカルの認証情報とツールを削除し、確認画面ではサービス側でもアクセスを取り消すよう促されます。たとえば「Notion のアカウント設定で Orvena の承認取り消しが別途必要になる場合があります。」と表示されます。全体像はAIアシスタントをプライベートにするもので解説しています。

トラブルシューティング

よくある質問

iPhoneでMCPサーバーを動かせますか？

Orvenaの中では動かせません。OrvenaはMCPクライアントで、MCP streamable HTTPを使ってHTTPSでリモートサーバーに接続します。ローカルのstdioサーバーはOrvenaの中では動かせないので、別の場所でHTTPSブリッジの背後で動かし、そのアドレスを「自分のサーバ」から追加してください。

Apple IntelligenceはMCPのツールを使えますか？

Orvenaの中なら使えます。iOS 27では、Orvenaが接続したサーバーのツールを、AppleのFoundation Modelsフレームワークの形式に変換して、AppleのオンデバイスモデルとPrivate Cloud Computeに渡します。ある時点で読み込まれるのは1つか2つのサービスと、その操作のうち最大8つまでなので、ツール定義はオンデバイスのウィンドウに収まる小ささに保たれます。

iPhoneのAIアシスタントにHome AssistantをMCPで接続するには？

Home Assistantで「Model Context Protocol Server」統合を追加し、プロフィールの「セキュリティ」で長期間有効なアクセストークンを作成します。Orvenaでは、Home Assistantの「接続」をタップし、/api/mcpで終わるHTTPSアドレスを入力して、トークンを貼り付けます。自宅のネットワーク内であっても、プレーンなhttpのアドレスは拒否されます。

iPhoneでNotionのMCPサーバーを使えますか？

はい。NotionはOrvenaの一覧にある6つのコネクタの1つです。「設定」の「接続」で「接続」をタップし、Notionにサインインしてアクセスを承認します。Orvenaはmcp.notion.comにあるNotionのホスト型サーバーを使い、Notionのツールを初めて実行する前に確認します。接続はPremium Unlockに含まれます。

MCPの操作はすべて承認が必要ですか？

破壊的な操作は毎回確認します。データを読み取る、作成する、変更するツールは最初の1回だけ確認し、「常に許可」を選ぶこともできます。その許可は「設定」の「データ共有」にある「許可済みのツール」に一覧され、そこで取り消せます。