El conector de CasusLegal en su producto

1. Conexión

Servidor MCP estándar: se conecta como cualquier otro conector en su chat.

Cómo obtener la clave

La clave de asociado tiene el formato clp_<имя>_…. Hay dos métodos; la dirección de conexión y las reglas de funcionamiento son iguales en ambos.

• La clave se le entrega ya preparada. Así está conectada, por ejemplo, la plataforma Doczilla: el gestor de CasusLegal transmite la clave por un canal seguro; usted la guarda en su servidor y la inserta en el encabezado Authorization. Nosotros renovamos la clave cuando usted lo solicita. El área personal con sus estadísticas y la activación de las bases también está disponible: el gestor le enviará un enlace de invitación.
• Usted genera la clave por sí mismo. Así está conectada, por ejemplo, una plataforma de Samara: el gestor envía un enlace de invitación al área personal del asociado lk.casus.legal/pcab (el nombre de usuario y el código de un solo uso están dentro). Usted introduce el correo electrónico y la contraseña, pulsa «Generar clave» y la copia: la clave se muestra una sola vez; si se pierde, se genera otra y la anterior deja de funcionar.

La clave proporciona acceso a todas las bases que se le hayan activado. Guárdela únicamente en el servidor y no la envíe al navegador del usuario final.

curl -sS https://mcp.casus.legal/partner/mcp \
  -H "Authorization: Bearer $CASUS_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2025-06-18","capabilities":{},
        "clientInfo":{"name":"my-platform","version":"1.0"}}}'

En la respuesta se incluye serverInfo.name: "CasusLegal Partner". A continuación tools/list deberá devolver nueve herramientas.

2. Encabezados de la solicitud

X-Partner-User-Id — cualquier cadena estable que no revele la identidad: su identificador interno o su hash. Se necesita para llevar un registro individualizado por usuario: con él se cotejan nuestras cifras y las suyas (cuántas llamadas, de qué tipos y cuántas personas llegaron realmente al conector). No afecta al acceso: no hay límites en cuanto al número de usuarios.

3. Herramientas

Nueve herramientas, cada una con un parámetro corpus.

Parámetro corpus

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
  "name":"casuslegal_search_practice",
  "arguments":{
    "query":"взыскание неустойки, снижение по статье 333 ГК",
    "corpus":"main",
    "limit":10
  }}}

4. Qué se recibe en la respuesta

Un objeto estructurado. En el corpus principal son bloques constitutional_context (posiciones del Tribunal Constitucional de la Federación de Rusia), vs_guidance (Plenos y reseñas del Tribunal Supremo de la Federación de Rusia), latest_practice (resoluciones recientes de las salas), vas_history (jurisprudencia del Tribunal Supremo de Arbitraje (arbitrazh) de la Federación de Rusia) y results.

Volumen

Una búsqueda: aproximadamente 110.000 caracteres, unos 40.000 tokens de entrada para su modelo. Es un formato deliberado: la exhaustividad de los resultados es el producto. Tenga en cuenta este volumen al elegir el modelo que procesa la respuesta: con estas dimensiones, la diferencia de coste entre modelos llega a ser de doce veces.

Tiempo

La búsqueda tarda unos 30 segundos. Establezca el tiempo de espera de la llamada a la herramienta en al menos 120 segundos; de lo contrario, interrumpirá solicitudes que se están ejecutando correctamente.

Enlaces a las resoluciones

Cada resolución tiene un campo url — una página con el texto completo. Transmítala al usuario tal cual y no recorte el parámetro ?t=: sin él, el enlace no es válido. La duración del enlace es de 30 días. Si prevé insertar los enlaces en documentos del cliente, díganoslo; los haremos permanentes.

Texto completo

La búsqueda devuelve los datos identificativos y los fragmentos clave; la resolución completa se obtiene mediante una llamada independiente casuslegal_get_case_details(case_id, corpus). El parámetro case_id — es el número del campo id de la ficha de resultados. La ficha también tiene un campo homónimo case_id, pero contiene el número de asunto (una cadena del tipo «305-ЭС22-11906»); no se debe transmitir. id es válido únicamente dentro de su propio corpus; lo mismo se aplica a casuslegal_find_similar.

5. Errores y carga

Los rechazos llegan como una respuesta correcta de la herramienta con un campo error — así, su modelo explicará la situación al usuario, en lugar de considerar que el conector está averiado.

401 solo se devuelve en el nivel de conexión: la clave no es correcta, ha sido revocada o ha caducado. Es un error de configuración; repetir la solicitud no lo solucionará.

Carga

No hay límites en cuanto al número de usuarios, llamadas ni solicitudes simultáneas: la integración paga cada solicitud con resultado, y no limitamos el volumen de consultas.

Tenga en cuenta una propiedad física: las búsquedas simultáneas en el corpus principal comparten entre sí el tiempo de procesador. Cuatro búsquedas paralelas terminan aproximadamente en el mismo tiempo que cuatro secuenciales, y cada una tarda más que una búsqueda individual. La ventaja temporal se obtiene mediante el paralelismo entre distintos corpus: son atendidos por servicios independientes. Si prevé una carga máxima, avísenos con antelación; añadiremos capacidad para atenderla.

