convez.ai
MCP ServerAutomaçãoIntermediário
delega-dev

Delega MCP Server

delega-dev/delega-mcp

Camada de handoff de tarefas para agentes IA com delegação multi-agente

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta clientes compatíveis (Claude, Cursor) à plataforma Delega para gerenciamento de tarefas e delegação entre agentes IA. Permite criar, atualizar, atribuir e rastrear tarefas através de linguagem natural, com suporte a cadeias de delegação e contexto persistente.

Instalação

$npx convez-ai delega-dev/delega-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
1
Acompanhando
0
Saúde
62%
Último commit
há 1 semana
Versão
v1.19.1
Issues abertas
1
Contribuidores
4

Casos de uso

  • Coordenar múltiplos agentes IA em fluxos de trabalho complexos
  • Gerenciar filas de tarefas com semântica de trabalho compartilhado
  • Rastrear delegações e cadeias de contexto entre agentes
  • Integrar gestão de projetos e tarefas diretamente em clientes MCP

Veredito

Ferramenta sólida para arquiteturas multi-agente, com segurança de credenciais bem pensada e API abrangente de delegação. Ideal para quem precisa coordenar agentes IA em produção sem ficar preso a um ecossistema único.

README

A tradução para o português deste README ainda está na fila.

delega-mcp

MCP server for Delega — the task handoff layer for AI agents.

Connect any MCP-compatible client (Claude Code, Cursor, Codex, etc.) to Delega and manage tasks, projects, and agents through natural language.

Install

npm install -g @delega-dev/mcp

Configure

Add to your MCP client config (e.g. Claude Code claude_code_config.json):

{
  "mcpServers": {
    "delega": {
      "command": "npx",
      "args": ["-y", "@delega-dev/mcp"],
      "env": {
        "DELEGA_API_URL": "https://api.delega.dev",
        "DELEGA_AGENT_KEY": "dlg_your_agent_key_here"
      }
    }
  }
}

Environment Variables

VariableDefaultDescription
DELEGA_API_URLhttps://api.delega.devDelega API endpoint. Defaults to the hosted API; custom /api-style endpoints (e.g. http://localhost:18890) are an advanced override.
DELEGA_AGENT_KEY(none)Agent API key for authenticated requests
DELEGA_REVEAL_AGENT_KEYS0⚠️ Development only. Set to 1 to print full API keys in tool output. Never enable in production: a prompt-injected agent could exfiltrate keys from create_agent or list_agents responses.

Use https://api.delega.dev as the URL.

Security Notes

  • Non-local DELEGA_API_URL values must use https://.
  • Agent keys are passed through environment variables rather than command-line arguments, which avoids process-list leakage.
  • MCP tool output redacts full agent API keys by default.
  • Do not set DELEGA_REVEAL_AGENT_KEYS=1 in production. This flag exists for initial setup only. In production, a prompt-injected agent could exfiltrate keys from create_agent or list_agents tool output. Keys are returned once at creation time; use rotate_agent_key if you need a new one.

Tools

ToolDescription
list_tasksList tasks, filter by project, label, due date, completion
get_taskGet full task details including subtasks and task links
link_taskAttach a branch, commit, PR, or URL link to a task
list_task_linksList branch, commit, PR, and URL links attached to a task
create_taskCreate a new task
update_taskUpdate task fields (incl. assigned_to_agent_id)
assign_taskAssign a task to an agent (or pass null to unassign)
delegate_taskDelegate a task: create a child task linked to a parent (parent status flips to delegated). Use this for multi-agent handoffs — assign_task does not create a delegation chain.
get_task_chainReturn the full delegation chain for a task (root + descendants, sorted by depth)
update_task_contextMerge keys into a task's persistent context blob (deep merge, not replace), recording provenance source
get_task_contextRead a task's persistent context blob, optionally with per-key provenance
get_context_historyRead the append-only provenance ledger for a task's context
find_duplicate_tasksCheck whether proposed task content is similar to existing open tasks (TF-IDF + cosine similarity). Call before create_task to avoid redundant work.
get_usageReturn quota + rate-limit info. Hosted API only (api.delega.dev); custom endpoints receive a clear error.
claim_taskClaim the next available task from the queue for exclusive processing (work-queue semantics). Lease-based: default 300s, configurable 30-3600. Returns the task or reports an empty queue. Hosted API only.
heartbeat_taskExtend the lease on a claimed task. Call periodically while working so the claim isn't reclaimed. Hosted API only.
release_taskRelease a claimed task back to the queue without completing it. Hosted API only.
set_task_stateReport working, waiting_input, or errored on a claimed task without extending the lease. Hosted API only.
complete_taskMark a task as completed
delete_taskDelete a task permanently
add_commentAdd a comment to a task
list_projectsList all projects
get_statsGet task statistics
list_agentsList registered agents
register_agentRegister a new agent (returns API key), optionally with a role preset
set_agent_roleSet an agent's role: worker, coordinator, or admin (admin key required)
delete_agentDelete an agent (refused if agent has active tasks)
list_webhooksList all webhooks (admin only)
create_webhookCreate a webhook for event notifications, including task.linked (admin only)
delete_webhookDelete a webhook by ID (admin only)

Task output format

Task-returning tools (list_tasks, get_task, create_task, update_task, assign_task) render each task with assignment metadata when available:

[#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

Assigned to / Created by / Completed by lines are emitted only when the underlying field is populated. Custom /api-style endpoints return a nested agent object so the assignee renders as <display_name> (#id); the hosted api.delega.dev API returns the raw agent ID so it renders as #<id>.

Tasks that are part of a delegation chain also surface the chain metadata:

[#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)

Single-task tools (get_task, create_task, update_task, assign_task, delegate_task, update_task_context) use a detail render that pretty-prints the full context blob (truncated at 2000 chars). list_tasks uses the concise list render which shows Context keys: … instead.

get_task also shows attached task links when present:

  Links:
    branch: delega-dev/delega-api phase-3-github — https://github.com/delega-dev/delega-api/tree/phase-3-github
    pr: delega-dev/delega-api 42 — https://github.com/delega-dev/delega-api/pull/42

Delegation chains

get_task_chain returns the full parent/child chain for any task in the chain. Output is indented by 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)

Nodes are sorted by depth then creation order (matching the API's response ordering).

Hosted API

Delega is a hosted service. Point DELEGA_API_URL at https://api.delega.dev — free up to 1,000 tasks/month.

Links

License

MIT

Ver o original no GitHub

Bom para

Relacionados