Calypso RAG

RAG multimodal para respuestas de IA respaldadas por fuentes

Documentación

Servidor MCP de Calypso

RAG multimodal alojado para Claude Desktop, Cursor y flujos de trabajo de agentes — en un solo comando npx.

Haz preguntas sobre PDFs, capturas de pantalla, gráficos y diagramas, y sube nuevo material fuente, sin ejecutar un almacén de vectores, una pila de Docker o un pipeline de OCR. Las respuestas incluyen citas que puedes verificar.

Este servidor es una superficie de Calypso Context — la misma capa de conocimiento que respalda a Calypso en WhatsApp, expuesta a clientes MCP. Cómo encajan las piezas →

Configuración en un comando: npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-your-key-here
RAG multimodal real: maneja texto y elementos visuales de forma nativa mediante Gemini File Search
Sube y consulta: herramientas dedicadas para archivos de conocimiento duraderos y cargas por lotes
Conversaciones de múltiples turnos: respuestas conscientes del contexto con reinicio de /new
Flujos de trabajo descubribles: recursos y avisos para flujos seguros de RAG, carga e ingesta

GitHub | Docs | Smithery | Registro oficial de MCP

Etiquetas: multimodal-rag, gemini-rag, hosted-rag-mcp, mcp-server

En lugar de conectar cada agente o flujo de trabajo a una pila de búsqueda de documentos puntual, usa este MCP como el punto de entrada orientado a agentes hacia una capa de respuestas reutilizable: sube material fuente una vez, recupera contenido de texto y visual, y devuelve respuestas con evidencia que los usuarios puedan verificar.

Inicio rápido

# One-liner with npx
npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-your-key-here"

O con variables de entorno:

CALYPSO_API_KEY="sk-..." npx -y @calypsohq/multimodal-rag-mcp-server

Luego agrega el mismo comando a Claude Desktop, Cursor o Smithery usando los ejemplos de configuración a continuación.

Por qué elegir Calypso

Sin almacén de vectores local, sin Docker Compose y sin un pipeline separado de OCR o visión antes de que un agente pueda hacer una pregunta fundamentada. Apunta el servidor a una clave de API de Calypso y este descubre los agentes y depósitos de conocimiento de tu equipo al conectarse.

Cero infraestructura: un comando npx; nada que alojar u operar.
Multimodal sin un segundo pipeline: el texto y los elementos visuales se indexan juntos, por lo que un gráfico o una captura de pantalla se pueden consultar igual que un párrafo.
Las respuestas llevan evidencia: las respuestas incluyen referencias de fuentes y metadatos de recuperación.
Lectura y escritura: consulta conocimiento y agrega a él — archivos, lotes y sitios web — desde el mismo servidor.

Lo que obtienes

Agente de Calypso multimodal de producción con memoria de múltiples turnos
Herramientas de carga integradas para archivos individuales y cargas de conocimiento por lotes
Descubrimiento automático de las variantes RAG y depósitos de conocimiento de tu equipo
Citas verificables con referencias de fuentes y metadatos de recuperación
Recursos de solo lectura y avisos reutilizables para flujos de trabajo seguros

Por qué RAG multimodal primero

La mayor parte del conocimiento empresarial no es solo texto. La respuesta a menudo vive en una captura de pantalla de configuración, una tabla en PDF, un diagrama de producto, una página del centro de ayuda o un gráfico dentro de un informe. Calypso empaqueta esa superficie de conocimiento completa en una sola capa de recuperación para que los agentes puedan hacer preguntas fundamentadas sin adivinar desde la memoria genérica del modelo.

