Traducción al español con fines informativos. El original en ruso es la fuente auténtica.
CasusLegal CasusLegal Corpus de jurisprudencia de los tribunales superiores ← Página principal

Conexión a Hermes

El cuarto entorno con soporte oficial. Se diferencia de los otros tres en que el propio programa es gratuito y se puede conectar cualquier modelo, a elección del usuario.

Hermes es un agente de la organización de investigación Nous Research. Existe una aplicación de escritorio para Windows, macOS y Linux, así como una versión para el terminal; ambas comparten la configuración. El conector de CasusLegal se añade como servidor MCP: dos campos e inicio de sesión mediante Telegram o con contraseña. A continuación se describen ambas vías: con la aplicación y sin ella.

En qué se diferencia Hermes de Claude, ChatGPT y Grok

Ventaja 1
El propio programa es gratuito

Hermes y su aplicación de escritorio se distribuyen gratuitamente y con código fuente abierto (licencia MIT). No hay suscripciones al propio agente: solo se paga por los tokens del modelo que se haya conectado. Si el modelo funciona localmente en el equipo, tampoco se paga por ellos.

A modo de comparación: los conectores personalizados en Claude y ChatGPT solo están disponibles en los planes de pago de los propios asistentes. La excepción es Grok: xAI anuncia que los conectores están disponibles para todos los usuarios, incluidos los del plan gratuito; en este, responde un modelo rápido de la línea Fast y el número de consultas está limitado.

Ventaja 2
Cualquier modelo, no uno solo

En Claude funciona Claude, en ChatGPT — GPT, en Grok — Grok. Hermes no está vinculado a un modelo concreto. Una sola clave OpenRouter permite acceder de inmediato a cientos de modelos de distintos desarrolladores. También se puede conectar una clave directa del proveedor: Anthropic, OpenAI, Google, xAI, DeepSeek, Qwen, Kimi, GLM, MiniMax y otros (en la documentación de Hermes hay más de treinta). También se puede ejecutar un modelo localmente (Ollama, LM Studio, llama.cpp) o indicar cualquier dirección propia, compatible con el formato de OpenAI.

El modelo se cambia directamente en el diálogo mediante el comando /model; el conector permanece conectado.

Ventaja 3
Los modelos se pueden comparar con una misma pregunta

La misma consulta, la misma base de datos CasusLegal y distintos modelos: se ve de inmediato cuál trabaja con mayor precisión con la jurisprudencia, cuál trata las citas con más cuidado y cuál es simplemente más barato para el mismo volumen.

En los otros tres entornos, esta comparación no está disponible: allí la elección se limita a los modelos del propio desarrollador del asistente.

Ventaja 4
El precio se adapta a la tarea

La búsqueda preliminar puede realizarse con un modelo barato o gratuito y el análisis de las resoluciones seleccionadas, con uno caro. Hermes muestra el gasto de la sesión actual y el uso del contexto en la barra de estado, y ofrece el desglose mediante el comando /usage.

La suscripción a CasusLegal es una sola y no afecta al coste del modelo: el conector proporciona las mismas resoluciones con cualquiera de ellos. Más adelante, en la sección «Con qué pagar el modelo», se explica cómo pagar los tokens.

Ventaja 5
Los materiales permanecen en su ordenador

Hermes funciona localmente: la correspondencia, la memoria, las claves y la configuración se almacenan en la carpeta del perfil de su ordenador, no en la nube del desarrollador. El contenido de las consultas se envía únicamente a los destinos que usted mismo haya indicado: al proveedor del modelo seleccionado y al conector de CasusLegal.

Para trabajar con materiales del cliente, este régimen es sensiblemente distinto del de un chat en la nube.

Ventaja 6
La aplicación y el terminal son un mismo programa

La configuración, las claves y el historial de diálogos son comunes: si conecta el conector en la aplicación, estará disponible también en el terminal, y viceversa. Puede cambiar libremente de uno a otro.

En el mismo lugar están disponibles las tareas programadas, los subagentes y las habilidades, incluidas las habilidades de CasusLegal.

