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" 통합구성요소를 추가한 다음, 프로필의 Security(보안), Long-lived access tokens(장기 액세스 토큰)에서 토큰을 만드세요. Orvena에서 Home Assistant의 '연결'을 탭하고 "어디에 있나요?" 아래에 https://your-home:8123/api/mcp 같은 주소를 입력한 뒤 토큰을 붙여 넣으세요.

Orvena는 여기서 내 네트워크 안이라도 HTTPS를 요구하므로, http://homeassistant.local:8123 같은 주소나 http://로 접속하는 로컬 IP 주소로는 토큰을 보내지 않습니다. 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. 이름과 주소 필드를 채우세요. 주소 필드의 플레이스홀더는 https://server.example/mcp입니다.
2. 서버가 API 키나 토큰을 쓴다면 "Bearer token (optional)"(Bearer 토큰, 선택 사항)에 붙여 넣으세요. 비워 두면 Orvena는 공개 접근을 먼저 시도하고, 그다음 로그인을 시도합니다.
3. OAuth 서버가 필요한 범위를 알려 주지 않으면 "OAuth scopes, space-separated (optional)"(OAuth 범위, 공백으로 구분, 선택 사항)에 입력하세요.
4. "이 서버는 어떤 일을 도울 수 있나요? (선택 사항)"에 서버의 용도를 한 문장으로 적으세요.
5. "서버 추가"를 탭하세요. Orvena가 연결해 도구 목록을 가져오는 동안 "확인 중…"이 표시됩니다.

Orvena는 HTTP 401, 403 또는 WWW-Authenticate 챌린지를 받은 뒤에만 OAuth를 시작하며, 인증 서버는 S256 방식의 PKCE를 지원해야 합니다.

Orvena는 용도 설명을 서버를 언제 불러올지 판단하는 데만 사용합니다. 용도 설명이 없으면 도구 설명을 최대 네 개까지 모아 320자로 잘라 각 서버의 요약을 만듭니다. 설명이 없는 도구가 하나라도 있으면 행에 "Add a purpose so Orvena can choose this server reliably."(Orvena가 이 서버를 확실히 고를 수 있도록 용도를 추가하라는 안내)가 표시되고, 설명이 있는 도구가 하나도 없으면 서버 이름을 직접 말할 때만 그 서버를 사용합니다. 행의 ••• 메뉴에서 "용도 설명"으로 해결할 수 있습니다.

Premium Unlock이 필요한 기능

모든 연결에 필요합니다. 목록에 있는 서비스 6개도, 직접 추가한 서버도 마찬가지입니다. Premium Unlock은 구독 없는 $14.99 일회성 구입이며, iOS 27의 Private Cloud Compute, 본인의 OpenRouter 키로 쓰는 클라우드 모델, 음성 대화, 예약 작업도 추가합니다. Apple Intelligence와 Orvena가 다운로드한 모델은 무료지만, 잠금 해제 없이는 커넥터 도구 없이 답합니다.

Apple Intelligence와 다른 엔진에서 MCP 사용하기

모델 화면의 네 엔진 모두 커넥터 도구를 받습니다. Apple Intelligence와 Private Cloud Compute의 경우, Orvena는 각 MCP 도구의 JSON 스키마를 Apple Foundation Models 프레임워크의 스키마 형식으로 변환합니다. 도구의 스키마에 이 프레임워크가 표현할 수 없는 요소가 있으면 Apple 모델은 그 도구를 인수 없이 받으므로, 그런 도구에는 Orvena 모델이나 OpenRouter를 사용하세요. 도구 지원이 없다고 표시된 OpenRouter 모델은 예외입니다. "이 모델은 도구를 사용할 수 없어서 Orvena가 도구 없이 답해요."

기본 엔진 설정인 '자동'은 Private Cloud Compute나 OpenRouter를 스스로 선택하지 않습니다.

도구 목록과 결과가 작은 컨텍스트 윈도우에 들어가는 방식

8,192 토큰 컨텍스트 윈도우에는 도구 정의 수십 개를 넣을 여유가 거의 없으므로, 커넥터 도구를 모델에 한꺼번에 보내지 않습니다. 모델은 먼저 load_connectors를 호출해, 연결된 서비스 목록(서비스마다 최대 180자, 전체 8,192자)에서 서비스를 한두 개 고릅니다. 이어서 load_tools로 그 서비스들의 작업을 1개에서 8개까지 고릅니다. 호출할 수 있게 되는 것은 이 작업들뿐입니다.

