delega-mcp

Servidor MCP para Delega — infraestructura de tareas para agentes de IA.

Conecta cualquier cliente compatible con MCP (Claude Code, Cursor, Codex, etc.) a tu instancia de Delega y gestiona tareas, proyectos y agentes mediante lenguaje natural.

Instalación

npm install -g @delega-dev/mcp

Configuración

Añádelo a la configuración de tu cliente MCP (por ejemplo, claude_code_config.json de Claude Code):

{
  "mcpServers": {
    "delega": {
      "command": "npx",
      "args": ["-y", "@delega-dev/mcp"],
      "env": {
        "DELEGA_API_URL": "http://127.0.0.1:18890",
        "DELEGA_AGENT_KEY": "dlg_your_agent_key_here"
      }
    }
  }
}

Variables de entorno

Para el nivel alojado (hosted), utiliza https://api.delega.dev como URL.

Notas de seguridad

• Los valores de DELEGA_API_URL que no sean locales deben usar https://.

• Las claves de agente se pasan a través de variables de entorno en lugar de argumentos de línea de comandos, lo que evita fugas en la lista de procesos.

• La salida de la herramienta MCP redacta las claves de API completas del agente de forma predeterminada.

• No establezcas DELEGA_REVEAL_AGENT_KEYS=1 en producción. Esta bandera existe solo para la configuración inicial. En producción, un agente con inyección de prompts podría exfiltrar claves de la salida de la herramienta create_agent o list_agents. Las claves se devuelven una vez en el momento de la creación; utiliza rotate_agent_key si necesitas una nueva.

Herramientas

Formato de salida de tarea

Las herramientas que devuelven tareas (list_tasks, get_task, create_task, update_task, assign_task) muestran cada tarea con metadatos de asignación cuando están disponibles:

[#42] Ship the release
  Description: Cut RC, tag, push to npm
  Project: Delega
  Labels: release
  Priority: 3
  Due: 2026-04-20
  Assigned to: Coordinator (#7)
  Created by: planner (#3)
  Completed: no

Las líneas Assigned to / Created by / Completed by se emiten solo cuando el campo subyacente está poblado. Delega autohospedado devuelve un objeto de agente anidado para que el asignado se muestre como <display_name> (#id); el nivel alojado api.delega.dev devuelve el ID de agente sin procesar, por lo que se muestra como #<id>.

Las tareas que forman parte de una cadena de delegación también muestran los metadatos de la cadena:

[#def] Draft intro
  Status: delegated
  Assigned to: Drafter (#3)
  Created by: Coordinator (#7)
  Delegation: depth 1, parent #abc, root #abc
  Delegated by: Coordinator (#7)
  Completed: no
  Context keys: step, findings (2)

Las herramientas de tarea única (get_task, create_task, update_task, assign_task, delegate_task, update_task_context) utilizan una representación detallada que formatea el blob de context completo (truncado a 2000 caracteres). list_tasks utiliza la representación de lista concisa que muestra Context keys: … en su lugar.

Cadenas de delegación

get_task_chain devuelve la cadena completa de padre/hijo para cualquier tarea en la cadena. La salida está sangrada por delegation_depth:

Delegation chain (root #abc, depth 2, 2/4 complete):
  [#abc] Write report (depth 0, delegated)
    [#def] Draft intro (depth 1, completed)
    [#jkl] Draft conclusion (depth 1, pending)
      [#ghi] Research sources (depth 2, completed)

Los nodos se ordenan por profundidad y luego por orden de creación (coincidiendo con el orden de respuesta de la API).

Autohospedado vs Alojado

Autohospedado (gratis): Ejecuta tu propia instancia de Delega, apunta DELEGA_API_URL hacia ella.

Alojado: Usa https://api.delega.dev — gratis hasta 1,000 tareas/mes.

Enlaces

• Delega — Sitio principal

• GitHub — Código fuente

• Documentación de la API — Referencia de la API REST

Licencia

MIT