EntornoModeloCoste del propio entorno
Claudesolo Claudeplan de pago del asistente
ChatGPTsolo GPTplan de pago + modo desarrollador
Groksolo Grokno: los conectores están disponibles también en el plan gratuito; la suscripción elimina los límites
Hermescualquiera: OpenRouter, clave directa del proveedor, modelo localno, el programa es gratuito

Condiciones de los planes Claude, ChatGPT y Grok los establecen sus desarrolladores y los modifican sin nuestra participación; antes de comprar, consulte sus sitios web.

Acceso a la base de datos. Las solicitudes gratuitas de bienvenida en el chat web y en el bot de Telegram no se aplican al conector. Antes de la primera conexión, active en el área personal un período de prueba gratuito de tres días o formalice una suscripción a la base necesaria.
Qué dirección conectar. Todas las bases están abiertas mediante una única dirección: tribunales superiores, el Tribunal de Derechos de Propiedad Intelectual, KAS, KUD y diez distritos de casación. Se abren exactamente las bases pagadas; la red neuronal elige por sí sola la adecuada según el tema de la pregunta.
Qué se necesitaDirección (URL)
Todas las bases pagadas, incluidos los distritoshttps://mcp.casus.legal/one/mcp
Dirección anterior de los distritos /okrug/mcp sigue funcionando; no es necesario volver a conectarla. Si ambas direcciones están conectadas, desactive /okrug/mcp: de lo contrario, la red neuronal verá las herramientas de los distritos dos veces.
⚠️ El nombre del servidor debe escribirse únicamente en caracteres latinos. El nombre con el que se registra el conector en Hermes (casuslegal, sip, kas, kud) participa en los identificadores internos de las herramientas. Un nombre en cirílico impide compilarlos: el servidor se conectará y aparecerá en la configuración, pero en el diálogo el modelo responderá que no encuentra herramientas. Si ya lo ha denominado en ruso, elimine el servidor y vuelva a registrarlo con letras latinas.

Instalación de Hermes

Si Hermes ya está instalado, pase directamente a la conexión del conector. Se instala de dos formas; el resultado es el mismo y solo cambia el procedimiento.

Opción A: aplicación de escritorio (adecuada para la mayoría)

Abra sitio web oficial de Hermes, descargue el instalador para su sistema y ejecútelo. Al iniciarse por primera vez, el programa le preguntará qué proveedor y qué modelo utilizar; puede cambiar esta selección en cualquier momento.

En Windows, el instalador no requiere derechos de administrador y descarga por sí mismo los componentes necesarios.

Opción B: terminal

Windows, PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

macOS, Linux o WSL2:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Después de la instalación, cierre y vuelva a abrir la terminal; compruebe hermes --version y realice la configuración inicial hermes setup. La aplicación de la versión de terminal ya instalada se abre con el comando hermes desktop.

Conexión del conector en la aplicación

No necesitará la terminal.

1
Abra la sección MCP

En el menú izquierdo de Hermes, seleccione Skills, vaya a la pestaña MCP y pulse New Server. A la derecha se abrirá el editor del archivo mcp.json.

La aplicación evoluciona rápidamente y los nombres de las opciones cambian de una versión a otra. Si no encuentra esa sección, búsquela en la configuración MCP servers o conecte el conector desde la terminal: el procedimiento es distinto, pero el resultado es el mismo.

2
Añada el servidor CasusLegal

Si aún no hay otros servidores, sustituya el contenido del editor por este texto:

{ "mcpServers": { "casuslegal": { "url": "https://mcp.casus.legal/one/mcp", "auth": "oauth" } } }

La dirección de conexión es https://mcp.casus.legal/one/mcp. Es una dirección única: a través de ella se abren todas las bases de datos que usted tiene contratadas, y la red neuronal selecciona por sí sola la necesaria según el tema de la pregunta. Si necesita un conector para una sola base de datos, también hay direcciones independientes (IP Court — https://sip.casus.legal/mcp, KAS — https://kas.casus.legal/mcp, KUD — https://kud.casus.legal/mcp), pero en ese caso la dirección debe coincidir con la base de datos pagada; de lo contrario, el servidor responderá «la suscripción no está activa o ha expirado». No es necesario mantener simultáneamente una dirección unificada y direcciones independientes: la red neuronal verá dos conjuntos de herramientas idénticos y realizará la búsqueda dos veces. El nombre del servidor se escribe con caracteres latinos. La tabla completa de direcciones figura más abajo.