Busca en los formatos que los usuarios realmente usan: documentación, PDFs, capturas de pantalla, gráficos, diagramas, imágenes de producto, artículos de soporte, manuales, políticas, preguntas frecuentes e informes.
Fundamenta las respuestas antes de que el modelo escriba: Gemini File Search recupera primero el contexto de texto y visual relevante, luego el agente de Calypso responde desde ese material fuente.
Muestra el rastro de evidencia: las respuestas pueden incluir referencias de fuentes, fundamentación consciente de la página y metadatos de recuperación para que las personas puedan verificar antes de confiar.
Delimita la recuperación con metadatos: usa espacio de trabajo, equipo, cliente, idioma, tipo de archivo, estado u otros metadatos para mantener las respuestas relevantes sin duplicar bases de conocimiento.
Reutiliza la misma capa de conocimiento en todas partes: conecta Cursor, Claude Desktop, agentes de IA, flujos de n8n, interfaz de producto, flujos de soporte y experiencias web a la misma capa respaldada por fuentes.

En la práctica, esto significa que tu agente puede responder preguntas como:

"Explica esta captura de pantalla de configuración y el PDF de política adjunto. ¿Qué debería hacer el representante de soporte a continuación?"
"¿Qué dice este PDF de incorporación sobre las reglas de aprobación?"
"¿Por qué falla esta pantalla de configuración?"
"Compara el gráfico de precios con nuestra documentación de planes y recomienda el nivel correcto."
"Resume la política que aplica a este ticket de soporte."
"¿Qué plan de producto se ajusta a este cliente según nuestros documentos de precios?"
"Compara el flujo de ingesta diagramado con el flujo de recuperación."

Qué hace este MCP

Con calypso-agent puedes:

Hacer preguntas fundamentadas contra la base de conocimiento de Calypso configurada
Seleccionar cualquier variante RAG del equipo descubierta con el argumento opcional model
Continuar una conversación de múltiples turnos mediante el modelo de conversación nativo /v1/responses
Reiniciar el contexto de la conversación con /new
Usar el mismo endpoint de Respuestas compatible con OpenAI que sirve a calypso-agent
Descubrir recursos y avisos integrados para los flujos de trabajo de Calypso compatibles

Requisitos

Node.js 18+
El servidor usa primitivas de Web Fetch API (fetch, Headers, Request, Response, FormData, Blob y File) para llamadas de API y compatibilidad con SDK. El paquete inicializa los globales faltantes al inicio para entornos de ejecución MCP que exponen solo parte de la superficie de Web API de Node 18+.
Un endpoint de API de Calypso que exponga:
- POST /v1/responses
- GET /v1/rag-agent/models
- GET /v1/knowledge/buckets
- POST /v1/knowledge/files/upload-session
- POST /v1/knowledge/files/upload-session/{session_id}/finalize
- POST /v1/knowledge/files:batch/upload-session
- POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize
- GET /v1/knowledge/batches/{batch_id}
Una clave de API de Calypso (sk-...)

Configuración

Variables de entorno:

CALYPSO_API_KEY (obligatoria)
CALYPSO_API_BASE_URL (opcional, predeterminada https://api.calypso.so/v1)

Banderas de CLI:

--api-key
--api-base-url

Precedencia de configuración:

Banderas de CLI / argumentos de comando proporcionados por Smithery
Variables de entorno
URL base predeterminada (https://api.calypso.so/v1)

Ejecutar con npx

npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-..."

Ejecutar con variables de entorno

env CALYPSO_API_KEY="sk-..." CALYPSO_API_BASE_URL="https://api.calypso.so/v1" npx -y @calypsohq/multimodal-rag-mcp-server

Configurar en Cursor

Agrega un nuevo servidor MCP (tipo de comando) como:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

Configurar en Claude Desktop

1. Abre la configuración MCP de Claude Desktop

En Claude Desktop:

Claude -> Settings -> Developer -> Edit Config

En macOS, el archivo suele estar en:

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop usa claude_desktop_config.json para servidores MCP de escritorio. Claude Code usa ubicaciones de configuración separadas como ~/.claude.json o .mcp.json a nivel de proyecto.

2. Agrega el servidor MCP de Calypso

Pega esto en claude_desktop_config.json:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    }
  }
}

Reemplaza:

sk-your-calypso-api-key

con tu clave de API real de Calypso.

3. Reinicia Claude Desktop por completo

Sal de Claude Desktop por completo y luego vuelve a abrirlo.

No solo cierres la ventana. En macOS:

