Referencia técnica

Servidor MCP

El servidor MCP de Notificado está en https://www.notificado.co/mcp. Un asistente conectado prepara procesos y borradores, consulta entregas y descarga evidencia; nunca envía por su cuenta.

Su asistente de IA sigue la receta del art. 8 por MCP: registra el proceso, sube el auto y prepara el borrador. Los destinatarios y el envío los confirma usted.

Conectar un cliente

Reemplace <token> por el que emitió en Cuenta → API. Nunca lo pegue en un chat ni en un archivo compartido.

Necesita un token de agente, emitido en Cuenta → API. Guía de autenticación

Claude Code

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

Claude Desktop

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

Claude Desktop se conecta a servidores remotos por medio de mcp-remote, que requiere Node.js. Agréguelo a claude_desktop_config.json.

Cursor

{
  "mcpServers": {
    "notificado": {
      "url": "https://www.notificado.co/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

En Cursor, agréguelo a ~/.cursor/mcp.json o al .cursor/mcp.json del proyecto.

Otros clientes: si el suyo puede conectarse a un servidor MCP remoto por HTTP enviando un encabezado Authorization propio, funcionará con la misma dirección y el mismo token; consulte la documentación de su cliente. Si solo admite otros métodos de acceso, todavía no puede conectarse.

Para probar la conexión, pida al asistente que llame whoami({}) y luego docs({}).

Herramientas

Las 23 herramientas que un token puede llegar a ver. Cada token ve solo las de sus alcances, más docs y whoami. Las descripciones están en inglés: son las que lee el asistente.

Herramientas
Herramienta	Alcance	Qué hace
`caseList`	`cases:read`	The caller's firm's cases (procesos), newest first: id, 23-digit radicado, juzgado, ciudad, especialidad, clase de proceso and cliente.
`caseDetail`	`cases:read`	One case of the caller's firm by caseId (from caseList): 23-digit radicado, juzgado and its email, ciudad, especialidad, clase de proceso, cliente, its parties (role demandante \| demandado \| apoderado \| otro, name, idNumber) and `locked` — true once a notification of it left draft, after which the case can no longer be edited.
`createCase`	`cases:write`	Create a case (proceso) in the caller's firm.
`updateCase`	`cases:write`	Correct a case of the caller's firm: pass caseId and only the fields to change (radicado — 23 digits, dashes/spaces allowed —, juzgado, juzgadoEmail, ciudad, especialidad, claseProceso, cliente).
`addParty`	`cases:write`	Add a party to a case of the caller's firm: caseId, role demandante \| demandado \| apoderado \| otro, the name as written in the demanda, and idNumber (cédula or NIT with its check digit) when known.
`requestUpload`	`cases:write`	Step 1 of 2 of an upload: get a signed, single-use PUT grant for ONE file.
`confirmUpload`	`cases:write`	Step 2 of 2 of an upload, after the PUT to requestUpload's url succeeded: pass the same key, kind, filename and contentType.
`notificationList`	`notifications:read`	List the org’s notifications, newest first: id, case, status (draft \| freezing \| frozen \| sending \| sent \| failed), subject, the frozen .eml SHA-256 and UTC timestamps.
`notificationDetail`	`notifications:read`	One notification by id: status, recipients with delivery status and how each address was obtained, attachments with SHA-256, and the evidence timeline (message.frozen, transport.sent, mail.delivery, bounces, downloads, acknowledgements) in chain order with UTC times.
`creditsBalance`	`notifications:read`	Credits balance of the caller's org: `balance` is how many recipients can still be notified (one credit per recipient, consumed on send), and `nextExpiryAt`/`nextExpiryCredits` say when the soonest batch of credits expires (UTC).
`verifyConstancia`	`notifications:read`	Public check of a Notificado constancia: pass the verification code printed under its QR ("code") or the SHA-256 of the PDF file ("pdfSha256").
`memorialReadiness`	`notifications:read`	Whether a memorial can be generated now for one notification in your organization.
`notificationMemorials`	`notifications:read`	The memorials generated for one notification in your organization, newest first: id, createdAt, and the SHA-256 and size of the DOCX and the PDF, plus factsSha256 (the hash of the facts the memorial cites).
`createNotification`	`notifications:write`	Create a DRAFT art.
`updateDraft`	`notifications:write`	Rewrite a DRAFT art.
`attachDocument`	`notifications:write`	Attach an already-uploaded document (documentId) to a DRAFT notification, as kind auto_admisorio \| demanda \| anexo \| subsanacion \| providencia \| otro.
`sendNotification`	`notifications:write`	REQUEST the send of a draft notification — REQUIRES HUMAN CONFIRMATION.
`createMemorial`	`notifications:write`	Generates the memorial (DOCX + PDF draft, in Spanish) that informs the juzgado that personal notification under art.
`downloadEvidence`	`evidence:read`	Returns the bytes (base64, with filename, content type and SHA-256) of the signed constancia PDF (kind "constancia") or the offline-verifiable evidence zip (kind "zip") of one notification in your organization; newest version unless "version" is given.
`downloadMemorial`	`evidence:read`	Returns the bytes (base64, with filename, content type and SHA-256) of one generated memorial in your organization, as "docx" (editable, for the lawyer to review and sign) or "pdf" (with the constancia verification QR).
`listDeadlines`	`deadlines:read`	The caller's firm's deadlines (términos) under Ley 2213 art.
`docs`	Siempre disponible	Las recetas y guías para agentes: el índice, una búsqueda o un documento completo.
`whoami`	Siempre disponible	La firma (orgId), el rol, los alcances y el prefijo del token con que llama el asistente.

Alcances

Alcances
`cases:read`	Consultar procesos Listar los procesos de la firma y ver sus partes.
`cases:write`	Registrar procesos y subir documentos Crear y editar procesos y partes; subir PDF, PNG o JPEG.
`notifications:read`	Seguir las notificaciones El estado de cada destinatario, su línea de tiempo de evidencia, el saldo de créditos y la verificación de constancias.
`notifications:write`	Preparar notificaciones Crear borradores, adjuntar documentos y solicitar el envío, que usted confirma.
`evidence:read`	Descargar la evidencia La constancia firmada y el paquete de evidencia. Cada descarga queda registrada.
`deadlines:read`	Consultar plazos Los términos calculados por destinatario, con el calendario judicial colombiano.

Ningún alcance permite agregar o quitar destinatarios, confirmar un envío, comprar créditos ni entrar a la consola interna.

Confirmar antes de enviar

Un asistente prepara todo, pero nunca envía por su cuenta

El asistente prepara. Registra el proceso, sube los documentos y crea el borrador. No se envía nada ni se usa ningún crédito.
Usted agrega los destinatarios. Agregar un destinatario es su declaración bajo juramento sobre la procedencia de la dirección (art. 8, inc. 2). Solo la hace usted, en el panel.
El asistente solicita el envío. Recibe un enlace de confirmación, válido por 24 horas, y se lo entrega a usted.
Usted confirma. En el panel, con su sesión. Solo entonces el mensaje se congela, se sella en el tiempo y se envía.

Límites

120 lecturas y 20 escrituras por minuto por persona, sumando todos sus tokens. Al superarlo, la respuesta es HTTP 429 con retry-after. Todos los límites

Recetas para agentes

Las mismas instrucciones que el servidor MCP entrega a los asistentes de IA por la herramienta docs. Están en inglés, porque los modelos las siguen mejor así.