Servidores MCP

Notificado tiene tres servidores MCP, uno por tipo de cuenta: las firmas, los afiliados y el equipo de Notificado. Cada uno tiene su dirección y sus propios tokens.

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.

Tres servidores

Conecte su asistente al servidor de su tipo de cuenta. Un token de un servidor no abre los otros dos.

Los servidores MCP de Notificado
Para quién	Dirección	De dónde sale el acceso
Firmas: propietarios y abogados	`https://www.notificado.co/mcp`	Inicio de sesión OAuth, o un token de Cuenta → API.
Afiliados aprobados del programa de referidos	`https://www.notificado.co/mcp/afiliados`	Un token de afiliado, creado en /afiliados.
Equipo de Notificado	`https://www.notificado.co/mcp/admin`	Solo personal. Tokens en la consola interna.

Un token del personal que llama al servidor de las firmas recibe una negativa que indica el suyo, /mcp/admin.

Firmas: conectar un cliente

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.

Recomendado: Claude Code con inicio de sesión, sin token. La primera vez que lo use, Claude Code abre el navegador; inicie sesión como propietario o abogado de la firma y autorice la conexión. Sigue activa mientras la use y se renueva sola; se cierra después de 60 días sin uso.

Claude Code: con inicio de sesión (recomendado)

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

Para algo más duradero, como integración continua o una herramienta que corre sola, use un token personal emitido en Cuenta → API. Usted elige la vigencia: 30, 60, 90, 180 o 365 días, una fecha exacta o sin vencimiento. Un token sin vencimiento sigue activo hasta que lo revoque. Guía de autenticación

Con inicio de sesión no hay nada que copiar. Con un token, reemplace <token> por el que emitió en Cuenta → API y nunca lo pegue en un chat ni en un archivo compartido.

Claude Code: con un token personal

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 admite la autorización OAuth de MCP, basta la dirección, como en Claude Code. Si no, debe poder enviar un encabezado Authorization propio con el token; consulte la documentación de su cliente.

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

Cómo trabaja el asistente

Todo token ve las mismas 5 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.

Las herramientas de todo token
Herramienta	Qué hace
`list_resources`	El catálogo: cada recurso con sus acciones y una línea de parámetros. Muestra solo lo que el token puede usar.
`describe_resource`	Los esquemas completos de entrada de uno o varios recursos.
`manage_resource`	Ejecuta una acción: el recurso, la acción y sus parámetros. Con las mismas reglas que la acción tiene en el panel y en la API.
`docs`	Las recetas y guías para agentes: el índice, una búsqueda o un documento completo.
`whoami`	La firma (orgId), el rol, los alcances, el prefijo y el vencimiento del token con que llama el asistente.

El orden es siempre el mismo: list_resources para saber qué hay, describe_resource para los parámetros exactos y manage_resource para ejecutar. Así se busca un proceso por radicado:

Buscar un proceso por radicado

list_resources({})
describe_resource({ resources: ["cases"] })
manage_resource({
  resource: "cases",
  action: "caseList",
  params: { orgId: "<orgId>", q: "05001310300320260012300" },
})

Al conectarse, el servidor le indica al asistente que llame primero whoami, que responde el orgId que piden las acciones, y luego list_resources.

Recursos

Los 14 recursos que un token de cliente puede llegar a ver. Cada token ve solo los que abren sus alcances; list_resources da las acciones de cada uno, descritas en inglés, que es lo que lee el asistente.

