Cómo configurar Cherry Studio: proveedores de API y servidores MCP

En los «設定» de Cherry Studio, muchas personas buscan dos cosas: la configuración del proveedor para usar modelos con su propia clave de API y la configuración del servidor MCP para conectar herramientas externas. La primera se realiza en 設定 → モデルプロバイダー → プロバイダーを追加, y la segunda, en 設定 → MCP サーバー. Esta página se basa en la versión v2.1.4, publicada el 30 de septiembre de 2026, y explica ambos procedimientos conservando las etiquetas japonesas de la interfaz. Como la pantalla para añadir proveedores cambió considerablemente en v2, las guías de la época de v1 que indican seleccionar «タイプ：OpenAI» ya no coinciden con la interfaz.

El objetivo es la versión de escritorio de CherryHQ/cherry-studio (AGPL-3.0, Windows, macOS y Linux). A fecha del 1 de octubre de 2026, el repositorio no está archivado y la versión más reciente es v2.1.4. Ten cuidado: la aplicación con el mismo nombre de la App Store pertenece a otro desarrollador y no está relacionada. Para poner la pantalla en japonés, selecciona japonés en el idioma de la configuración (la interfaz admite 13 idiomas, incluido el japonés).

Configuración del proveedor: usar modelos con tu propia clave de API

Esta es la visión general del procedimiento. Las etiquetas corresponden a la interfaz japonesa de v2.1.4.

設定 → モデルプロバイダー → プロバイダーを追加
  （ダイアログ名：カスタムプロバイダーを追加）

  プロバイダー名            Kunavo
  APIキー                   sk-kn-...
  エンドポイント設定
    OpenAI                  https://api.kunavo.com/v1
    Anthropic メッセージ     https://api.kunavo.com
  その他のオプション
    OpenAI レスポンス        https://api.kunavo.com/v1   （任意）
    画像生成ベースURL         https://api.kunavo.com/v1   （任意）
    Google Gemini           空欄のまま

→ 保存 → モデル一覧で「モデルを同期」→ 使うモデルを追加 → 「チェック」

1. Abre Configuración → Proveedores de modelos y pulsa Añadir proveedor. El título del diálogo que se abre es «Añadir proveedor personalizado». Si quieres basarte en un proveedor existente para servicios de tipo Coding Plan, varias cuentas o separar proyectos, también puedes usar «Empezar desde un ajuste preestablecido (opcional)» en la parte superior.
2. Introduce Nombre del proveedor y Clave de API.
3. En Configuración del endpoint aparecen inicialmente dos campos: OpenAI y Mensajes de Anthropic. Se requiere al menos un endpoint de texto. Si rellenas ambos, podrás seleccionar modelos no solo para el chat, sino también para agentes y funciones que usen el formato de Anthropic.
4. Al abrir Otras opciones, aparecen campos para respuestas de OpenAI, Google Gemini, URL base de generación de imágenes y URL base de edición de imágenes. Puedes dejar vacíos los campos que no utilices.
5. Después de guardar, comprueba que el proveedor aparezca como Activo. Según la documentación oficial, si permanece desactivado, los modelos no aparecen entre las opciones aunque esté configurado. Es la causa más común de que «la clave no funcione».
6. Importa los modelos con Sincronizar modelos en la lista de modelos, añade los que vayas a utilizar y comprueba uno con Comprobar.

Cómo escribir la dirección: introduce solo la raíz

En el código fuente de v2.1.4, si la dirección raíz introducida en cada campo no contiene la parte de versión, se añade /v1 (si ya está presente, no se añade) y después se agrega la ruta correspondiente al campo. Debajo de cada campo aparece la URL final como «Ruta de solicitud», así que puedes comprobarla antes de guardar.

Hay dos cosas que no debes hacer. /chat/completions Si pegas una URL completa que incluya /messages, la ruta se duplica y produce un 404. El # final es el símbolo que, como indica la ayuda de la pantalla, «desactiva la versión de API añadida automáticamente»; si lo pones en un endpoint estándar, se omite /v1.

Configurar el modelo predeterminado para no desperdiciar dinero

