Usar um cliente MCP no iPhone: os conectores da lista, o seu próprio servidor e os limites

O Orvena é um cliente MCP para o iPhone. Liga o assistente ao Notion, Linear, GitHub, Jira & Confluence, Zapier e Home Assistant, ou a um servidor MCP gerido por si, e permite que a Apple Intelligence, o Private Cloud Compute, o modelo do próprio Orvena ou um modelo OpenRouter chamem as respetivas ferramentas. Este guia percorre os ecrãs de configuração pelo nome, as regras que um servidor personalizado tem de cumprir, a forma como as ferramentas cabem numa janela de contexto pequena e as aprovações que vai ver antes de algo ser alterado ou enviado.

O que faz um cliente MCP no iPhone

O MCP, Model Context Protocol, é uma norma aberta para ligar serviços a assistentes de IA. Um serviço executa um servidor MCP que lista as suas ferramentas, cada uma com um nome, uma descrição e os argumentos que aceita, e o cliente chama uma ferramenta quando o modelo o pede. O Orvena é o cliente e fala com cada servidor por HTTPS, diretamente a partir do seu iPhone.

O Orvena só se liga a servidores remotos através de MCP streamable HTTP. Um servidor stdio local, do tipo que uma app de computador inicia como comando, não pode ser executado dentro do Orvena; coloque-o atrás de uma ponte HTTPS remota e adicione esse endereço.

Os conectores que o Orvena lista

Abra o menu no canto superior esquerdo, depois Ajustes e depois Conexões (a linha com o título "Ligue as suas coisas"). A versão 2.0.0 lista seis serviços:

O modelo lê estas descrições para decidir de que serviço um pedido precisa. Cada servidor comunica as suas próprias ferramentas depois do início de sessão, e a linha mostra quantas são. O Slack, o Figma, o Canva, o Todoist e o PayPal não estão na lista porque, por agora, o Orvena não consegue cumprir os requisitos de início de sessão desses serviços.

1. Toque em Conectar num cartão. Sem o Premium Unlock, o botão diz Premium e abre o ecrã de compra.
2. No Notion, no Linear e no Jira & Confluence, a página de início de sessão do próprio serviço abre numa janela assim que o servidor pede o início de sessão. Aprove o acesso aí.
3. No GitHub, uma janela com o título "Autorizar o Orvena" mostra um código de uso único. Toque em "Copiar código e abrir o GitHub", cole o código e aprove. A janela mostra "Aguardando autorização…" até o GitHub confirmar.
4. O serviço passa para a lista de cima, e o estado muda de "A ligar…" para o número de ferramentas.

Home Assistant MCP no iPhone, e Zapier

Ambos usam um token em vez de uma página de início de sessão. No Home Assistant, adicione a integração "Model Context Protocol Server" e crie um token no seu perfil, em Segurança, Tokens de acesso de longa duração. No Orvena, toque em Conectar no Home Assistant, introduza o endereço em "Onde ele fica?", por exemplo https://your-home:8123/api/mcp, e cole o token.

Aqui o Orvena exige HTTPS mesmo na sua própria rede, por isso não envia o token para um endereço http://, como http://homeassistant.local:8123 ou um endereço IP local por http://. Com um endereço http://, o botão Conectar da janela não faz nada. O Home Assistant precisa de um certificado TLS válido ou de um proxy inverso HTTPS de confiança.

O Zapier pede apenas o token: em mcp.zapier.com, crie um servidor, escolha as apps e copie o token de ligação no separador Connect.

Como adicionar o seu próprio servidor MCP

O último cartão em Conexões, "Seu próprio servidor", abre "Servidor personalizado". O URL tem de usar https:// com um nome de anfitrião e não pode conter nome de utilizador, palavra-passe nem #fragmento. O servidor tem de falar MCP streamable HTTP, responder com JSON simples ou um fluxo SSE e suportar a versão de protocolo 2025-11-25, 2025-06-18 ou 2025-03-26. Os redirecionamentos têm de ficar na mesma origem, e um servidor que não comunique nenhuma ferramenta não é guardado.

1. Preencha Nome e o campo do endereço, cujo texto de exemplo é https://server.example/mcp.
2. Se o servidor usar uma chave de API ou um token, cole-o em "Bearer token (optional)" (token Bearer, opcional). Se o deixar vazio, o Orvena tenta o acesso aberto e depois o início de sessão.
3. Se um servidor OAuth não indicar de que âmbitos precisa, introduza-os em "OAuth scopes, space-separated (optional)" (âmbitos OAuth separados por espaços, opcional).
4. Em "Com o que este servidor pode ajudar? (opcional)", escreva uma frase sobre a finalidade do servidor.
5. Toque em "Adicionar servidor". O botão mostra "Verificando…" enquanto o Orvena se liga e lista as ferramentas.

