delega-mcp

Delega용 MCP 서버 — AI 에이전트를 위한 작업 인프라입니다.

모든 MCP 호환 클라이언트(Claude Code, Cursor, Codex 등)를 Delega 인스턴스에 연결하고 자연어를 통해 작업, 프로젝트 및 에이전트를 관리하세요.

설치

npm install -g @delega-dev/mcp

구성

MCP 클라이언트 구성(예: Claude Code claude_code_config.json)에 추가하세요:

{
  "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"
      }
    }
  }
}

환경 변수

호스팅 계층의 경우 URL로 https://api.delega.dev를 사용하세요.

보안 참고 사항

• 로컬이 아닌 DELEGA_API_URL 값은 https://를 사용해야 합니다.

• 에이전트 키는 명령줄 인수가 아닌 환경 변수를 통해 전달되므로 프로세스 목록 유출을 방지합니다.

• MCP 도구 출력은 기본적으로 전체 에이전트 API 키를 가립니다.

• 프로덕션 환경에서 DELEGA_REVEAL_AGENT_KEYS=1을 설정하지 마세요. 이 플래그는 초기 설정용으로만 존재합니다. 프로덕션 환경에서는 프롬프트가 주입된 에이전트가 create_agent 또는 list_agents 도구 출력에서 키를 탈취할 수 있습니다. 키는 생성 시 한 번만 반환되므로, 새 키가 필요한 경우 rotate_agent_key를 사용하세요.

도구

작업 출력 형식

작업을 반환하는 도구(list_tasks, get_task, create_task, update_task, assign_task)는 사용 가능한 경우 할당 메타데이터와 함께 각 작업을 렌더링합니다:

[#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 줄은 기본 필드가 채워져 있을 때만 출력됩니다. 자체 호스팅 Delega는 중첩된 에이전트 객체를 반환하므로 피할당자가 <display_name> (#id)로 렌더링됩니다. 호스팅 api.delega.dev 계층은 원시 에이전트 ID를 반환하므로 #<id>로 렌더링됩니다.

위임 체인의 일부인 작업은 체인 메타데이터도 표시합니다:

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

단일 작업 도구(get_task, create_task, update_task, assign_task, delegate_task, update_task_context)는 전체 context 블롭을 예쁘게 출력하는 상세 렌더링을 사용합니다(2000자에서 잘림). list_tasks는 대신 Context keys: …를 보여주는 간결한 목록 렌더링을 사용합니다.

위임 체인

get_task_chain은 체인 내의 모든 작업에 대해 전체 부모/자식 체인을 반환합니다. 출력은 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)

노드는 깊이순, 그 다음 생성 순서대로 정렬됩니다(API의 응답 순서와 일치).

자체 호스팅 vs 호스팅

자체 호스팅(무료): 직접 Delega 인스턴스를 실행하고 DELEGA_API_URL을 해당 인스턴스로 지정하세요.

호스팅: https://api.delega.dev를 사용하세요 — 월 최대 1,000개 작업까지 무료입니다.

링크

• Delega — 메인 사이트

• GitHub — 소스 코드

• API 문서 — REST API 참조

라이선스

MIT