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:

  1. Abre Ojito en tu Mac.
  2. Ve al Onboarding o abre Settings → Agents.
  3. 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:

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json
JSON
{
  "mcpServers": {
    "ojito": {
      "command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
      "args": ["--mcp"]
    }
  }
}

Claude Code

Comando en terminal
Shell
claude mcp add ojito -- /Applications/Ojito.app/Contents/MacOS/Ojito --mcp

Cursor

~/.cursor/mcp.json
JSON
{
  "mcpServers": {
    "ojito": {
      "command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
      "args": ["--mcp"]
    }
  }
}

Codex

~/.codex/config.toml
TOML
[mcp_servers.ojito]
command = "/Applications/Ojito.app/Contents/MacOS/Ojito"
args = ["--mcp"]

Cualquier cliente MCP (stdio)

Transporte stdio estándar
JSON
{
  "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.

HerramientaQué haceParámetros
searchBú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_itemDevuelve 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)
recentLista 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_topicsLista los temas en los que Ojito clasificó tus capturas, ordenados por frecuencia.Ninguno
send_feedbackAbre 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:

01

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."

02

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."

03

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."

04

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."

05

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.