Conectar un asistente de IA (MCP)

Notificado tiene tres servidores MCP, uno por tipo de cuenta. Cada uno tiene su dirección, sus propios tokens y sus propias herramientas; un token de uno no abre los otros.

La mayor parte de esta guía es para las firmas. Los afiliados tienen su sección, Afiliados, y su guía completa, MCP para afiliados.

Firmas: /mcp

El servidor MCP de las firmas está en https://www.notificado.co/mcp (JSON-RPC sobre HTTP). Un asistente conectado puede buscar procesos, preparar borradores, cargar documentos, consultar entregas y descargar evidencia, según los alcances de su token. Nunca envía por su cuenta. Cómo lo hace, en Cómo trabaja el asistente.

Recomendado: con inicio de sesión (OAuth), sin token

Claude Code

Un comando, sin encabezado:

claude mcp add --transport http notificado https://www.notificado.co/mcp

La primera vez que lo use, Claude Code abre su navegador. Inicie sesión como propietario o abogado de la firma, revise qué aplicación pide acceso, elija los alcances y pulse Permitir. Eso es todo: no hay token que copiar ni guardar.

La conexión sigue activa mientras la use: Claude Code la renueva sola, y cada uso reinicia el plazo. Si pasan 60 días sin uso, la conexión se cierra; ese plazo es fijo. Si se cierra, Claude Code le pide iniciar sesión de nuevo. Aparece en Cuenta → API con el nombre del cliente, y allí la revoca cuando quiera.

Claude.ai, Claude Desktop, ChatGPT

Los clientes que agregan servidores MCP como conectores hacen lo mismo:

1. En su cliente, agregue un conector personalizado con la dirección https://www.notificado.co/mcp (en Claude: Configuración → Conectores → Agregar conector personalizado).
2. El cliente lo lleva a Notificado. Inicie sesión, revise qué aplicación pide acceso, elija los alcances y pulse Permitir.
3. Listo: la conexión aparece en Cuenta → API con el nombre del cliente, y allí mismo la revoca.

Notificado no verifica el nombre que declara la aplicación: autorice solo una conexión que usted inició. Ningún conector recibe herramientas del equipo de Notificado.

Para algo más duradero: un token personal

Para integración continua, un script o una herramienta que corre sin nadie frente al navegador, use un token personal. Usted elige la vigencia al emitirlo: 30, 60, 90, 180 o 365 días, una fecha exacta (vence al terminar ese día, hora de Colombia) o sin vencimiento. Un token sin vencimiento funciona hasta que alguien lo revoque: úselo solo en una integración que usted controla. En Cuenta → API ve cuándo se creó cada token, su último uso y su vencimiento, puede cambiar el vencimiento y lo revoca cuando quiera.

1. Emita un token

En Cuenta → API (/cuenta/api) cree un token con los alcances mínimos que necesite. Un asistente que solo informa necesita cases:read y notifications:read. Detalles en Autenticación de la API.

2. Conecte su cliente

Notificado exige el token en un encabezado Authorization: Bearer. Estos clientes lo admiten para servidores MCP remotos por HTTP:

• Claude Code, con un comando:

claude mcp add --transport http notificado https://www.notificado.co/mcp --header "Authorization: Bearer <token>"

• Claude Desktop: mediante el puente mcp-remote (requiere Node.js), en su archivo de configuración.
• Cursor: por URL y encabezados, en mcp.json.

La configuración exacta de Claude Desktop y Cursor, lista para copiar, está en MCP.

3. Pruebe la conexión

Pida al asistente que llame whoami({}): responde su firma (orgId), su rol, los alcances del token, su prefijo y su vencimiento. Luego list_resources({}): los recursos que el token puede usar. Y docs({}): el índice de recetas y guías que el propio servidor ofrece.

Cómo trabaja el asistente

Todo token ve las mismas cinco herramientas, cualquiera sea su alcance:

Las acciones de la firma no son herramientas sueltas: cada una está en un recurso y se ejecuta con manage_resource, con los mismos alcances, las mismas reglas y el mismo registro de actividad que en el panel. Al conectarse, el servidor le indica al asistente que llame primero whoami y luego list_resources. El orden es siempre el mismo:

list_resources({})                                   // qué hay
describe_resource({ resources: ["cases"] })          // los parámetros exactos
manage_resource({                                    // ejecutar
  resource: "cases",
  action: "caseList",
  params: { orgId: "<orgId>", q: "05001310300320260012300" },
})