Recursos
Recurso	Qué contiene
`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: ese lo hace el abogado en cada envío.
`uploads`	Subir un PDF, PNG o JPEG: una URL firmada para el PUT y la confirmación, que verifica el tipo y registra el SHA-256. Los bytes nunca viajan en una llamada. Los archivos enlazados (demasiado grandes para adjuntar, enviados como enlace de descarga) usan el mismo recurso: consultar el acceso, subir, ver el estado del análisis y descartar.
`imports`	Importar un CSV de procesos y borradores: subir el archivo, ver en qué quedó cada fila, bajar las filas con errores y seguir los envíos por lote. La importación nunca crea destinatarios ni envíos.
`notifications`	Las notificaciones y sus borradores: listar, leer la línea de tiempo de cada destinatario, redactar, adjuntar, revisar una dirección, descartar, ver rebotes, exportar a Excel, el saldo de créditos y la verificación de una constancia.
`sends`	Pedir un envío y seguir los pedidos. sendNotification nunca envía: espera la confirmación de un abogado en el panel, dentro de 24 horas.
`memorials`	El memorial para el juzgado: si ya se puede generar, el borrador en DOCX y PDF, y su descarga. Nada se radica: un abogado lo revisa, lo firma y lo radica.
`court-outcomes`	Lo que decidió el juzgado sobre una notificación (aceptada, rechazada, nulidad): consultarlo y registrarlo. No es evidencia.
`templates`	Las plantillas de mensaje de la firma, con campos combinados. 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 (surtida, inicio y fin del término) 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, con su descarga, que queda registrada. Un agente no compra créditos.
`activity`	Quién hizo qué en la firma, lo más reciente primero: borradores, juramentos, envíos, confirmaciones, descargas, miembros y tokens.
`webhooks`	Los webhooks salientes de la firma: registrar, cambiar, probar, rotar el secreto, eliminar y leer el registro de entregas. Solo con tokens del propietario.

Alcances

Alcances
Alcance	Qué permite
`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.
`billing:read`	Créditos y facturas Consultar el extracto de créditos y las facturas electrónicas de la firma, y descargar una factura.
`activity:read`	Actividad de la firma Consultar quién redactó, juró, envió, confirmó o descargó, y los cambios de miembros y tokens.
`webhooks:manage`	Webhooks de la firma Registrar, probar y administrar los endpoints que reciben, firmado, cada envío, entrega, rebote, acuse y constancia.

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.

El pedido de envío

manage_resource({
  resource: "sends",
  action: "sendNotification",
  params: { orgId: "<orgId>", notificationId: "<id>", confirm: true },
})
// → { status: "awaiting_confirmation", confirmUrl, expiresAt }

Un abogado de la firma ve los pedidos pendientes en el panel y confirma cada uno con su sesión. Lo que nadie confirma en 24 horas vence sin enviar nada ni usar créditos.

La misma acción en la API HTTP: sendNotification

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

Afiliados

Un afiliado aprobado conecta su 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.

El token se crea en /afiliados, sección Acceso para agentes (MCP y API), con un nombre y sus alcances; se muestra una sola vez. Allí mismo se revoca.

Sin inicio de sesión OAuth: siempre con un token. El asistente ve las mismas cinco herramientas que en el servidor de las firmas, y las acciones de la cuenta están en tres recursos: account, statements, invoice-filing. Sus recetas están en docs://affiliate/.

Claude Code: con un token de afiliado

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

Claude Desktop

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

Los alcances de un token de afiliado
Alcance	Qué permite
`affiliate:read`	Leer la cuenta. Leer el resumen, el enlace de referido, el estado de la verificación, los estados de cuenta y los movimientos, y descargar el documento soporte. Cada descarga queda registrada.
`affiliate:invoices`	Presentar facturas. Subir la factura electrónica de un estado de cuenta y presentarla. La factura espera la confirmación del afiliado.

Una factura que presenta un agente no se toma todavía: queda en /afiliados, en Facturas enviadas por un agente, hasta que el afiliado la confirma o la rechaza. Ningún alcance permite confirmar.

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 crear o revocar tokens.

Lo mismo, por HTTP, en https://www.notificado.co/v1/afiliados, con el mismo token.

Equipo de Notificado

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í. Toda escritura de un agente del personal espera la confirmación de una persona del equipo.

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í.

Leer una receta

docs({ uri: "docs://recipes/send-a-batch" })

Preferencias

Idioma

Apariencia