Si en mcp.json ya hay otros servidores, no los elimine: añada el bloque casuslegal dentro del objeto existente mcpServers, separando los bloques contiguos con una coma.

3
Guarde y active el servidor

Pulse Save y compruebe que el interruptor situado junto al servidor esté activado: Hermes comprobará inmediatamente la conexión. Si aparece el estado Needs authentication, seleccione el servidor y pulse Authenticate.

4
Complete la autorización

En el navegador se abrirá la página de inicio de sesión de CasusLegal. Lo más sencillo es pulsar «Iniciar sesión mediante Telegram»: la cuenta se creará automáticamente si aún no existe. La segunda opción es la contraseña de acceso al conector disponible en el área personal. Confirme el acceso y vuelva a Hermes.

Tras iniciar sesión correctamente, junto al servidor se encenderá un indicador verde y en su tarjeta aparecerá la lista de herramientas disponibles.

5
Inicie un nuevo diálogo

Abra un nuevo chat y formule una pregunta concreta, por ejemplo: «Encuentra a través de CasusLegal la jurisprudencia del ВС РФ sobre la reducción de la cláusula penal conforme al artículo 333 del ГК РФ». La respuesta debe incluir los datos identificativos de las resoluciones, con enlaces a los textos completos.

Si las herramientas no se han cargado, ejecute en el chat /reload-mcp y vuelva a crear el diálogo.

Conexión del conector mediante la terminal

1
Añada un servidor MCP
hermes mcp add casuslegal --url "https://mcp.casus.legal/one/mcp" --auth oauth

Nombre casuslegal se utiliza únicamente dentro de su Hermes; puede sustituirlo por cualquier nombre corto en caracteres latinos.

2
Complete la autorización

Hermes abrirá en el navegador la página de inicio de sesión de CasusLegal: inicie sesión mediante Telegram o con una contraseña y confirme el acceso. Si el navegador no se abre automáticamente, copie el enlace mostrado en la terminal y ábralo manualmente.

3
Active las herramientas

Hermes se conectará al servidor, mostrará las herramientas encontradas y le ofrecerá activarlas todas a la vez o de forma selectiva. Actívelas todas: las herramientas de la base de datos funcionan únicamente en modo de lectura. El conjunto puede modificarse después mediante el comando hermes mcp configure casuslegal.

4
Reinicie Hermes y compruebe la conexión

Lo más sencillo es cerrar y volver a abrir Hermes. Si ya está iniciado, ejecute en el chat /reload-mcp, y después /new.

Comprobación
hermes mcp list # junto a casuslegal: ✓ enabled hermes mcp test casuslegal # Connected y número de herramientas

Direcciones: única y por bases de datos

Un solo conector con una dirección unificada es suficiente: a través de él se accede a todas las bases de datos que haya pagado. Las direcciones independientes solo son necesarias si desea deliberadamente un conector para una sola base de datos; en ese caso, cada una se conecta por separado y requiere una autorización independiente. La suscripción es única y válida simultáneamente en todos los entornos.