El orgId es el que responde whoami. Los recursos, y lo que contiene cada uno:

• cases: los procesos de la firma. Buscar por radicado, cliente, juzgado o parte; registrar, corregir, archivar y reabrir.
• parties: las partes de un proceso y sus direcciones guardadas, con su procedencia. Guardar una dirección no es el juramento del art. 8.
• uploads: subir un PDF, PNG o JPEG. Una URL firmada para el PUT y una confirmación que verifica el tipo y registra el SHA-256.
• imports: importar un CSV de procesos y borradores, ver en qué quedó cada fila, bajar las filas con errores y seguir los envíos por lote.
• notifications: las notificaciones y sus borradores. Listar, leer la línea de tiempo de cada destinatario, redactar, adjuntar, revisar una dirección, descartar un borrador, ver rebotes, exportar a Excel, consultar el saldo de créditos y verificar una constancia.
• sends: pedir un envío y seguir los pedidos pendientes. Ningún pedido envía por sí solo.
• memorials: el memorial para el juzgado, en borrador DOCX y PDF, y su descarga. Nada se radica: usted lo revisa, lo firma y lo radica.
• court-outcomes: lo que decidió el juzgado sobre una notificación (aceptada, rechazada, nulidad). No es evidencia.
• templates: las plantillas de mensaje de la firma. Los textos del art. 8 se agregan siempre y ninguna plantilla los reemplaza.
• evidence: la constancia firmada en PDF y el paquete .zip de evidencia. Cada descarga queda registrada.
• deadlines: los términos calculados por destinatario y los cierres de juzgado que se descuentan. Es una estimación: el juez decide.
• billing: el extracto de créditos y las facturas electrónicas de la firma. Un agente no compra créditos.
• activity: quién hizo qué en la firma, lo más reciente primero.
• webhooks: los webhooks salientes de la firma y su registro de entregas. Solo con tokens del propietario.

Cada token ve solo los recursos y las acciones que abren sus alcances. Las descripciones que da list_resources están en inglés: son las que lee el asistente. Cada acción es también una operación de la API HTTP.

Confirmar antes de enviar

1. El asistente prepara el proceso, el borrador y los adjuntos.
2. Usted agrega los destinatarios en el panel, con el juramento del art. 8.
3. El asistente pide el envío con manage_resource({ resource: "sends", action: "sendNotification", params: { … } }): la respuesta es awaiting_confirmation con un enlace.
4. Usted abre el enlace y confirma en el panel dentro de 24 horas. Solo entonces se consumen los créditos y se congela, sella y envía el mensaje. Lo que nadie confirma en ese plazo vence sin enviar nada ni usar créditos.

Los pedidos que esperan su confirmación se ven en el panel, y el asistente los consulta en sends (receta Confirmar los envíos pendientes).

Límites

120 lecturas y 20 escrituras por minuto por persona, sumando todos sus tokens. Vea Límites.

Afiliados: /mcp/afiliados

Un afiliado aprobado puede conectar un asistente a su propia cuenta del programa en https://www.notificado.co/mcp/afiliados. El asistente ve solo esa cuenta: nunca una firma, sus procesos ni la cuenta de otro afiliado.

1. En /afiliados, sección Acceso para agentes (MCP y API), cree un token: un nombre y los alcances. El token se muestra una sola vez.
2. Conecte su cliente con ese token:

claude mcp add --transport http notificado-afiliados https://www.notificado.co/mcp/afiliados --header "Authorization: Bearer <token>"

En Claude Desktop, mediante mcp-remote:

{
  "mcpServers": {
    "notificado-afiliados": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.notificado.co/mcp/afiliados", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer <token>" }
    }
  }
}

Siempre en persona, nunca por un agente: postularse y aceptar los términos, la verificación de identidad y tributaria, la cuenta de pago y confirmar una factura. Todo el detalle, con la API equivalente, en MCP para afiliados.

Equipo de Notificado: /mcp/admin

https://www.notificado.co/mcp/admin es solo para el personal de Notificado, con tokens emitidos en la consola interna. Un token de firma o de afiliado no abre nada allí, y un token del personal que llama a /mcp recibe una negativa que indica /mcp/admin. Toda escritura de un agente del personal espera la confirmación de una persona del equipo antes de ejecutarse.