O Orvena só inicia o OAuth depois de uma resposta HTTP 401 ou 403 ou de um desafio WWW-Authenticate, e o servidor de autorização tem de suportar PKCE com S256.

O Orvena usa a linha de finalidade apenas para decidir quando carregar o servidor. Sem ela, constrói o resumo de cada servidor a partir de até quatro descrições de ferramentas, cortado a 320 caracteres. Se faltar a descrição a alguma ferramenta, a linha mostra "Add a purpose so Orvena can choose this server reliably." (adicione uma finalidade para que o Orvena possa escolher este servidor com fiabilidade), e se nenhuma tiver descrição, o servidor só é usado quando o menciona pelo nome. Resolva isso com "Descrever finalidade" no menu ••• da linha.

O que precisa do Premium Unlock

Todas as ligações precisam dele, tanto os seis serviços da lista como qualquer servidor que adicione. O Premium Unlock é uma compra única de 14,99 USD, sem subscrição, e acrescenta também o Private Cloud Compute no iOS 27, modelos na nuvem com a sua própria chave OpenRouter, conversas por voz e tarefas agendadas. A Apple Intelligence e o modelo descarregado do Orvena são gratuitos, mas sem o desbloqueio respondem sem as ferramentas dos conectores.

Usar MCP com a Apple Intelligence e os outros motores

Os quatro motores do ecrã Modelos recebem todos as ferramentas dos conectores. Para a Apple Intelligence e o Private Cloud Compute, o Orvena converte o esquema JSON de cada ferramenta MCP no formato de esquema da framework Foundation Models da Apple. Se o esquema de uma ferramenta usar algo que a framework não consegue exprimir, os modelos da Apple recebem essa ferramenta sem argumentos; para ela, use o modelo do Orvena ou o OpenRouter. A exceção é um modelo OpenRouter listado sem suporte para ferramentas: "Este modelo não pode usar ferramentas, então o Orvena responderá sem elas."

O Automático, a definição de motor predefinida, nunca escolhe por si só o Private Cloud Compute nem o OpenRouter.

Como as listas e os resultados de ferramentas cabem numa janela pequena

Uma janela de 8 192 tokens tem pouco espaço para dezenas de definições de ferramentas, por isso as ferramentas dos conectores nunca vão todas de uma vez para o modelo. Primeiro, o modelo chama load_connectors para escolher um ou dois serviços de uma lista dos serviços ligados, cada um descrito em no máximo 180 caracteres (8 192 caracteres no total). Depois, load_tools escolhe entre uma e oito operações desses serviços. Só essas passam a poder ser chamadas.

Antes de cada ronda do modelo, o Orvena soma as instruções, os esquemas das ferramentas carregadas e 900 tokens de margem. Se o total ultrapassar a janela menos 512 tokens, retira ferramentas dos conectores, das mais recentes para as mais antigas, exceto as que o pedido ainda tem de chamar, e depois a competência mais antiga. Se a operação necessária continuar a não caber, o pedido é interrompido com a mensagem "The required connector operation is too large for this model's context window." (a operação necessária do conector é demasiado grande para a janela de contexto deste modelo).

As descrições das ferramentas são cortadas a 500 caracteres, e os resultados são marcados como dados não fidedignos, o que diz ao modelo para tratar o texto de uma página ou issue como conteúdo e não como instruções. Um resultado que ultrapasse o orçamento é compactado: os campos de paginação vêm primeiro, as ligações e os hashes longos saem, os objetos de uma lista mantêm no máximo 12 campos e as cadeias de texto longas são encurtadas, com uma nota a avisar o modelo disso.

Em conversas longas, o Orvena mantém as trocas recentes completas dentro da janela do motor e descarta as mais antigas. Não faz resumos. Quando nem assim cabe, a Apple Intelligence mostra "Esta conversa é longa demais para a Apple Intelligence. Inicie uma nova conversa ou mude para o modelo baixado do Orvena em Modelos."

Aprovações antes de algo mudar ou sair

O Orvena classifica cada ferramenta MCP a partir das indicações que o respetivo servidor declara: as ferramentas só de leitura mostram "Lê dados sem os alterar.", as destrutivas "Apaga, cancela ou executa uma ação irreversível." e as restantes "Cria ou altera dados."

