Servidor MCP de Screvi

¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA conectarse a datos externos. El servidor MCP de Screvi da a tu asistente acceso a tus subrayados, fuentes y artículos guardados, para que puedas hacer preguntas basadas en lo que has leído en lugar de en lo que el modelo recuerda a medias.

El servidor de Screvi está en https://api.screvi.com/mcp. Funciona con cualquier cliente MCP que admita servidores remotos con OAuth, incluidos Claude (web, escritorio y móvil), Claude Code, Cursor y ChatGPT.

El acceso por MCP requiere una suscripción o prueba activa de Screvi.

Qué puede hacer tu asistente

• Buscar en tus subrayados por significado, no solo por palabras clave. Filtrar por favoritos, tipo de fuente, nombre de la fuente, autor o etiqueta.
• Abrir un subrayado o una fuente con sus etiquetas, notas y todos los subrayados de ese libro.
• Leer un artículo guardado completo, con tus subrayados y notas, y hacer preguntas sobre él.
• Explorar tus etiquetas y traer los subrayados de cualquiera de ellas.
• Buscar en tus artículos guardados por título, autor, dominio, estado de lectura, bandeja o Más tarde, favoritos, etiqueta o si los has subrayado.
• Recuperar subrayados al azar para un repaso diario.
• Guardar enlaces y capturar subrayados (opcional): guardar una URL en tu bandeja, o almacenar como subrayado un pasaje que el asistente encontró, con nota y etiquetas.
• Etiquetar y ordenar (opcional): añadir o quitar etiquetas, archivar, marcar como favorito o mover artículos a Más tarde, arreglar un título malo o volver a descargar un artículo que se guardó mal.

Nada en el servidor MCP elimina datos. Toda acción de escritura es reversible desde la app.

Conectar con Claude

1. Ve a claude.ai/settings/connectors y haz clic en Añadir conector personalizado.
2. Ponle el nombre Screvi y establece la URL del servidor MCP en https://api.screvi.com/mcp. Haz clic en Añadir.
3. Claude te envía a Screvi para autorizar. Inicia sesión y haz clic en Aprobar. La pantalla de consentimiento lista exactamente lo que estás concediendo.
4. Empieza una conversación nueva. Claude ya puede buscar en tus lecturas.

También puedes abrir el conector desde cualquier chat con el botón + y luego Conectores. Para desconectarlo, elimínalo desde la misma página de ajustes.

Conectar con otros clientes

Cualquier cliente que admita servidores MCP remotos con OAuth funciona igual: añade un servidor con la URL https://api.screvi.com/mcp y completa el inicio de sesión cuando el cliente abra la página de autorización de Screvi.

• Claude Code: claude mcp add --transport http screvi https://api.screvi.com/mcp y luego ejecuta /mcp para iniciar sesión.
• Cursor: añade la URL en Settings > MCP.
• ChatGPT: añádelo como conector en Settings > Connectors (modo desarrollador).

Ejemplos de peticiones

• "¿Qué he subrayado sobre la toma de decisiones?"
• "Encuentra mis subrayados favoritos de Meditaciones de Marco Aurelio."
• "Muéstrame los artículos que guardé este mes y todavía no he empezado."
• "¿Qué etiquetas uso más? Dame cinco subrayados de la más grande."
• "Archiva todas las newsletters de mi bandeja de más de dos semanas."
• "Este artículo se guardó como 'Sin título'. Arregla el título."

Herramientas disponibles

Las herramientas de lectura funcionan con cualquier conexión.