Cmd + Q

Después de reiniciar, el MCP debería aparecer en Claude con estas herramientas disponibles:

calypso-agent
calypso-list-buckets
calypso-upload-file
calypso-upload-files-batch

Opcional: guardar artefactos de Claude en tu Mac

Calypso proporciona herramientas RAG multimodales alojadas. No escribe informes generados, resúmenes, CSV, archivos JSON o artefactos de búsqueda web directamente en tu computadora local.

Para permitir que Claude Desktop guarde archivos generados localmente, agrega el servidor MCP de sistema de archivos estándar junto a Calypso y restringe su acceso a una carpeta segura dedicada.

Crea la carpeta primero:

mkdir -p ~/Claude

Luego agrega ambos servidores a claude_desktop_config.json:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Claude"
      ]
    }
  }
}

Sal y vuelve a abrir Claude Desktop por completo después de cambiar la configuración.

Ejemplo de aviso:

Use Calypso for the grounded RAG answer, then save the final report as /Users/yourname/Claude/report.md using the filesystem tool.

Por seguridad, solo otorga acceso al sistema de archivos a una carpeta dedicada como ~/Claude, no a todo tu directorio de inicio.

Preocupación	Mejor responsable
Respuestas RAG respaldadas por fuentes	MCP de Calypso
Subir archivos a Calypso	MCP de Calypso
Escribir `.md`, `.pdf`, `.json`, `.csv`, etc. en tu Mac	MCP de sistema de archivos
Artefactos de búsqueda web de Claude	Claude más aviso de MCP de sistema de archivos

Smithery

El servidor está disponible en Smithery y se inicia a través de la misma ruta de paquete npx que usan los clientes de escritorio.

Configuración de usuario de Smithery:

