Organize with AI (OwAI)
Pesquise fotos e momentos de vídeo; gerencie coleções, favoritos e duplicatas em pastas locais, Apple Photos e OneDrive. OAuth; Cloud Access pago; a inferência hospedada usa créditos.
Servidor MCP hospedado
npx add-mcp 'https://index.organizewith.ai/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Conecte assistentes de IA ao OwAI com MCP
Conecte um assistente de IA à sua biblioteca de fotos e vídeos com o OwAI MCP. Configure o acesso local ou remoto, autorize sua conta e execute sua primeira pesquisa.
Autor: Alex Visheratin
Atualizado: 2026-10-19
O que é o OwAI MCP?
O Organize with AI (OwAI) é um organizador de fotos e vídeos local-first para macOS, Windows e Linux. Seu servidor Model Context Protocol (MCP) permite que assistentes de IA compatíveis pesquisem mídia indexada e gerenciem coleções, grupos, pessoas e candidatos a duplicatas usando as ferramentas do OwAI.
O aplicativo desktop é gratuito para navegação local, organização e pesquisa com modelos locais. Tanto o MCP local quanto o remoto exigem Cloud Access permanente. A inferência hospedada e a indexação na nuvem usam créditos pré-pagos separados; pesquisas de metadados exatas e chamadas de gerenciamento de biblioteca não consomem créditos de inferência. O Cloud Access não é uma assinatura.
Prepare sua biblioteca de mídia
Um assistente pesquisa o que o OwAI indexou, não todos os arquivos do seu computador. Adicione pastas locais, conecte o Apple Photos em um Mac compatível ou conecte o OneDrive, e deixe a indexação terminar antes de avaliar os resultados da pesquisa.
-
Instale e abra o OwAI. Adicione uma pasta de fotos ou vídeos e escolha o processamento de IA local ou hospedado nas Configurações do App.
-
Conecte sua conta OwAI com Cloud Access. Ative a detecção de rostos para uma pasta se quiser pesquisar por pessoas reconhecidas e, em seguida, rotule essas pessoas no OwAI.
-
Para pastas locais e Apple Photos via MCP remoto, ative a sincronização do índice na nuvem e aguarde a conclusão da sincronização inicial. O MCP local não exige sincronização do índice na nuvem. O Apple Photos precisa de autorização completa do Photos no Mac proprietário. O OneDrive usa o catálogo compartilhado na nuvem; conecte cada provedor usando seu guia.
Conecte o ChatGPT
O ChatGPT se conecta ao mesmo endpoint MCP remoto autenticado. Use o tutorial passo a passo do ChatGPT para a configuração atual de Plugins, login via OAuth, um primeiro teste somente leitura e solução de problemas. Nenhuma instalação local do MCP é necessária para essa conexão.
Conecte o Meta Muse
Peça ao Muse para criar um conector personalizado para o endpoint MCP remoto do OwAI. O guia do Muse inclui uma solicitação que você pode copiar, configuração de OAuth, uma verificação de conexão somente leitura, acesso a imagens e limpeza segura. Você não precisa de uma instalação separada da CLI do OwAI no computador na nuvem do Muse.
Conecte o Claude
O Claude usa o endpoint MCP remoto autenticado do OwAI. O guia dedicado aborda a configuração atual para indivíduos e organizações, verificação somente leitura, disponibilidade de mídia, permissões e o fluxo de exclusão revisado.
Conecte o Perplexity
O Perplexity pode usar o OwAI como um conector personalizado de consumidor ou por meio da Agent API. O guia dedicado mantém essas configurações separadas e inclui uma lista de ferramentas permitidas somente leitura e limitada, além de aprovação explícita para gravações.
Conecte o app Gemini via MCP remoto
Adicione https://index.organizewith.ai/mcp como um conector MCP remoto ou app conectado personalizado no seu assistente. Conclua o login na conta OwAI e a tela de consentimento de permissões e, em seguida, retorne ao assistente. Um login bem-sucedido por si só não é prova de que o conector terminou a vinculação.
No app web do Gemini, abra Configurações e ajuda → Apps conectados e adicione um app personalizado para o Spark. O guia atual do Google limita apps conectados personalizados ao inglês e ao Gemini Spark; a disponibilidade e os rótulos podem variar conforme a conta e a versão. Esta é uma conexão remota, não a integração local do Gemini CLI.
Para abrir arquivos no mesmo computador, copie a URL MCP remota específica do dispositivo em Configurações do App do OwAI → Assistentes de IA, no computador onde você usa o assistente. Não use a URL específica de outro computador como um conector de nuvem geral. O endpoint simples oferece suporte a pesquisa e gerenciamento remotos sem ativar a abertura de arquivos locais.
- Guia de registro e autenticação OAuth do agente (auth.md)
- Cartão público do servidor MCP (JSON)
- Guia oficial do Google para apps personalizados do Gemini
Conecte o Codex, o Claude Desktop ou o Gemini CLI localmente
No OwAI, abra Configurações do App → Assistentes de IA e use Conectar para um cliente local detectado. O OwAI configura seu executável desktop com o argumento --mcp. Mantenha o app OwAI em execução; o conector é um proxy stdio leve para esse app, não um segundo indexador ou processo de modelo.
Reinicie ou atualize a conexão MCP do assistente após configurá-la ou atualizar o esquema de ferramentas do OwAI. O MCP local pesquisa a biblioteca deste computador e segue as configurações de inferência local versus hospedada do app. Escolher um conector local não força a desativação da inferência hospedada.
Para um host sem janela de desktop, o pacote da CLI do OwAI executa o mesmo mecanismo com owai serve e gera sua própria configuração stdio com owai mcp-config. Consulte o guia da CLI para instalação e credenciais; não use o comando de inicialização --mcp do desktop como instruções de configuração da CLI.
- Comparar MCP local e remoto
- Executar o OwAI sem uma janela de desktop
- Referência da CLI para agentes
Experimente uma pesquisa de fotos com escopo de pasta
Pergunte: Encontre cinco fotos de praia de junho a agosto de 2026 no Rolo da Câmera. Substitua a pasta e as datas de exemplo por aquelas da sua biblioteca. O assistente deve passar a pasta e as datas como filtros estruturados, com apenas o conceito visual em visual_query.
A descoberta de ferramentas no cliente conectado é autoritativa. Use o nome exato da ferramenta e o esquema de entrada que ele anuncia; não adivinhe um prefixo local ou remoto a partir do nome de exibição do conector.
Para texto visível dentro das fotos, use o texto de consulta no estilo OCR '', como o texto 'STOP'. Esta é uma recuperação visual baseada em modelo, não uma transcrição exata garantida. Consulte o guia de gerenciamento de biblioteca para o exemplo completo e o fluxo seguro de exclusão.
Ferramenta: search_media
{
"source_name": "Camera Roll",
"media_type": "image",
"captured_from": "2026-06-01",
"captured_to": "2026-08-31",
"visual_query": "beach",
"limit": 5
}
Se a vinculação ou a primeira chamada falhar
Uma resposta invalid_scope significa que as permissões OAuth foram rejeitadas, não que um caminho de foto ou o índice de pesquisa local esteja quebrado. Um erro de permissão em uma ferramenta de gravação exige uma concessão de autorização apropriada do OwAI; permitir a ferramenta na interface de um assistente não amplia por si só as permissões do token.
Para uma biblioteca remota vazia, verifique se a mesma conta OwAI está conectada e se a sincronização inicial na nuvem foi concluída. Para um comando remoto pendente, mantenha o app OwAI proprietário em execução com a sincronização na nuvem ativada e inspecione o status do comando. Não informe uma alteração enfileirada como concluída.
HTML: https://organizewith.ai/en/guides/connect-ai-assistants