MCP
Conecta tus agentes a Ojito por MCP
Ojito incluye un servidor MCP local de solo lectura por stdio. Claude Desktop, Claude Code, Cursor y Codex pueden buscar lo que leíste, viste o capturaste en tu Mac sin subir nada a la nube.
Configuración en 1 clic desde Ojito
La forma más rápida de conectar tus agentes es desde la propia app:
- Abre Ojito en tu Mac.
- Ve al Onboarding o abre Settings → Agents.
- Haz clic en Connect en Claude Desktop, Claude Code, Cursor o Codex.
Ruta estable entre actualizaciones
Ojito registra la ruta estable /Applications/Ojito.app/Contents/MacOS/Ojito. Cuando Sparkle actualiza Ojito en segundo plano, tu configuración de agentes sigue funcionando sin volver a editar nada.
Configuración manual
Si prefieres editar los archivos de configuración a mano o usas otro cliente MCP, copia el bloque correspondiente:
{
"mcpServers": {
"ojito": {
"command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
"args": ["--mcp"]
}
}
}claude mcp add ojito -- /Applications/Ojito.app/Contents/MacOS/Ojito --mcp{
"mcpServers": {
"ojito": {
"command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
"args": ["--mcp"]
}
}
}[mcp_servers.ojito]
command = "/Applications/Ojito.app/Contents/MacOS/Ojito"
args = ["--mcp"]{
"command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
"args": ["--mcp"]
}Herramientas disponibles
El servidor MCP expone 5 herramientas: 4 herramientas de solo lectura sobre tu base local de SQLite + FTS5 y send_feedback, que abre la ventana nativa de feedback de Ojito precargada con tu borrador para que lo revises y hagas clic en Enviar.
| Herramienta | Qué hace | Parámetros |
|---|---|---|
search | Búsqueda de texto completo sobre todo lo guardado en Ojito: screenshots (texto OCR), posts e hilos de X, páginas web, transcripciones de YouTube y notas de voz. Devuelve resultados ordenados por relevancia con sus ids. | query (string, requerido), source ("all" | "x" | "web" | "apps"), topic (string), limit (1-100, defecto 20) |
get_item | Devuelve el contenido completo de un elemento en Markdown: texto de la página o post, transcripción o texto OCR de la pantalla, junto con sus metadatos. | id (integer, requerido; obtenido de search o recent) |
recent | Lista los elementos guardados más recientemente, del más nuevo al más antiguo. | source ("all" | "x" | "web" | "apps"), limit (1-100, defecto 20) |
list_topics | Lista los temas en los que Ojito clasificó tus capturas, ordenados por frecuencia. | Ninguno |
send_feedback | Abre la ventana nativa de feedback de Ojito precargada con tu borrador para que puedas revisarlo y hacer clic en Enviar. El servidor MCP en sí es estrictamente de solo lectura y nunca hace solicitudes de red por su cuenta. | message (string, requerido), kind ("feedback" | "bug" | "idea") |
Garantía de privacidad
Las capturas privadas nunca se exponen por MCP
Todas las capturas marcadas como privadas u ocultas nunca salen de tu Mac y se filtran automáticamente fuera de search, recent, list_topics y get_item. El servidor MCP es estrictamente de solo lectura, corre por stdio local sin abrir puertos de red y nunca hace solicitudes de red por su cuenta. Cuando un agente llama a send_feedback, solo abre la ventana nativa de feedback de Ojito precargada con tu borrador para que lo revises y hagas clic en Enviar.
5 prompts reales para probar
Una vez conectado Ojito, prueba cualquiera de estos prompts en Claude, Cursor o Codex:
Recordar un hilo o artículo de esta semana
"Busca en Ojito el hilo o artículo que leí esta semana sobre SQLite FTS5 y dame los puntos clave con el enlace."
Sacar un snippet de código de una página capturada
"Usa Ojito para encontrar la página de documentación donde vi el ejemplo de configuración de Sparkle y extrae el bloque de código completo."
Resumir tu investigación sobre un tema
"Revisa mis temas en Ojito, busca todo lo que guardé sobre arquitectura local-first y resume los patrones que se repiten."
Encontrar un video de YouTube que viste
"Busca en Ojito el video de YouTube que vi sobre compilación incremental en Swift y dime qué parte explicaba el cacheo."
Revisar capturas recientes antes de escribir un doc
"Mira mis últimas 15 capturas en Ojito y agrúpalas en un borrador con referencias para el documento técnico que estoy por escribir."
Siguiente paso
Descarga o actualiza Ojito
Instala Ojito 0.2.4 en macOS y conecta tus agentes en segundos, o revisa los flujos diarios y los últimos cambios.