Como funciona o conector do Balise
Para os curiosos
O que ele alcança e como se conecta.
O que ela pode acessar
Sete coisas que ela pode acessar. Alguns detalhes que pode mudar.
- Suas coleçõesAs prateleiras que o Balise montou, quantos itens há em cada uma e o que cada registro guarda: produtor e safra numa garrafa, referência num relógio.
- Memória e seus DiasUma noite, uma viagem, a quinta volta ao mesmo balcão. Um dia volta inteiro, com um pequeno resumo privado feito a partir de até quatro das fotos dele.
- Busca de fotos e a contagem realNão é uma amostra: contagens exatas, linhas do tempo e totais de toda a biblioteca, várias perguntas de uma vez.
- Suas HistóriasRascunhos e publicadas, das mais recentes para as mais antigas: as seções em ordem, as legendas, as fotos em que cada uma se apoia e o link público, quando houver.
- Um ID de foto é um grupo, não um cliqueUma foto do Balise muitas vezes reúne vários cliques da mesma coisa. O cartão diz quantos, e cada clique tem seu próprio endereço.
- A pergunta que você começou no BaliseChegue a partir de uma pergunta feita no Balise e a conversa continua — suas perguntas, as respostas e as fotos que essas respostas citaram.
- Pequenas mudanças, se você permitirCada tipo precisa da sua própria permissão ao conectar. Ela pode salvar uma lista privada, guardar uma História publicada que você encontrou, marcar as reações e a nota de uma foto, corrigir um dado errado de uma foto, corrigir um episódio ou dar nome a uma pessoa na sua Memória, e deixar uma proposta de História para você terminar no app. Pode montar um cartão ou uma colagem privados com fotos que você aprovou. Nunca apaga, nunca publica e nunca decide quem é “eu”.
As ferramentas, pelo nome, para os curiosos
- query_memory
- search_photos
- query_photos
- get_photos
- list_domains
- get_domain_details
- get_domain_schema
- get_episode
- get_subject
- list_domain_subjects
- compose_share_asset
- list_stories
- get_story
- prepare_story
- list_saved_lists
- save_list
- init_conversation
- list_people
- update_episode
- name_person
- annotate_photo
- correct_photo
- search_saved_discoveries
- get_saved_discovery
- save_discovery
- update_discovery
Sua página de perfil só aparece como o link de algo que você já publicou. O conector não tem mais nada a dizer sobre ela. E as imagens continuam indisponíveis, a menos que você aprove um pedido exato; cartões e histórias publicados seguem as escolhas que você fez separadamente para eles.
Os detalhes
Seu assistente finalmente conhece seus lugares, suas garrafas, suas roupas e suas viagens.
A partir das fotos que você já tirou. Nada para digitar, nenhum hábito novo: você conecta uma vez e pergunta como perguntaria a alguém que estava lá. Aqui vão uma pergunta do começo ao fim, o endereço, cada permissão pelo nome e exatamente o que sai do seu celular.
Claude· conectado ao Balise
Qual era aquele vinho que a gente tomou em Mendoza? Quero algo parecido para sábado.
search_photos · vinho, Mendoza
PerSe La Craie 2019, de Gualtallary. Você fotografou a garrafa com os Andes ao fundo em 4 de abril de 2024. Para sábado, procure outro tinto de altitude de Gualtallary; vai estar na mesma linha.
Me mostra a foto.
get_photos · 1 foto · esperando no Balise
Já pedi ao Balise. Aprove no seu iPhone nos próximos 10 minutos e eu posso mostrar a foto para você durante a hora seguinte.
get_photos · 1 foto · aprovada no Balise
Aqui está: a garrafa sobre uma toalha branca, com os vinhedos e os Andes ao fundo.
O endereço
https://mcp.usebalise.com/
- ClaudeNo Balise, abra Seu Balise → IA conectada e toque em Claude. O Claude abre com o Balise pronto para adicionar: escolha Adicionar e faça login no Balise.
- ChatGPTToque em ChatGPT. O Balise copia o endereço e abre a página de plug-ins do ChatGPT: toque em +, cole em Conexão e faça login no Balise. Por enquanto, o ChatGPT precisa do modo de desenvolvedor ativado.
- Qualquer outro cliente MCPCole o endereço. O login passa pela sua conta do Balise com OAuth 2.1 e PKCE: nenhuma chave de API ou senha para entregar. Desconecte quando quiser, pelo assistente ou pelo Balise.
O que o Claude recebe quando pesquisa
Exemplo · o resultado de search_photos para a pergunta sobre Mendoza, resumido
{
"mode": "photos",
"total": 1, "returned": 1,
"query": "vinho Mendoza",
"photos": [{
"id": "example-photo-id",
"title": "PerSe La Craie 2019 com os Andes ao fundo",
"description": "Uma garrafa de PerSe La Craie 2019 sobre uma toalha branca, com vinhedos e os Andes atrás.",
"captured_on": "2024-04-04",
"place": "Gualtallary, Mendoza, Argentina",
"scene": "Mesa ao ar livre num vinhedo",
"domains": ["wine"],
"facts": ["wine › bottle: producer=PerSe, cuvee=La Craie, vintage=2019"]
}],
"capture_groups": [ … ], "facets": { … }
}
Não há nenhuma imagem, só texto. O Claude só recebe uma foto se pedir à parte e você aprovar exatamente aquela foto no Balise.
As permissões, pelo nome
| Permissão | O que ela permite |
|---|---|
balise:memory:read | Buscar, contar e consultar suas coleções, sua Memória, suas Histórias e o que você salvou. Só fatos. Obrigatória para conectar. |
balise:photos:read | Pedir fotos específicas. Nada é enviado até você aprovar essa seleção no Balise. Também é necessária para um cartão ou uma colagem privados. |
balise:lists:write | Salvar ou substituir uma Lista privada, depois que você confirmar na conversa. |
balise:discoveries:write | Guardar uma História publicada ou um destaque que você encontrou, com sua reação e sua nota. |
balise:memory:write | Suas próprias correções: o título, o lugar ou as fotos de um episódio; o nome de uma pessoa e a relação com você; as reações e a nota de uma foto; uma safra ou um produtor errado. |
balise:stories:write | Deixar uma proposta de História (fotos escolhidas e seções) para você terminar no app. Não guarda imagens nem publica nada. |
Nenhuma delas apaga, publica ou decide quem é “eu”.
O que sai do seu celular
- Cópias de processamentoCriptografadas no seu iPhone antes do envio e apagadas depois do processamento. Seus originais ficam no app Fotos da Apple.
- Fatos, para o seu assistenteNomes, datas, lugares, o que aparece na foto, suas reações e notas, como texto pesquisável.
- Uma foto, só com o seu simO Balise mostra a seleção exata. Você tem 10 minutos para aprovar; o acesso pelo Balise termina uma hora depois da aprovação, e olhar de novo não estende o prazo.
- O que ele já recebeuUma foto entregue ao seu assistente fica com ele, sob os termos dele. O fim da hora bloqueia novos acessos pelo Balise; não apaga a conversa.
- Histórias publicadasContinuam no ar até você tirá-las.
Nossa equipe não pode abrir suas fotos privadas.
Quem faz a IA funcionar
- A plataformaO Balise roda na Vertesia, uma plataforma de IA com certificação SOC 2. O que o Balise aprende fica guardado lá sob um ID de conta opaco — nunca com seu e-mail ou seus dados de login.
- Os modelosOs principais provedores de nuvem e IA são a OpenAI e o Google. Nós escolhemos os modelos e trocamos quando surgem outros melhores.
- O que eles veemCópias temporárias enquanto o Balise aprende uma foto, e as fotos de uma História ou de um desenho que você pedir. Memória e busca recebem os fatos como texto, nunca as imagens.
- Sua IA conectada, com
balise:memory:readFatos pesquisáveis nas suas coleções, na sua Memória e nas suas Histórias: nomes, datas, lugares, o que aparece, suas reações e notas. Uma foto só sai quando você aprova aquela seleção exata.
Nenhum deles pode treinar modelos com suas fotos.
Como se conecta
Três passos, um deles opcional.
- Importe as fotos que você escolher.A busca vai se completando conforme cada foto fica pronta, com data, lugar, fatos visíveis e qualquer nota que você adicionar. Se no iOS você liberar acesso só a algumas fotos, também funciona: o Balise só vê as fotos que você escolheu.
- Abra Seu Balise → IA conectada.Escolha seu app de IA, faça login no Balise e autorize o conector privado.
- Aprove um pedido exato de fotos quando precisar.Os fatos funcionam sem acesso às imagens. Se o seu assistente precisar de fotos, o Balise mostra a seleção exata antes de enviar qualquer coisa.
O Balise usa o suporte a conectores disponível no Claude e no ChatGPT. Os termos e os controles de conta do seu serviço de IA valem para tudo o que você pedir para ele receber.
O limite
Você escolhe até onde a conexão vai.
Quase sempre só olha. Quando escreve, fica privado.
Sua IA pode buscar, contar e consultar — coleções, Memória, suas Histórias, os fatos extraídos de cada foto. Também pode fazer os pequenos ajustes que você faria no app: uma lista, uma reação ou nota, uma safra errada, o título de um episódio, o nome de alguém. Cada tipo de mudança precisa da sua própria permissão. Nada do que ela faz apaga ou publica qualquer coisa.
Fatos por padrão. Fotos com permissão.
Nomes, datas, lugares, detalhes visíveis e suas marcações ficam disponíveis como texto. Se sua IA pedir fotos mais antigas que ainda não estejam disponíveis, o Balise mostra a seleção exata no app e não envia nada até você aprovar.
Seus originais ficam no app Fotos da Apple.
As cópias de processamento são criptografadas no seu iPhone antes do envio. Um serviço privado dedicado as descriptografa para o processamento, e as cópias comuns são apagadas depois.
Todo pedido de fotos expira.
O Balise mostra a seleção exata. A aprovação dá acesso pelo Balise somente à conexão que fez o pedido, durante uma hora, e visualizar as fotos não estende o prazo. O fim dessa hora não apaga uma foto que já foi entregue ao seu assistente.
Onde ficam os dados
O que o Balise aprendeu — títulos, lugares, datas, a safra de um vinho — fica guardado como texto na Vertesia, a plataforma de IA sobre a qual o Balise é construído, com uma chave que só abre a sua conta. Esse texto não tem a criptografia foto a foto: fica em armazenamento privado, atrás de verificações de acesso da sua conta. O seu assistente recebe exatamente esse texto: o resultado do search_photos acima. Para uma cópia, escreva para apps@usebalise.com (a exportação fica guardada 30 dias). Para apagar tudo, no app: Seu Balise → Fotos e importações → Exclua todos os dados do Balise.
Como suas fotos são protegidas · As regras exatas de retenção estão na política de privacidade. Depois de receber uma foto, o serviço de IA conectado segue os próprios termos e configurações.