Herramienta	Qué hace
search	Búsqueda semántica y por palabras clave en todos los subrayados. Filtros: favoritos, tipo de fuente, fuente o autor, etiqueta.
get-highlight	Un subrayado con su fuente, etiquetas y notas.
get-source	Una fuente (libro, podcast, vídeo) con todos sus subrayados.
get-article	El texto completo de un artículo guardado, con tus etiquetas, nota y subrayados. Los artículos largos llegan por partes.
list-tags	Todas las etiquetas con recuentos de subrayados y artículos.
get-highlights-by-tag	Subrayados de una etiqueta, opcionalmente una muestra aleatoria.
random-highlights	Una muestra aleatoria de subrayados, opcionalmente limitada a favoritos, un tipo, una etiqueta o una fuente.
search-articles	Artículos guardados por título, autor, dominio, estado de lectura, bandeja o Más tarde, favoritos, etiqueta o número de subrayados.

Las herramientas de escritura solo funcionan cuando la conexión se aprobó con acceso de escritura. Cambian el estado de los artículos, nunca su contenido, y ninguna elimina nada.

Herramienta	Qué hace
save-article	Guarda una URL en tu bandeja, opcionalmente con etiquetas. La página se descarga en segundo plano.
create-highlight	Almacena un pasaje como subrayado, adjunto a una fuente o artículo si quieres, con nota y etiquetas.
add-tags	Etiqueta subrayados y/o artículos. Los nombres nuevos se crean.
remove-tags	Quita etiquetas de subrayados y/o artículos.
update-highlight	Añade o cambia una nota, marca como favorito o corrige el texto de un subrayado existente.
update-tag	Renombra o cambia el color de una etiqueta.
archive-articles	Archiva artículos o los devuelve a la bandeja de entrada.
set-articles-later	Mueve artículos a Más tarde o de vuelta a la bandeja de entrada.
favorite-articles	Marca o desmarca artículos como favoritos.
update-article-details	Arregla el título o el extracto de un artículo.
reparse-article	Vuelve a descargar un artículo desde su URL cuando la copia guardada está truncada o llena de texto de navegación.

¿Solo lectura o lectura y escritura?

Si una conexión puede cambiar algo se decide cuando la autorizas. La página de consentimiento de Screvi muestra lo que pidió el cliente: solo acceso de lectura, o lectura más gestión de artículos. Los clientes que se conectaron antes de que existiera el soporte de escritura siguen siendo de solo lectura.

Si tu asistente informa de que "Esta conexión es de solo lectura", desconecta Screvi en el cliente y conéctalo de nuevo. Aprueba la nueva solicitud si incluye acceso de escritura.

Privacidad y seguridad

• OAuth 2.0 con PKCE. Inicias sesión en la propia página de Screvi. Tu contraseña nunca llega al cliente de IA.
• Acceso con ámbitos. Lectura y escritura son permisos separados. Nada puede eliminar subrayados, fuentes ni artículos.
• Obtenido bajo demanda. Screvi devuelve solo lo que pide una consulta. Screvi no almacena tus conversaciones.
• Los tokens MCP no son inicios de sesión de la app. El token que tiene un cliente de IA solo funciona en el servidor MCP. No puede iniciar sesión en la app de Screvi, cambiar tu cuenta ni crear claves de API.
• Revoca cuando quieras. Abre Ajustes > API > Apps de IA conectadas en Screvi para ver cada cliente conectado y desconectar uno. El acceso termina al instante, aunque el cliente aún tenga su token. Eliminar el conector en el cliente de IA también funciona.

Solución de problemas

El conector me pide iniciar sesión otra vez. Las conexiones se renuevan solas en segundo plano y solo caducan tras 90 días sin uso, o cuando desconectas la app en Screvi. Inicia sesión una vez más y la conexión se reanuda.

"Suscripción requerida". MCP necesita un plan o prueba activa. Comprueba tu plan en la página de precios.

La búsqueda no devuelve nada. Los subrayados nuevos se indexan a los pocos minutos de importarse. Si la biblioteca es reciente, espera un poco e inténtalo de nuevo.

«El cuerpo del artículo aún se está descargando». Los artículos guardados por MCP se procesan en segundo plano. Pregunta de nuevo unos segundos después.

Relacionado

• API pública para scripts e integraciones a medida
• Búsqueda semántica con IA para ver cómo la búsqueda ordena los resultados