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 DeepSeek Harness

Cuatro pasos para quienes trabajan en el terminal. DeepSeek Harness (el comando dsh) es un entorno de agentes abierto de DeepSeek, en el que todo está organizado mediante plugins. Conecta los servidores MCP como cliente, mediante una entrada en el archivo de perfil. Aquí no hay ventana de inicio de sesión; el acceso se transmite mediante un token personal.

Las instrucciones se han verificado en la versión dsh 0.1.0-rc.7, las capturas de pantalla se han realizado en su interfaz web.

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.
⚠️ Entorno sin garantía. Compatibilidad garantizada Claude, ChatGPT, Grok y Hermes — el conector ha sido probado en ellos. DeepSeek Harness se abrió en agosto de 2026 y cambia rápidamente. Los nombres de los campos en las nuevas versiones pueden no coincidir con las instrucciones; en ese caso, consulte la documentación del plugin @deepseek-ai/dsh-mcp-client.
Acceso a la base de datos. Las solicitudes gratuitas de bienvenida en el chat web y el bot de Telegram no se aplican al conector. Antes de conectarlo, 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é necesitará

Por parte de CasusLegal
Acceso y token activos

Una suscripción o período de prueba para la base necesaria y un token personal del tipo vasrf_conn_… del área personal.

Desde el lado de DeepSeek
dsh instalado y perfil

Instalación mediante un solo comando: npm i -g @deepseek-ai/dsh. El perfil web se crea automáticamente en el primer inicio dsh web.

La clave del modelo DeepSeek solo es necesaria para las respuestas del agente; el propio conector se conecta independientemente de ella.

1
Genere un token y colóquelo en la variable de entorno

Abra área personal, la pestaña «Conectores», el bloque «Otros entornos» y pulse «Generar token». El token se muestra una sola vez.

Manténgalo en una variable de entorno y no en el texto de configuración, porque los archivos de perfil terminan fácilmente en copias de seguridad y repositorios.

export CASUSLEGAL_TOKEN=vasrf_conn_ваш_токен

El token es válido mientras la suscripción esté activa y abre todas las bases pagadas. Las conexiones ya configuradas Claude y ChatGPT no lo rompe.

2
Añada el servidor a la capa de parches del perfil

Las modificaciones personalizadas del perfil se encuentran en el archivo cordis.patch.yml en el directorio del perfil. Para el perfil web es ~/.dsh/profiles/web/cordis.patch.yml. El elemento contiguo cordis.yml — es la raíz del perfil y no se edita, tal como también se indica en el propio archivo.

La nueva entrada se añade mediante insert. Esta es la particularidad principal. Un parche sin insert se considera una modificación de una entrada existente, y dsh lo omitirá silenciosamente con una advertencia patch: entry … not found.

~/.dsh/profiles/web/cordis.patch.yml

- insert: - id: mcp-casuslegal name: '@deepseek-ai/dsh-mcp-client' config: serverName: casuslegal transport: streamable-http url: https://mcp.casus.legal/one/mcp headers: Authorization: !!js '`Bearer ${process.env.CASUSLEGAL_TOKEN}`' # una búsqueda tarda ~30 segundos: el valor predeterminado (60 000 ms) no es suficiente toolCallTimeoutMs: 180000

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 contratada; de lo contrario, el servidor responderá «la suscripción no está activa o ha caducado». No es necesario mantener simultáneamente la dirección única y las independientes: la red neuronal verá dos conjuntos de herramientas idénticos y realizará la búsqueda dos veces. La tabla completa de direcciones aparece más abajo, debajo de los pasos.

En serverName se permiten letras latinas, cifras, guiones y guiones bajos, hasta 32 caracteres, y el valor debe ser único entre los servidores conectados. A partir de él se generan los nombres de las herramientas mcp__casuslegal__….

Si necesita varias bases, añada en la misma lista un bloque para cada una, cambiando id, serverName y la dirección de la tabla siguiente. El token es el mismo en todos los bloques.

3
Compruebe que la entrada se haya incorporado al árbol del perfil

La configuración compilada del perfil se muestra mediante un comando independiente. Este no inicia el entorno:

dsh --profile web --dump-config | tail -20

Al final de la salida debe aparecer su entrada con la indicación de origen # == ~/.dsh/profiles/web/cordis.patch.yml. Si en su lugar se ha mostrado una advertencia patch: entry … not found, significa que falta insert del paso 2.

