Quilvo

Qué hace el servidor

Quilvo expone un servidor MCP enfocado para asistentes personales de IA y automatización local. Es intencionalmente más pequeño que la API JSON: los asistentes pueden descubrir el contexto del proyecto, inspeccionar el historial de sesiones y registrar una sesión de escritura cuando el usuario se lo pide.

Endpoint https://quilvo.app/mcp/quilvo

Transporte HTTP MCP

Autenticación OAuth

Concesión mcp:use

Autenticación

Conéctate con OAuth

Los clientes MCP alojados se conectan a Quilvo mediante el flujo estándar de OAuth. Añade el endpoint, inicia sesión en Quilvo y aprueba la conexión cuando el cliente abra la pantalla de autorización.

Claves API: Las claves API públicas gestionadas por el usuario siguen perteneciendo a la API JSON y a las integraciones por script. Los conectores MCP usan OAuth en lugar de la configuración manual de tokens portadores.

Concesión

Quilvo anuncia una única concesión OAuth de MCP: mcp:use. Aprobarla permite al cliente usar las herramientas MCP disponibles para tu cuenta de Quilvo. El código de las herramientas sigue limitando cada solicitud a tus propios datos.

Herramientas

Herramientas disponibles

Una conexión OAuth aprobada puede ver el conjunto completo de herramientas MCP de Quilvo para el usuario autenticado.

Herramienta	Escritura	Propósito
list-projects	No	Lista los proyectos del usuario con estado, tipo, objetivo, recuento actual y progreso.
get-project	No	Lee un proyecto con las sesiones de escritura recientes cuando se solicita.
list-writing-sessions	No	Lista las sesiones de escritura recientes y devuelve los totales del rango seleccionado.
log-writing-session	Sí	Crea una sesión de escritura y actualiza el recuento actual del proyecto.
list-characters	No	Lista los personajes en planificación con rol, gancho, color y proyectos vinculados.
create-character	Sí	Crea un personaje (solo se requiere el nombre) y opcionalmente vincula un proyecto.
update-character	Sí	Actualiza campos de un personaje existente.
list-codex-entries	No	Lista las entradas del codex de construcción de mundos (ubicaciones, facciones, objetos, tradición).
create-codex-entry	Sí	Crea una entrada de codex de un tipo determinado y opcionalmente vincula un proyecto.
update-codex-entry	Sí	Actualiza campos de una entrada de codex existente.
list-timeline	No	Lista los eventos de la línea temporal de la historia con fechas de texto libre, tipo, proyecto y personajes.
create-timeline-event	Sí	Crea un evento de línea temporal (fechas ficticias o reales) y opcionalmente vincula personajes.
update-timeline-event	Sí	Actualiza un evento de línea temporal existente y sus personajes vinculados.

Conexión

Configuración del cliente

La configuración del cliente MCP varía según el host, pero el valor requerido es el mismo: la URL del servidor remoto. Los clientes autenticados descubren los metadatos OAuth de Quilvo desde ese endpoint. Usa HTTPS en producción.

1. 01 Añade el endpoint Usa la URL HTTP remota de MCP en el conector alojado o en el cliente MCP.
2. 02 Aprueba el acceso Inicia sesión en Quilvo y aprueba la conexión OAuth para la única concesión mcp:use.
3. 03 Usa las herramientas Después de la aprobación, el asistente puede listar las herramientas MCP de Quilvo disponibles para tu cuenta.

Valores de conexión

{
  "url": "https://quilvo.app/mcp/quilvo"
}

Algunos clientes MCP locales usan el almacén de certificados de Node. Si una URL de desarrollo local falla con HTTPS, usa la URL HTTP local mientras desarrollas.

Ejemplos

Argumentos de las herramientas

list-projects

Encuentra proyectos de redacción activos.

{
  "status": "drafting",
  "include_archived": false,
  "limit": 10
}

log-writing-session

Añade 750 palabras a un proyecto y mantén intacto el historial de sesiones.

{
  "project_id": "9b7d4f6a-...",
  "word_count_action": "add",
  "word_count": 750,
  "date": "2026-05-24",
  "duration_minutes": 45,
  "notes": "Morning session."
}

log-writing-session

Establece el total del proyecto cuando un editor o una aplicación de escritura conoce el recuento más reciente. Quilvo almacena solo el delta de sesión calculado.

{
  "project_id": "9b7d4f6a-...",
  "word_count_action": "set_total",
  "word_count": 42100
}

MCP o API

Usa la superficie adecuada

Usa MCP cuando un asistente de IA necesite una superficie de herramientas pequeña y descubrible. Usa la API JSON cuando estés creando una aplicación, script, importador o integración que controle su propia interfaz y flujo de solicitudes.