• As ferramentas de leitura e de escrita perguntam da primeira vez. A janela, com o cabeçalho "APROVAR ESTA AÇÃO", tem "Não permitir" e "Permitir", com "Permitir uma vez" ou "Permitir sempre" no menu.
• As ferramentas destrutivas perguntam sempre, apenas com "Permitir uma vez".
• A janela lista os argumentos exatos, com tokens, palavras-passe e outros campos semelhantes a credenciais mostrados como [REDACTED CREDENTIAL], e indica para onde vão, por exemplo "Envia a Notion os dados necessários para esta ação."
• Se a mesma troca já tiver lido algo pessoal, como o seu calendário ou o resultado de outro conector, a aprovação tem o título "Send data to" (enviar dados para) seguido do nome do serviço. Depois de dados de Saúde, pergunta sempre.

O Private Cloud Compute pergunta uma vez, quando o escolhe em Modelos, e avisa que cada resposta envia "a sua conversa, e os resultados de ferramentas necessários, aos servidores da Apple." As aprovações dos conectores mostram depois "Notion → Private Cloud Compute" como destino. O OpenRouter pergunta antes do primeiro pedido de uma conversa, e de novo com "Usar OpenRouter com dados sensíveis?" quando há um resultado de conector no histórico. As autorizações guardadas estão em Ajustes, Compartilhamento de dados, onde as pode revogar.

Para onde vão os dados

O tráfego dos conectores vai do iPhone diretamente para o serviço, sem nenhum servidor Orvena pelo meio. O serviço e o respetivo servidor de início de sessão recebem os argumentos que aprovou, o conteúdo que devolvem e o tráfego do início de sessão. Os tokens ficam no porta-chaves do iPhone, apenas neste dispositivo. Com a Apple Intelligence ou o modelo do Orvena, os resultados são lidos no telemóvel; com o Private Cloud Compute, os resultados de que uma resposta precisa vão para a Apple, e com o OpenRouter para o OpenRouter, depois de dar o seu consentimento. Ajustes, Atividade guarda até 30 dias de nomes de ferramentas, desfechos e destinos, nunca argumentos. Desconectar remove as credenciais e ferramentas locais, e a confirmação lembra-o de revogar também o acesso no serviço, por exemplo "Talvez você ainda precise revogar o Orvena nos ajustes da conta de Notion." O panorama geral está em o que torna um assistente de IA privado.

Resolução de problemas

Perguntas frequentes

Posso executar um servidor MCP no meu iPhone?

Não dentro do Orvena. O Orvena é um cliente MCP que se liga a servidores remotos por HTTPS através de MCP streamable HTTP. Um servidor stdio local não pode ser executado dentro do Orvena; execute-o noutro sítio, atrás de uma ponte HTTPS, e adicione esse endereço em Seu próprio servidor.

A Apple Intelligence pode usar ferramentas MCP?

No Orvena, pode. No iOS 27, o Orvena dá ao modelo da Apple no dispositivo e ao Private Cloud Compute as ferramentas dos servidores que liga, convertidas para o formato da framework Foundation Models da Apple. Em cada momento tem carregados um ou dois serviços e no máximo oito das suas operações, o que mantém as definições das ferramentas suficientemente pequenas para a janela do modelo no dispositivo.

Como ligo o Home Assistant a um assistente de IA no iPhone através de MCP?

Adicione a integração Model Context Protocol Server no Home Assistant e crie um token de acesso de longa duração no seu perfil, em Segurança. No Orvena, toque em Conectar no Home Assistant, introduza o endereço HTTPS terminado em /api/mcp e cole o token. Os endereços http simples são recusados, incluindo na sua rede doméstica.

Posso usar o servidor MCP do Notion no iPhone?

Sim. O Notion é um dos seis conectores da lista do Orvena. Toque em Conectar em Ajustes, Conexões, inicie sessão no Notion e aprove o acesso. O Orvena usa o servidor alojado do Notion em mcp.notion.com e pergunta antes de uma ferramenta do Notion ser executada pela primeira vez. As ligações fazem parte do Premium Unlock.

Todas as ações MCP pedem aprovação?

As ações destrutivas perguntam sempre. As ferramentas que leem, criam ou alteram dados perguntam da primeira vez, e pode escolher Permitir sempre. Essa autorização fica listada em Ajustes, Compartilhamento de dados, Ferramentas permitidas, onde a pode revogar.