calypsoApiKey (obligatoria)
calypsoApiBaseUrl (opcional, predeterminada a https://api.calypso.so/v1)

La ruta de inicio de Smithery es equivalente a:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

Usa calypsoApiBaseUrl solo cuando apuntes a una implementación autohospedada compatible con Calypso. El valor predeterminado en la nube no necesita una anulación.

Solución de problemas

Falta la clave de API: proporciona --api-key o CALYPSO_API_KEY
Host de API incorrecto: asegúrate de que --api-base-url / CALYPSO_API_BASE_URL termine en /v1
Implementación autohospedada: solo anula la URL base si no estás usando https://api.calypso.so/v1
Desajuste de inicio de Smithery: usa la ruta empaquetada npx -y @calypsohq/multimodal-rag-mcp-server en lugar de ejecutar node dist/index.js desde un clon nuevo
FormData is not defined o Headers is not defined: actualiza al paquete más reciente. El servidor MCP inicializa los globales faltantes de Web Fetch API antes de que se ejecuten las herramientas de carga.
ENOENT para /mnt/user-data/uploads/...: esa ruta pertenece a un agente alojado o a un entorno aislado de archivos adjuntos, no necesariamente al servidor MCP. Reintenta con contentBase64 en lugar de filePath.
Guardado de artefactos locales: las respuestas de Calypso se pueden usar con el servidor MCP de sistema de archivos de Claude Desktop, pero se debe pedir explícitamente a Claude que guarde la salida final en una ruta local permitida.

Elegir `filePath` vs `contentBase64`

Usa filePath para instalaciones MCP locales, incluidas las configuraciones de Claude Desktop y Cursor que inician este paquete con un comando local como:

npx -y @calypsohq/multimodal-rag-mcp-server

En esa configuración, el proceso del servidor MCP se ejecuta en tu máquina y puede leer rutas disponibles para la misma cuenta de usuario. Pasa la ruta local directamente; el servidor lee los bytes sin procesar y los sube a través de la URL de sesión de carga de Calypso. No necesitas codificar en base64 los archivos locales.

Usa contentBase64 para clientes MCP alojados o remotos, incluidos servidores alojados en Smithery, entornos de ejecución de navegador/nube, contenido generado en memoria y contenedores de agentes. En esos entornos, una ruta en tu Mac o estación de trabajo no es legible por el proceso del servidor MCP.

Si una ruta comienza con /mnt/user-data/uploads, /mnt/data, /mnt/attachments u otro prefijo de entorno aislado alojado, no la envíes como filePath a menos que este servidor MCP se esté ejecutando en ese mismo entorno aislado. Usa contentBase64 u otra fuente de bytes en línea en su lugar.

Herramientas disponibles

`calypso-agent`

Acceso directo al agente de Calypso.

Notas:

No enruta automáticamente a otras personas o agentes.
Descubre automáticamente las variantes de calypso-agent disponibles para la clave de API al inicio.
Usa el argumento opcional model para elegir una variante con nombre como calypso-agent:pricing.
Cada variante de modelo mantiene su propia cadena de conversación MCP, por lo que cambiar de variante no continúa el hilo incorrecto.
Usa POST /v1/responses en lugar de POST /v1/chat/completions.
Los primeros turnos crean una conversación con nombre, y los turnos de seguimiento se encadenan con previous_response_id.
Se admiten fileIds opcionales para preguntas con alcance de recuperación. Las nuevas cargas deben usar las herramientas de carga de conocimiento duradero y esperar la indexación antes de preguntar.
Usa /new como aviso para reiniciar la conversación MCP.

`calypso-search`

Busca directamente en tu conocimiento y devuelve pasajes coincidentes, sin pedir a un agente que redacte una respuesta.

Úsalo cuando quieras evidencia en lugar de prosa — verificar si algo está indexado, reunir fuentes antes de una decisión, o permitir que un agente llamador razone por sí mismo sobre los pasajes.

Notas:

Usa POST /v1/search.
query es obligatorio.
agent delimita la búsqueda al conocimiento de una variante de agente; buckets la reduce a depósitos específicos.
maxResults se limita a 1–20.

Ejemplo:

{
  "query": "annual plan refund window",
  "buckets": ["support-handbook"],
  "maxResults": 5
}

`calypso-list-buckets`

Lista los buckets para el equipo vinculado a la clave de API de Calypso configurada.

Notas:

Utiliza GET /v1/knowledge/buckets.
No acepta team_id; Calypso deriva el alcance del equipo a partir de la clave de API.
Devuelve ids de bucket, slugs, nombres, estado, recuentos de miembros, recuentos de fuentes y disponibilidad del almacén de buckets.
Por defecto, solo muestra buckets activos. Pasa includeArchived: true cuando necesites buckets archivados para auditorías o limpieza.
Úsalo antes de calypso-upload-file o calypso-upload-files-batch cuando necesites elegir un bucket de destino.
calypso://rag-agent-models responde qué buckets están vinculados a cada variante de RAG. calypso-list-buckets responde qué buckets existen para el equipo de la clave de API.

Ejemplo:

{
  "includeArchived": false
}

`calypso-get-file`

Obtiene los metadatos de un archivo de conocimiento y su estado de indexación por id de archivo.

Notas:

Utiliza GET /v1/knowledge/files/{file_id}.
Resuelve el fileIds opaco de calypso-list-buckets en nombre de archivo, tipo MIME, tamaño, estado de indexación y estado de sincronización por bucket.
Pasa verify: true para verificar contra el proveedor (?verify=gemini): más lento, pero autoritativo cuando un estado parece desactualizado.

Ejemplo:

{
  "fileId": "file_123",
  "verify": true
}

`calypso-add-website`

Ingiere un sitio web en un bucket de conocimiento, para que el contenido de las páginas sea consultable junto con los archivos subidos.

Notas:

Utiliza POST /v1/knowledge/websites.
url es obligatorio, y también lo es un destino: uno de bucketIds, bucketSlugs o bucket.
Los title, tagsHint y preferredLanguage opcionales ayudan a clasificar la fuente.
Pasa idempotencyKey para que un reintento sea seguro; se envía como el encabezado Idempotency-Key.
Al igual que con las subidas de archivos, la aceptación no es lo mismo que ser consultable: la página aún debe terminar de indexarse.

Ejemplo:

{
  "url": "https://example.com/pricing",
  "bucket": "pricing",
  "title": "Public pricing page",
  "idempotencyKey": "pricing-page-2026-08"
}

`calypso-create-bucket`

Crea un bucket vacío para el flujo de trabajo de crear y luego llenar.

Notas:

Utiliza POST /v1/knowledge/buckets (requiere un backend con este endpoint desplegado y la capacidad knowledge:bucket:create en la clave de API).
El servidor normaliza el slug; las colisiones devuelven un error bucket_slug_exists tipado.
Las repeticiones de idempotencyKey devuelven el bucket existente en lugar de generar un error.
Las subidas aún pueden crear buckets implícitamente mediante bucketSlugs + createMissingBuckets; esta herramienta existe para crear primero el destino.

Ejemplo:

{
  "name": "Product docs",
  "slug": "product-docs",
  "idempotencyKey": "create-product-docs-1"
}

`calypso-create-agent`

Crea una variante de agente de Calypso vinculada a uno o más buckets.

Notas:

Utiliza POST /v1/rag-agent/agents (requiere un backend con este endpoint desplegado y la capacidad rag:agent:create en la clave de API).
El payload de éxito comienza con model: pásalo directamente a calypso-agent.
Los vínculos de bucket se validan en el servidor: los buckets desconocidos o archivados devuelven bucket_not_found; las colisiones de id de agente devuelven agent_id_exists; el límite de agentes del plan devuelve agent_limit_reached.
Crear un agente actualiza el catálogo de modelos y emite notificaciones MCP tools/list_changed + resources/list_changed, por lo que la nueva variante es utilizable sin reconectar.

Ejemplo:

{
  "agentId": "support",
  "name": "Support agent",
  "bucketSlugs": ["product-docs"],
  "idempotencyKey": "create-support-agent-1"
}

`calypso-upload-file`

Sube un archivo al almacén de conocimiento duradero respaldado por buckets y a la canalización de indexación.

Notas:

Utiliza POST /v1/knowledge/files/upload-session, sube los bytes directamente al almacenamiento y luego finaliza con POST /v1/knowledge/files/upload-session/{session_id}/finalize.
Las subidas usan solicitudes de sesión JSON más PUT binarios firmados, no subidas de formulario multipart.
Devuelve metadatos de archivo y tarea, no un file_id de adjunto de chat.
Requiere un destino de bucket mediante bucketIds, bucketSlugs o bucket.
Usa filePath para instalaciones MCP locales de Claude Desktop/Cursor donde el servidor pueda leer la ruta. Usa contentBase64 para clientes MCP alojados o remotos que no puedan leer rutas locales.
Si un agente ve una ruta como /mnt/user-data/uploads/file.pdf, no debe enviarla como filePath; debe enviar los bytes del archivo como contentBase64.
Admite title, tags, metadata y idempotencyKey opcionales.
Enruta las subidas a buckets existentes con bucketIds o bucketSlugs, o usa bucket como atajo de slug único.
Pasa createMissingBuckets: true con slugs de bucket cuando quieras que Calypso cree destinos faltantes durante la subida.
Puede esperar opcionalmente hasta que la indexación alcance un estado listo antes de devolver.

Ejemplo:

{
  "filename": "handbook.pdf",
  "mimeType": "application/pdf",
  "filePath": "/Users/me/Documents/handbook.pdf",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "waitForIndexing": true
}

`calypso-upload-files-batch`

Sube de 1 a 100 archivos al almacén de conocimiento duradero en una sola solicitud.

Notas:

Utiliza POST /v1/knowledge/files:batch/upload-session, sube cada elemento aceptado directamente al almacenamiento y luego finaliza con POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize.
Las subidas usan solicitudes de sesión JSON más PUT binarios firmados, no subidas de formulario multipart.
Requiere batchIdempotencyKey; Calypso lo usa para derivar el id de lote duradero para reintentos.
Requiere un destino de bucket compartido mediante bucketIds, bucketSlugs o bucket, a menos que cada elemento proporcione su propio destino de bucket.
Admite valores predeterminados compartidos de bucketIds, bucketSlugs, bucket y createMissingBuckets, además de anulaciones por elemento.
Usa filePath por elemento para instalaciones MCP locales de Claude Desktop/Cursor donde el servidor pueda leer cada ruta. Usa contentBase64 por elemento para clientes MCP alojados o remotos que no puedan leer rutas locales.
Genera valores de client_file_id seguros para Firestore cuando se omite clientFileId.
accepted o queued significa que la subida es duradera, no necesariamente lista para consultas. Usa waitForBatchReady: true para consultar GET /v1/knowledge/batches/{batch_id}?include_items=true.
Inspecciona el estado por elemento, bucketSyncStatus y bucketSync para distinguir contenido indexado de recuperación lista para bucket.

Ejemplo:

{
  "batchIdempotencyKey": "kb-seed-2026-06-04",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "items": [
    {
      "filename": "faq.txt",
      "mimeType": "text/plain",
      "filePath": "/Users/me/Documents/faq.txt"
    }
  ],
  "waitForBatchReady": true
}

Recursos disponibles

`calypso://server-info`

Metadatos de servidor de solo lectura, incluidos la versión del paquete, la URL base de la API, el transporte, el modelo de autenticación y las capacidades expuestas.

`calypso://rag-agent-models`

Catálogo de solo lectura en tiempo de ejecución de variantes de modelo calypso-agent con alcance de equipo descubiertas desde la clave de API configurada, incluidos el buckets, bucket_ids y missing_bucket_ids activos de cada variante. Si el descubrimiento no está disponible, este recurso recurre al calypso-agent base.

`calypso://buckets`

Lista de solo lectura en tiempo de ejecución de buckets de conocimiento para el equipo vinculado a la clave de API configurada. Úsalo para inspeccionar ids/slugs de bucket y la disponibilidad del almacén de buckets antes de las subidas.

`calypso://workflows`

Una guía compacta de los flujos de trabajo admitidos de RAG y subida de archivos.

`calypso://security`

Notas de seguridad operativa para claves de API, lecturas de archivos locales, subidas y registro.

Prompts disponibles

calypso-question: redacta una pregunta de base de conocimiento fundamentada para calypso-agent
calypso-ingestion: prepara una subida duradera al almacén de conocimiento y una consulta de seguimiento
calypso-reset-conversation: inicia un hilo RAG limpio con /new

Flujos de trabajo comunes (copiar/pegar)

Recuperación de conocimiento

Resumir un tema:
- Summarize the knowledge base guidance for campaign approvals
Preguntar por una respuesta específica:
- What does our documentation say about indexing retries?
Comparar dos conceptos:
- Compare file indexing with retrieval execution in the current architecture
Iniciar un hilo nuevo:
- /new

Seguimiento de múltiples turnos

Refinar una respuesta anterior:
- Focus only on the ingestion path and ignore retrieval
Pedir fuentes o justificación:
- Explain which documented components are involved and why

Flujo de archivos del almacén de conocimiento

Descubrir buckets:
- Llama a calypso-list-buckets o lee calypso://buckets antes de elegir un destino
Subir conocimiento duradero:
- Llama a calypso-upload-file con el payload del archivo y title, tags o metadata opcionales
- Prefiere filePath para instalaciones MCP locales de Claude Desktop/Cursor; usa contentBase64 para clientes MCP alojados o remotos que no puedan leer rutas locales
Enrutar conocimiento a buckets:
- Usa bucket: "support-handbook" para un destino, bucketSlugs para múltiples destinos basados en slugs, o bucketIds cuando ya tengas ids de bucket estables
Crear destinos de bucket bajo demanda:
- Agrega createMissingBuckets: true cuando uses asignación de bucket basada en slugs y el destino pueda no existir aún
Esperar la indexación:
- Pasa waitForIndexing: true si quieres que la herramienta se bloquee hasta que el archivo de conocimiento esté indexado

Flujo de lote del almacén de conocimiento

Subir muchos archivos duraderos:
- Llama a calypso-upload-files-batch con items, batchIdempotencyKey y filePath por elemento para instalaciones MCP locales; usa contentBase64 por elemento para clientes MCP alojados o remotos
Enrutar el lote a buckets:
- Coloca bucket, bucketSlugs, bucketIds o createMissingBuckets compartidos en la llamada a la herramienta, y anula por elemento solo cuando sea necesario
Esperar la disponibilidad para consultas:
- Usa waitForBatchReady: true e inspecciona el estado del elemento devuelto y los campos de sincronización de bucket antes de consultar contenido nuevo

Consejos

Empezar de nuevo: usa /new para restablecer la conversación MCP (nuevo conversation_id + cadena de respuestas borrada).

Historial de versiones

Versión	Notas
3.0.0	Cambio importante. Se eliminó el soporte heredado de id de modelo `calypso-rag-agent`: un id no reconocido ahora es un error en lugar de reescribirse a la familia canónica. Se documentaron `calypso-search` y `calypso-add-website`, y se corrigió `calypso://server-info`, que estaba omitiendo `calypso-add-website`.
2.4.0	Se renombró la herramienta de pregunta `calypso-rag-agent` → `calypso-agent`. El catálogo de modelos ahora toma su valor predeterminado del descubrimiento en lugar de una constante fija.
2.3.x	Lanzamiento de búsqueda y correcciones de seguimiento.

Consulta CHANGELOG.md para más detalle.

Actualización a 3.0.0

Dos renombres se implementaron entre 2.4.0 y 3.0.0, y ninguno tiene alias.

La herramienta de pregunta es calypso-agent (antes era calypso-rag-agent). Los clientes MCP lo detectan en su próximo tools/list, pero cualquier prompt guardado, instrucción de agente o documentación que nombre la herramienta como cadena necesita actualizarse.
Los ids de modelo deben ser canónicos. calypso-rag-agent y calypso-rag-agent:{id} ya no se reescriben a calypso-agent[:{id}]. Pasarlos ahora falla con Unknown Calypso agent model, que nombra calypso://rag-agent-models como el lugar para encontrar ids válidos. Lee ese recurso, u omite model para usar el valor predeterminado descubierto.

El URI del recurso calypso://rag-agent-models no cambia deliberadamente. Es una dirección publicada, no un shim de compatibilidad.

Calypso RAG

Documentación

Servidor MCP de Calypso

Inicio rápido

Por qué elegir Calypso

Lo que obtienes

Por qué RAG multimodal primero

Qué hace este MCP

Requisitos

Configuración

Ejecutar con npx

Ejecutar con variables de entorno

Configurar en Cursor

Configurar en Claude Desktop

1. Abre la configuración MCP de Claude Desktop

2. Agrega el servidor MCP de Calypso

3. Reinicia Claude Desktop por completo

Opcional: guardar artefactos de Claude en tu Mac

Smithery

Solución de problemas

Elegir filePath vs contentBase64

Herramientas disponibles

calypso-agent

calypso-search

calypso-list-buckets

calypso-get-file

calypso-add-website

calypso-create-bucket

calypso-create-agent

calypso-upload-file

calypso-upload-files-batch

Recursos disponibles

calypso://server-info

calypso://rag-agent-models

calypso://buckets

calypso://workflows

calypso://security

Prompts disponibles

Flujos de trabajo comunes (copiar/pegar)

Recuperación de conocimiento

Seguimiento de múltiples turnos

Flujo de archivos del almacén de conocimiento

Flujo de lote del almacén de conocimiento

Consejos

Historial de versiones

Actualización a 3.0.0

Elegir `filePath` vs `contentBase64`

`calypso-agent`

`calypso-search`

`calypso-list-buckets`

`calypso-get-file`

`calypso-add-website`

`calypso-create-bucket`

`calypso-create-agent`

`calypso-upload-file`

`calypso-upload-files-batch`

`calypso://server-info`

`calypso://rag-agent-models`

`calypso://buckets`

`calypso://workflows`

`calypso://security`