Conecta tu IA al derecho colombiano

man mcp

Qué es un conector MCP

MCP (Model Context Protocol) es el estándar con el que un modelo de lenguaje llama herramientas que no son suyas. Tú registras un servidor una vez; el modelo descubre solo qué herramientas hay, cuándo usarlas y con qué argumentos. No hay que programar nada ni cambiar de asistente.

El Cerebro Legal es uno de esos servidores. Expone cinco herramientas sobre 1,1 millones de normas y sentencias colombianas, y devuelve siempre el identificador de la fuente para que cualquier afirmación se pueda verificar.

auth --key

Paso 1 — tu API key

config --pegar

Paso 2 — pegar el conector

Elige tu cliente. En todos, lo único variable es dónde va el bloque; la URL y la cabecera son iguales.

claude mcp add --transport http cerebro-legal https://mcp.aliado.pro \
  --header "Authorization: Bearer sk_live_TU_KEY"

{
  "mcpServers": {
    "cerebro-legal": {
      "url": "https://mcp.aliado.pro",
      "headers": { "Authorization": "Bearer sk_live_TU_KEY" }
    }
  }
}

{
  "mcpServers": {
    "cerebro-legal": {
      "type": "http",
      "url": "https://mcp.aliado.pro",
      "headers": { "Authorization": "Bearer sk_live_TU_KEY" }
    }
  }
}

# pip install mcp
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://mcp.aliado.pro"
CAB = {"Authorization": "Bearer sk_live_TU_KEY"}

async def main():
    async with streamablehttp_client(URL, headers=CAB) as (r, w, _):
        async with ClientSession(r, w) as s:
            await s.initialize()
            print([t.name for t in (await s.list_tools()).tools])
            out = await s.call_tool("buscar_normas",
                {"query": "estabilidad laboral reforzada", "limit": 3})
            print(out.content[0].text[:400])

asyncio.run(main())

test --primera-pregunta

Paso 3 — la primera pregunta

Pídele algo que obligue a usar el corpus. Una buena primera prueba:

Con el Cerebro Legal, busca qué dice la ley colombiana sobre la
estabilidad laboral reforzada de la mujer embarazada. Cítame el
canonical_id de cada norma o sentencia que uses y dime, para las
normas, si siguen vigentes.

Sabes que funcionó cuando la respuesta trae identificadores concretos (co:ley:…, co:sentencia:…) y no solo prosa. Si tu asistente responde sin llamar a ninguna herramienta, dile explícitamente «usa las herramientas del Cerebro Legal».

tools --list

Las cinco herramientas

No tienes que llamarlas a mano: el modelo elige. Conocerlas sirve para pedirle lo correcto y para entender la factura.

El flujo que da mejores respuestas

1. buscar_normas para localizar. Si buscas la norma y no jurisprudencia, pasa tipo=LEY (o DECRETO): sin filtro, las sentencias suelen copar los primeros puestos.
2. texto_vigente antes de citar legislación.
3. leer_norma_completa para el texto largo, por secciones.
4. consulta_grafo para rastrear qué le pasó a la norma.

cat respuesta.json

Cómo leer las respuestas

Tres campos explican casi todo lo que puede confundir:

• canonical_id — con esto se cita y se consulta el grafo o la vigencia. Formato co:….
• doc_id — con esto se lee. Formato source:external_id. No es intercambiable con el anterior.
• estado_vigencia: null — significa fuente sin control de vigencia (jurisprudencia, doctrina administrativa), no que esté vigente.

Cuando una búsqueda devuelve total: 0, revisa aviso y cobertura: puede ser que esa fuente aún no esté indexada. Y modo te dice si la búsqueda vino degradada a solo-léxica.

prompt --recetas

Cómo pedirlo bien

El conector le da a tu IA las fuentes; lo que le pidas decide si las usa.

• Exige el identificador. «Cítame el canonical_id de cada afirmación» convierte una respuesta plausible en una verificable.
• Fija la fecha cuando importa. «¿Qué regía el 12 de marzo de 2019?» hace que se consulte la vigencia a esa fecha y no la de hoy.
• Di si quieres norma o jurisprudencia. Son corpus muy distintos y el ranking los mezcla si no lo dices.
• Pide el texto, no el resumen, cuando vayas a citar literalmente: «tráeme el artículo completo».
• Pregunta qué le pasó después. «¿Esta norma fue modificada o derogada? Rastréalo en el grafo» es lo que ningún modelo puede saber de memoria.

usage --limites

Créditos y límites

Cada llamada a una herramienta consume créditos según la tabla de arriba. El plan gratuito trae 50 créditos al mes y 10 solicitudes por minuto, sin tarjeta. Los créditos del plan se renuevan cada mes; el saldo recargado no caduca mientras la cuenta esté activa.

Tu consumo en vivo:

curl -s https://api.aliado.pro/v1/usage \
  -H "Authorization: Bearer sk_live_TU_KEY"

Lo mismo, con gráficas y desglose por herramienta, está en tu panel.

curl --api-rest

Sin MCP: la API REST

Misma key, mismos datos, mismos créditos. Útil para pipelines, backends y herramientas que no hablan MCP.

curl -X POST https://api.aliado.pro/api/tools/buscar \
  -H "Authorization: Bearer sk_live_TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "vigencia del articulo 90 de la ley 100", "limit": 5}'

debug --codigos

Cuando algo falla

Qué no hace

El Cerebro Legal entrega información jurídica documental y no constituye asesoría legal. Está en beta: la cobertura crece cada semana y por eso cada respuesta trae la fuente exacta — para que la verifiques antes de usarla. No entrenamos modelos con tus consultas.