Base de datosNombre del servidorDirección (URL)
Todas las bases de datos contratadas de una vezcasuslegalhttps://mcp.casus.legal/one/mcp
Distritos de casación (todos)okrugahttps://mcp.casus.legal/okrug/mcp
Tribunales superiores: Tribunal Constitucional · Tribunal Supremo · Tribunal Supremo de Arbitrajecasuslegalhttps://mcp.casus.legal/mcp
Tribunal de Derechos de Propiedad Intelectual (IP Court)siphttps://sip.casus.legal/mcp
Asuntos administrativos (KAS · Sala Judicial de lo Contencioso-Administrativo del Tribunal Supremo de la Federación de Rusia)kashttps://kas.casus.legal/mcp
Asuntos penales (KUD · Sala Judicial de lo Penal del Tribunal Supremo de la Federación de Rusia)kudhttps://kud.casus.legal/mcp
Bases de datos independientes en la aplicación: mcp.json (si no se necesita una dirección unificada)
{ "mcpServers": { "casuslegal": { "url": "https://mcp.casus.legal/mcp", "auth": "oauth" }, "sip": { "url": "https://sip.casus.legal/mcp", "auth": "oauth" }, "kas": { "url": "https://kas.casus.legal/mcp", "auth": "oauth" }, "kud": { "url": "https://kud.casus.legal/mcp", "auth": "oauth" } } }
Bases de datos independientes en la terminal (si no se necesita una dirección unificada)
hermes mcp add casuslegal --url "https://mcp.casus.legal/mcp" --auth oauth hermes mcp add sip --url "https://sip.casus.legal/mcp" --auth oauth hermes mcp add kas --url "https://kas.casus.legal/mcp" --auth oauth hermes mcp add kud --url "https://kud.casus.legal/mcp" --auth oauth

Qué modelo elegir

Requisitos del modelo

El conector es un conjunto de herramientas que el modelo invoca por sí mismo, por lo que no cualquiera será adecuado. Se necesitan dos características: funcionamiento fiable con la invocación de herramientas y una ventana de contexto de al menos 64 mil tokens: tal es el requisito de la documentación de Hermes. La jurisprudencia llega en fichas voluminosas, y cuanto mayor sea la ventana, más extensa será la investigación que pueda soportar un solo diálogo.

Una elección funcional son los modelos potentes de Anthropic, OpenAI y Google; lo más cómodo es conectarlos con una sola clave de OpenRouter, sin abrir cuentas con cada desarrollador por separado. Los modelos locales pequeños sirven para probar y familiarizarse, pero en una cadena larga de invocaciones de herramientas fallan con mayor frecuencia.

El modelo se cambia mediante el comando /model directamente en el diálogo; no es necesario volver a conectar el conector.

Cómo pagar el modelo

Hermes es gratuito, por lo que solo hay una cuestión: con qué tokens trabaja. Hay tres vías, que pueden combinarse: es posible configurar varios proveedores y cambiar entre ellos durante el trabajo.

Vía 1: suscripción del desarrollador de Hermes (Nous Portal)

Nous Research tiene su propia suscripción Nous Portal. Un solo inicio de sesión mediante OAuth da acceso de inmediato a más de trescientos modelos (Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok), además de «Tool Gateway»: búsqueda web, generación de imágenes, síntesis de voz y un navegador en la nube sin claves independientes para cada servicio. La documentación de Hermes denomina recomendada esta vía.

hermes setup --portal # instalación nueva: inicio de sesión, proveedor y herramientas de una vez hermes model # ya instalado: seleccionar Nous Portal en la lista hermes portal info # qué está conectado y adónde se envían las solicitudes

Hay cuatro planes, y uno de ellos es gratuito. El importe pagado se abona en la cuenta en forma de créditos con un suplemento del 10 %; el saldo no utilizado se transfiere parcialmente al mes siguiente:

PlanPrecio mensualCréditosQué incluye
Free0nosolo los modelos gratuitos del portal (lista más abajo)
Plus20 dólares22 dólares, transferencia de hasta 10todo el catálogo y las herramientas integradas
Super100 dólares110 dólares, transferencia de hasta 50lo mismo, con límites superiores
Ultra200 dólares220 dólares, transferencia de hasta 100lo mismo, con límites superiores

A los suscriptores del portal, la documentación les promete además un descuento del 10 % con los proveedores que cobran por tokens. Los precios se comprobaron en el portal el 1 de agosto de 2026 y cambian sin nuestra participación; antes de pagar, consúltelos en el propio portal.

Ruta 2 — su suscripción a ChatGPT y otras ya pagadas

No es necesario pagar aparte por los tokens: Hermes puede funcionar con su suscripción vigente ChatGPT. En la lista de proveedores esto OpenAI Codex. El inicio de sesión se realiza mediante un código de dispositivo: Hermes muestra una dirección y un código, y usted lo confirma en el navegador con su cuenta de OpenAI. No se necesita una clave API ni instalar Codex CLI (y, si ya está instalado, Hermes utilizará sus credenciales). Están disponibles los modelos de la línea Codex; el consumo se descuenta de los límites de su suscripción, y el comando /usage muestra el saldo restante y los reinicios acumulados del límite.