4
Inicie dsh y compruebe que el complemento se haya levantado

Inicie el entorno: dsh web — este levantará una interfaz web local y mostrará su dirección.

Pantalla principal de la interfaz web de DeepSeek Harness: a la izquierda, la lista de sesiones y el botón Settings; en el centro, el campo de entrada.
Pantalla principal DeepSeek Harness. El botón Settings — abajo a la izquierda.

Abra Settings → Plugins: en esta página se muestran los complementos de la compilación instalada.

Sección Plugins en la configuración de DeepSeek Harness, con las pestañas Plugin configuration y Plugin list.
Sección Plugins: pestaña Plugin configuration — configuración, Plugin list — lista completa.

Vaya a la pestaña Plugin list e introduzca en la búsqueda mcp. La entrada mcp-client en estado Enabled significa que el cliente está montado y se conecta a nuestro servidor.

Pestaña Plugin list con el filtro mcp: se ha encontrado una entrada mcp-client con el estado Enabled.
Filtro por palabra mcp: mcp-client — Enabled. Así se ve el conector montado.

A continuación, formule al agente una pregunta sustantiva, por ejemplo: «Encuentra jurisprudencia del Tribunal Supremo de la Federación de Rusia sobre la reducción de la penalización conforme al artículo 333 del Código Civil de la Federación de Rusia». Las herramientas del conector llegarán al modelo con los nombres mcp__casuslegal__….

Direcciones: única y por bases de datos

Base de datosserverNameDirección (url)
Todas las bases de datos contratadas de una vezcasuslegalhttps://mcp.casus.legal/one/mcp
Distritos de casación (todos)casuslegal_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)casuslegal_siphttps://sip.casus.legal/mcp
Asuntos administrativos (KAS · Sala Judicial de lo Contencioso-Administrativo del Tribunal Supremo de la Federación de Rusia)casuslegal_kashttps://kas.casus.legal/mcp
Asuntos penales (KUD · Sala Judicial de lo Penal del Tribunal Supremo de la Federación de Rusia)casuslegal_kudhttps://kud.casus.legal/mcp

Campos útiles del complemento

CampoFinalidad
toolCallTimeoutMsTiempo de espera de una llamada a la herramienta. De forma predeterminada, 60 000 ms; para buscar en el corpus, establezca 180 000.
failOnStartupErrorCon el valor true la compilación no se iniciará si el conector no está disponible. Es útil para no trabajar «sin jurisprudencia» sin darse cuenta.
reconnect.enabledReconexión automática después de una interrupción de la conexión. Activada de forma predeterminada.

Errores habituales

Al iniciar aparece la advertencia «patch: entry … not found»

En el parche falta insert. Sin ella, la entrada se considera una modificación de un complemento ya existente con ese id, y dsh la omite. Por ello, el conector simplemente no aparece, sin ningún error explícito.

Compare con el bloque del paso 2 y repita dsh --profile web --dump-config.

El complemento aparece como Enabled, pero el modelo no tiene herramientas

El cliente se activa incluso cuando la conexión falla; está diseñado así: la compilación no debe fallar debido a un servidor no disponible. Compruebe que la variable CASUSLEGAL_TOKEN sea visible para el proceso, es decir, que se haya exportado en el mismo shell desde el que se inicia dsh.

Para que estos casos sean detectables de inmediato, establezca en la configuración failOnStartupError: true.

¿Transporte: streamable-http o sse?

Solo streamable-http. Nuestra dirección funciona mediante Streamable HTTP; con el valor sse o stdio la conexión no se establece.

La llamada a la herramienta se interrumpe por tiempo de espera

Una búsqueda en el corpus tarda aproximadamente 30 segundos, y una pregunta compleja realiza varias búsquedas consecutivas. Los 60 000 ms estándar no son suficientes; establezca toolCallTimeoutMs: 180000.

El conector responde rechazando la suscripción

Abra la pestaña «Conectores» en el área personal y compruebe la vigencia de la suscripción a la base necesaria. Cada corpus se paga por separado; «Tribunales superiores» está incluido en cualquier paquete.

Se ha perdido el token

No vuelve a mostrarse. Genere uno nuevo en el gabinete y sustituya el valor de la variable de entorno; las conexiones anteriores no se interrumpirán.

ES