6. Facturación

Se factura cada solicitud correcta que le devuelva contenido: búsqueda, texto completo de una resolución, resoluciones similares, listado, descarga y comentario de «Glossa», 3,00 ₽ por solicitud, el texto completo de la resolución — 2,00 ₽. Las llamadas informativas y técnicas son gratuitas.

• El precio no depende de la base: los tribunales superiores, el Tribunal de Derechos de Propiedad Intelectual, KAS, KUD y los distritos de casación se facturan al mismo precio; el prefijo de la herramienta no influye.
• Cada página browse_practice y cada llamada export_cases se facturan como una solicitud, independientemente del número de resoluciones que contengan.
• La búsqueda y el listado en todos los distritos a la vez (okrug_search_practice, okrug_find_term, okrug_browse_practice sin parámetro corpus) se ejecutan por separado en cada distrito que tenga abierto y se contabilizan como una solicitud en cada uno de ellos. Para pagar una sola solicitud, indique el distrito.
• Una llamada que termine con un error de nuestra parte no se factura. Los mensajes técnicos del protocolo (initialize, tools/list) no se consideran llamadas.
• Si su integración tiene abierto el comentario de «Glossa», su búsqueda y lectura (glossa_search, glossa_support, glossa_get_point, glossa_get_article, glossa_find_by_act, glossa_find_similar) se facturan al mismo precio; glossa_stats es gratuito.
• Los días y los periodos de liquidación se calculan según la hora de Moscú.

El número de llamadas, tanto de pago como gratuitas, desglosado por herramientas, bases, distritos y días, junto con el importe a pagar, se muestra en el área del socio lk.casus.legal/pcab. Allí también puede emitir la clave y activar o desactivar las bases que tenga abiertas: una base desactivada responde con un rechazo y no se factura. Su gestor de CasusLegal le envía el enlace para el primer acceso; usted establece la contraseña. El periodo de prueba gratuito aparece indicado por separado: el importe correspondiente se muestra a título informativo y no se factura.

Procedimiento de liquidación

El área del socio está diseñada para el autoservicio. En el primer acceso, deberá establecer una contraseña, indicar el correo electrónico para el intercambio de documentos y proporcionar los datos de la organización: sin ellos, el área no se habilita. Los datos se incorporan de inmediato en el contrato, las actas y las facturas; el contrato ya está firmado por nuestra parte (mediante facsímil). Descárguelo en la sección «Documentos y liquidaciones», fírmelo y cargue el escaneo mediante el botón «Cargar contrato firmado». El contrato también se considera celebrado tras el pago de la primera factura. Todos los documentos se almacenan en el área y pueden descargarse en cualquier momento.

• El período de liquidación es de 30 días naturales. El primer período comienza al día siguiente de la prueba gratuita (o en la fecha que indique el gerente), y cada período posterior comienza inmediatamente después del anterior. Coste de los servicios por período = solicitudes de pago × 3,00 ₽ (textos completos de las actas × 2,00 ₽).
• Los servicios se prestan mediante prepago. El gerente de CasusLegal determina el primer anticipo y lo factura para el primer período.
• Al día siguiente de finalizar el período, aparecen automáticamente en el área tres documentos: un acta con el cálculo (servicios menos el anticipo menos la compensación del saldo pagado en exceso), una factura por el importe adicional, si los servicios superaron el anticipo, y una factura por el anticipo del período siguiente: el 80 % del coste de los servicios del período vencido, redondeado al rublo. Los mismos documentos se envían a su correo electrónico. El importe pagado en exceso no se reembolsa, sino que se compensa en el período siguiente.
• Las facturas se pagan mediante transferencia bancaria en un plazo de 3 días laborables desde la finalización del período. Tras efectuar el pago, pulse «Informar sobre el pago» junto a la factura y adjunte la orden de pago. Cargue el acta firmada en la línea del período.
• Si llegada la fecha límite la factura no se ha pagado y no se ha cargado el justificante de pago, el acceso mediante la clave se suspende automáticamente; la carga del comprobante de pago restablece el acceso de inmediato, antes de la verificación. Si el pago no se confirma, el gerente escribirá en la sección «Mensajes» del área y el acceso volverá a suspenderse hasta que se reciba el pago.
• El saldo del prepago (anticipo, compensación, importe consumido desde el inicio del período) se muestra en el área en tiempo real. No está sujeto al IVA (empresario individual acogido al régimen tributario simplificado).

7. Lista de comprobación antes del lanzamiento

• Transporte: HTTP streamable, no SSE.
• tools/list devuelve nueve herramientas.
• El tiempo de espera de la llamada a la herramienta es de al menos 120 segundos.
• Título X-Partner-User-Id se incluye en cada llamada.
• corpus se selecciona según el tema de la pregunta, un corpus por solicitud.
• Enlaces url llegan íntegramente al usuario, junto con ?t=.
• El modelo que procesa los resultados se ha seleccionado teniendo en cuenta 40 mil tokens por búsqueda.
• Campo error se procesa y se muestra al usuario en la respuesta de la herramienta.