Del mismo modo se conectan otras suscripciones, si ya las tiene pagadas:

SuscripciónCómo conectarlaQué es importante saber
ChatGPThermes model → OpenAI Codex, inicio de sesión mediante código de dispositivomodelos de la línea Codex, consumo según los límites de la suscripción
Claudehermes model → Anthropic, inicio de sesión mediante OAuthsolo el plan Max y créditos adicionales «extra usage»: no se consume el límite básico de Max, y la suscripción Pro no basta para esta ruta. De lo contrario, se necesita una clave de Anthropic API con pago por tokens
Grokhermes model → xAI Grok OAuthse necesita una suscripción SuperGrok o Premium+, no se requiere una clave API
GitHub Copilothermes model → GitHub Copilota través de la suscripción Copilot están disponibles GPT-5.x, Claude y Gemini; el token clásico ghp_ no sirve
MiniMax, Qwenhermes model → MiniMax (OAuth) o Qwen OAuthinicio de sesión mediante el navegador, sin clave API

Las condiciones de estas suscripciones las establecen sus titulares y pueden modificarse sin nuestra participación. Comprobado con la documentación de Hermes el 1 de agosto de 2026.

Ruta 3 — modelos gratuitos

Puede probar la combinación «Hermes + conector» sin pagar nada por los tokens. Hay modelos gratuitos tanto en el propio portal del desarrollador como en OpenRouter; en ambos casos, el identificador termina en :free.

En el plan gratuito de Nous Portal (1 de agosto de 2026) están disponibles cinco modelos:

  • poolside/laguna-s-2.1:free — ventana de contexto de aproximadamente un millón de tokens;
  • poolside/laguna-xs-2.1:free, stepfun/step-3.7-flash:free;
  • tencent/hy3:free, inclusionai/ling-3.0-flash:free.

El plan gratuito no proporciona créditos monetarios: los modelos de pago del catálogo no están disponibles en él; solo funcionan estos cinco.

En OpenRouter en la misma fecha eran gratuitos, entre otros:

  • nvidia/nemotron-3-ultra-550b-a55b:free — ventana de aproximadamente un millón de tokens;
  • nvidia/nemotron-3-super-120b-a12b:free y la línea nemotron-3-nano;
  • google/gemma-4-31b-it:free, google/gemma-4-26b-a4b-it:free;
  • openai/gpt-oss-20b:free, inclusionai/ling-3.0-flash:free.

Todos los modelos enumerados superan el umbral de 64.000 tokens que Hermes exige al modelo. El sufijo :free es obligatorio: sin él, el mismo identificador designa la variante de pago del mismo modelo. En el diálogo, el cambio se ve así:

/model nvidia/nemotron-3-ultra-550b-a55b:free

Hay otras dos opciones gratuitas: una clave de build.nvidia.com (en la lista de proveedores aparece como NVIDIA NIM) y un modelo propio en su ordenador mediante Ollama o LM Studio, donde no hay ningún cargo por tokens.

La composición del conjunto gratuito cambia: algunos modelos aparecen y desaparecen, y las promociones puntuales terminan: el acceso gratuito a Nemotron 3 Ultra en Nous Portal estuvo vigente del 4 al 18 de junio de 2026 y ya ha finalizado. Antes de trabajar, consulte la lista del proveedor.

Con los modelos gratuitos, las cadenas largas de llamadas a herramientas fallan con mayor frecuencia. Son suficientes para una búsqueda preliminar de jurisprudencia; para analizar resoluciones seleccionadas, es mejor cambiar a un modelo de pago más potente.

Una opción intermedia son los modelos que cuestan muy poco. Por ejemplo, deepseek/deepseek-v4-flash en el catálogo de Nous Portal: una ventana de contexto de aproximadamente un millón de tokens, a un precio de unos 11 centavos por millón de tokens de entrada y 22 centavos por millón de tokens de salida. No es gratuito, pero para volúmenes de búsqueda jurídica cuesta menos que una taza de café al mes.