Cherry Studio llama a modelos en segundo plano, no solo para el chat. El modelo rápido se utiliza, según la descripción de la pantalla, para «tareas sencillas como nombrar temas o extraer palabras clave de búsqueda», y la ayuda recomienda «seleccionar un modelo ligero y evitar modelos de razonamiento». Configurar aquí un modelo barato evita que se ejecute uno caro en cada conversación. También puedes configurar un modelo de traducción por separado. Recuerda que, si seleccionas varios modelos y les haces una pregunta simultáneamente, se generan tantas solicitudes independientes —y facturas independientes— como modelos. El importe de las estadísticas de uso de la aplicación es una estimación basada en los precios publicados, por lo que puede ser superior al real en rutas con descuentos. Cambia el precio unitario en la configuración del modelo para ajustarlo a tus tarifas. Consulta la versión en inglés de Cherry Studio API cost para obtener más información.

Configuración del servidor MCP: conectar herramientas externas

MCP es un método de conexión que permite al modelo (Agent) utilizar herramientas y datos externos. El procedimiento de la documentación oficial es Configuración → MCP → Servidores MCP → Añadir. En la pantalla de adición, «Creación rápida» permite crear el servidor introduciendo solo los datos de conexión; el resto puede ajustarse después.

種類      標準入力/出力 (stdio)
コマンド   npx
引数       -y @modelcontextprotocol/server-filesystem /Users/you/notes
環境変数   （サーバーが求めるものだけ）

1. Elige el tipo según el método de conexión indicado por el proveedor. La documentación también pide «no deducirlo a partir del nombre e introducirlo según la configuración del proveedor».
2. Guarda y activa el servidor; espera a que su estado sea normal. En las pestañas «Herramientas», «Prompts» y «Recursos» de los detalles, comprueba qué ofrece.
3. Activa el servidor en Trabajo → menú Agent → Editar → MCP. El servidor no se añade automáticamente a todos los agentes.
4. También puedes insertar prompts MCP o recursos MCP proporcionados por el servidor desde el botón «+» del campo de entrada.

Como el modelo es quien llama realmente a las herramientas MCP, elige un modelo compatible con llamadas de herramientas. Los modelos de Claude y GPT añadidos en la configuración del proveedor anterior son compatibles con llamadas de herramientas. Como recomienda la documentación, al principio actívalos de uno en uno y comprueba su funcionamiento; es seguro mantener la configuración que exige aprobación para las herramientas que escriben datos o generan cargos. Aunque los instales desde los «servidores integrados» o el «marketplace» de MCP, revisa el contenido de los comandos y las variables de entorno.

Notas y pagos al usar Kunavo

• Alcance de la verificación. Esta configuración se ha elaborado a partir del código fuente y la documentación oficial de Cherry Studio; no es una verificación en la que Kunavo haya conectado Cherry Studio a su propio endpoint y lo haya ejecutado. Prueba manteniendo intacta la ruta que ya funciona.
• Las rutas de Kunavo solo cubren chat e imágenes. No hay modelos de embeddings, por lo que la búsqueda vectorial de una base de conocimiento requiere otro proveedor o un modelo de embeddings local (la documentación explica que también puede funcionar mediante búsqueda por palabras clave BM25 sin embeddings).
• Pago. Es un sistema de recarga prepaga sin cuota mensual; el saldo se descuenta por token. La recarga mínima es de $10. En el checkout de Stripe se pueden utilizar tarjetas (Visa, Mastercard, American Express y JCB), Apple Pay, Google Pay y Link. Consulta la información de facturación, crea una cuenta y genera una clave. La página de configuración en inglés es la guía de integración de Cherry Studio.

Preguntas frecuentes

Comprobado el 1 de octubre de 2026: API de GitHub (CherryHQ/cherry-studio, v2.1.4), cadenas de la interfaz japonesa de v2.1.4 (ja-jp.json), código fuente de la pantalla para añadir proveedores y página MCP de la documentación oficial de Cherry Studio. Kunavo no ha ejecutado Cherry Studio contra su propio endpoint.