모델이 응답하는 매 라운드 전에 Orvena는 지침, 불러온 도구 스키마, 여유분 900 토큰을 합산합니다. 합계가 윈도우 크기에서 512 토큰을 뺀 값을 넘으면, 요청이 아직 호출해야 하는 도구를 제외하고 커넥터 도구를 가장 최근 것부터 빼고, 그다음 가장 오래된 스킬을 뺍니다. 그래도 필요한 작업이 들어가지 않으면 "The required connector operation is too large for this model's context window."(필요한 커넥터 작업이 이 모델의 컨텍스트 윈도우에 비해 너무 크다는 뜻)와 함께 턴이 멈춥니다.

도구 설명은 500자에서 잘리고, 결과는 신뢰할 수 없는 데이터로 표시됩니다. 이 표시는 페이지나 이슈에서 온 텍스트를 지시가 아닌 콘텐츠로 다루라고 모델에 알려 줍니다. 한도를 넘는 결과는 압축됩니다. 페이지네이션 필드를 가장 먼저 남기고, 링크와 긴 해시를 빼고, 목록 안의 객체는 필드를 최대 12개까지만 유지하고, 긴 문자열은 줄이며, 이 사실을 모델에 알리는 메모를 붙입니다.

긴 대화에서 Orvena는 엔진의 컨텍스트 윈도우 안에 최근 턴을 온전히 남기고 가장 오래된 턴부터 버립니다. 요약은 하지 않습니다. 그래도 들어가지 않으면 Apple Intelligence에서 "이 대화는 Apple Intelligence에서 처리하기에 너무 길어요. 새 대화를 시작하거나 '모델'에서 다운로드한 Orvena 모델로 전환하세요."가 표시됩니다.

무언가를 변경하거나 내보내기 전의 승인

Orvena는 서버가 선언한 힌트로 각 MCP 도구를 분류합니다. 읽기 전용 도구에는 "데이터를 변경하지 않고 읽습니다.", 파괴적인 도구에는 "삭제, 취소 또는 되돌릴 수 없는 동작을 수행합니다.", 나머지에는 "데이터를 생성하거나 변경합니다."가 표시됩니다.

• 읽기 도구와 쓰기 도구는 처음 한 번 묻습니다. "이 작업 승인"이라는 제목의 시트에 "허용 안 함"과 "허용"이 있고, 메뉴에서 "한 번만 허용" 또는 "항상 허용"을 고를 수 있습니다.
• 파괴적인 도구는 매번 묻고, "한 번만 허용"만 제공합니다.
• 시트에는 정확한 인수가 나열되며, 토큰, 비밀번호 등 자격 증명처럼 보이는 필드는 [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 streamable HTTP를 사용해 HTTPS로 원격 서버에 연결하는 MCP 클라이언트입니다. 로컬 stdio 서버는 Orvena 안에서 실행할 수 없으므로, 다른 곳에서 HTTPS 브리지 뒤에 두고 실행한 다음 그 주소를 내 서버에 추가하세요.

Apple Intelligence가 MCP 도구를 사용할 수 있나요?

Orvena에서는 가능합니다. iOS 27에서 Orvena는 연결한 서버의 도구를 Apple Foundation Models 프레임워크 형식으로 변환해 Apple의 온디바이스 모델과 Private Cloud Compute에 제공합니다. 한 번에 서비스 한두 개와 그 작업 최대 8개만 불러오기 때문에, 도구 정의가 온디바이스 모델의 컨텍스트 윈도우에 들어갈 만큼 작게 유지됩니다.

iPhone의 AI 어시스턴트에 MCP로 Home Assistant를 연결하려면 어떻게 하나요?

Home Assistant에서 Model Context Protocol Server 통합구성요소를 추가하고, 프로필의 Security(보안)에서 장기 액세스 토큰을 만드세요. Orvena에서 Home Assistant의 '연결'을 탭하고, /api/mcp로 끝나는 HTTPS 주소를 입력한 뒤 토큰을 붙여 넣으세요. 일반 http 주소는 집 네트워크에서도 거부됩니다.

iPhone에서 Notion MCP 서버를 사용할 수 있나요?

네. Notion은 Orvena가 제공하는 커넥터 6개 중 하나입니다. '설정'의 '연결'에서 Notion의 '연결'을 탭하고, Notion에 로그인해 접근을 승인하세요. Orvena는 mcp.notion.com에 있는 Notion의 호스팅 서버를 사용하며, Notion 도구를 처음 실행하기 전에 묻습니다. 연결 기능은 Premium Unlock에 포함됩니다.

모든 MCP 동작이 승인을 요청하나요?

파괴적인 동작은 매번 묻습니다. 데이터를 읽거나 생성하거나 변경하는 도구는 처음 한 번 묻고, 항상 허용을 선택할 수 있습니다. 이 권한은 설정의 데이터 공유, 허용된 도구에 표시되며, 거기서 취소할 수 있습니다.