Aparte: la nueva Kimi K3

Kimi K3 salió el 16 de julio de 2026 y se convirtió en el modelo insignia actual de Moonshot AI, sustituyendo a K2.5 y K2.6. La ventana de contexto es de aproximadamente un millón de tokens, por lo que en un diálogo cabe considerablemente más jurisprudencia que en la mayoría de los modelos.

En Hermes se activa de dos maneras:

  • a través de OpenRouter o Nous Portal: el identificador moonshotai/kimi-k3. A 1 de agosto de 2026, el precio en OpenRouter es de 3 dólares por millón de tokens de entrada y 15 por millón de tokens de salida;
  • directamente de Moonshot: la clave KIMI_API_KEY en el archivo ~/.hermes/.env, proveedor kimi-coding, modelo kimi-k3.
/model moonshotai/kimi-k3 # cambiar directamente en el diálogo

Es práctico ejecutar la misma pregunta en K3 y en el modelo habitual y después comparar cómo trató cada uno la jurisprudencia encontrada: selección de resoluciones, precisión de las citas y precio de la respuesta.

Cómo utilizarlo después de la conexión

No es necesario memorizar los nombres técnicos de las herramientas: escriba en lenguaje corriente y Hermes elegirá la adecuada:

El alcance del acceso lo determina la cuenta de CasusLegal con la que se haya autenticado. Hay más técnicas recopiladas en las páginas «Escenarios» y «Consejos».

Errores habituales

El servidor está conectado, pero no hay herramientas en el diálogo

Primero siga el procedimiento estándar: ejecute /reload-mcp y cree un diálogo nuevo: Hermes no incorpora los cambios de configuración de inmediato. Si no funciona, cierre y vuelva a iniciar el programa.

Compruebe la conexión con el comando hermes mcp test casuslegal: debe responder Connected y mostrar el número de herramientas. El diagnóstico general es: hermes doctor.

La segunda causa frecuente es el nombre del servidor en cirílico. Elimínelo (hermes mcp remove casuslegal) y créelo de nuevo utilizando caracteres latinos.

El navegador no se abrió o la autenticación no se completó

Copie el enlace de autenticación que aparece en el terminal y ábralo manualmente. Puede repetir el inicio de sesión en cualquier momento: hermes mcp login casuslegal, y en la aplicación — Skills → MCP, seleccione el servidor y pulse Authenticate.

Es más cómodo iniciar sesión desde una ventana de terminal independiente y no desde un diálogo ya abierto: allí se dispone de más tiempo para la autenticación.

La contraseña de acceso al conector se establece en el área personal y no coincide con el inicio de sesión mediante Telegram.

El inicio de sesión se ha completado, pero el conector responde con un rechazo

Abra la pestaña «Conectores» en el área personal y compruebe el estado de la suscripción precisamente para la base de datos a la que accede: las direcciones de las bases son diferentes, y la suscripción a «Tribunales superiores» no abre IP Court, KAS ni KUD.

Las consultas gratuitas de bienvenida en el chat web y el bot de Telegram no se aplican al conector.

El modelo responde basándose en sus propios conocimientos, sin consultar la base de datos

Dígalo expresamente: «utiliza CasusLegal y encuentra …». Si aun así no se invocan las herramientas, normalmente se debe al modelo; consulte la sección «Qué modelo es adecuado»: una ventana de contexto demasiado pequeña o una compatibilidad deficiente con la invocación de herramientas.

Comprobar la hipótesis es sencillo: cambie mediante el comando /model a otro modelo y repita la misma pregunta.

En la aplicación no hay pestaña MCP o en el terminal no existe el comando hermes mcp

La versión está desactualizada. Ejecute hermes update y reinicie el programa.

Necesita varias bases a la vez

Enumérelas en mcp.json o añádalas mediante comandos: arriba, en la sección «Direcciones de las cuatro bases», hay bloques preparados. Debe autenticarse por separado para cada base.

La suscripción es única y funciona simultáneamente en todos los entornos: no es necesario volver a conectar el conector al pasar de Hermes a Claude o ChatGPT no es necesario.

Enlaces oficiales de Hermes

ES