agentdraft-mcp — AgentDraft용 MCP 서버

MCP 서버로서 인박스, 충돌 없는 캘린더, 감사 도구를 갖춘 AI 에이전트용 ops API인 AgentDraft를 MCP를 인식하는 모든 AI 클라이언트가 호출할 수 있는 도구 집합으로 노출합니다.

에이전트 런타임이 Claude Desktop, Claude Code, Cursor, Cline, OpenAI Agents SDK 앱 또는 기타 MCP 호스트라면 이 서버를 사용하세요. 이 서버는 agentdraft Python SDK의 얇은 래퍼로, REST API 및 언어 SDK와 동일한 인증, 동일한 오류, 동일한 의미 체계를 제공합니다.

설치

pip install agentdraft-mcp

Python 3.10+와 AgentDraft 대시보드에서 발급된 유효한 avs_live_… 에이전트 키가 필요합니다.

Related MCP server: Labradoc MCP Server

업그레이드

pip install -U agentdraft-mcp

릴리스 노트: https://agentdraft.io/changelog

MCP 클라이언트 구성

agentdraft-mcp는 PyPI에 있으므로 설치만 하면 아래 JSON 구성이 별도의 다운로드 없이 모든 MCP 호스트에서 바로 작동합니다.

Claude Desktop / Claude Code — JSON 구성 (권장)

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 Windows/Linux의 해당 파일을 편집하세요:

{
  "mcpServers": {
    "agentdraft": {
      "command": "agentdraft-mcp",
      "env": {
        "AGENTDRAFT_API_KEY": "avs_live_..."
      }
    }
  }
}

Cursor / Cline / 일반 stdio 호스트

{
  "mcpServers": {
    "agentdraft": {
      "command": "python",
      "args": ["-m", "agentdraft_mcp"],
      "env": {
        "AGENTDRAFT_API_KEY": "avs_live_..."
      }
    }
  }
}

개발 백엔드를 대상으로 한 로컬 개발 시 AGENTDRAFT_BASE_URL=http://localhost:8080도 설정하세요.

Claude Desktop — .mcpb 데스크톱 확장 프로그램 (끌어서 놓기)

각 릴리스에는 GitHub Releases에 .mcpb 데스크톱 확장 번들도 포함되어 있습니다. agentdraft-mcp.mcpb를 Claude Desktop → 설정 → 확장 프로그램으로 끌어다 놓고 avs_live_… API 키를 붙여넣으면 됩니다 — JSON 편집도 pip install도 필요 없습니다.

도구

모든 시간은 ISO 8601 문자열(2026-06-01T14:00:00Z)입니다. 모든 쓰기 도구는 안전한 재시도를 위해 idempotency_key를 허용합니다. create_hold와 commit_booking은 또한 슬롯이 누구를 위한 것인지 기록하는 선택적 title 및 invitee({name, email, notes})를 허용하며, 이 정보는 대시보드에서 소유자에게 표시됩니다.

충돌이 표시되는 방식

두 에이전트가 동일한 슬롯을 차지하기 위해 경쟁하면 정확히 하나만 승리합니다. 패배한 에이전트는 문자열 오류가 아닌 구조화된 outranked 페이로드를 받습니다:

{
  "error": "outranked",
  "winning_booking_id": "bkg_…",
  "winning_agent_id": "agt_…",
  "winning_agent_priority": 1,
  "your_priority": 3,
  "message": "Your booking was outranked. Read winning_agent_id and propose an alternate slot rather than retrying."
}

에이전트는 이 페이로드를 기준으로 분기하여 동일한 슬롯을 재시도하지 말고 대안을 제안해야 합니다.

AgentDraft SDK와의 차이점

에이전트를 직접 작성하는 경우에는 SDK를 사용하세요. 다른 사람의 에이전트 런타임(Claude Desktop, Cursor, Cline, 일반 MCP 호스트)이 커스텀 코드 없이 사용자를 대신하여 AgentDraft를 호출해야 하는 경우에는 이 MCP 서버를 사용하세요.

링크

• 프로토콜 사양: https://agentdraft.io/spec

• API 문서: https://agentdraft.io/docs

• 변경 로그: https://agentdraft.io/changelog

• Python SDK: agentdraft

• TypeScript SDK: agentdraft

• 소스: https://github.com/ryabinski-labs/agentdraft-mcp

• 이슈: https://github.com/ryabinski-labs/agentdraft-mcp/issues

보안

취약점을 발견하셨나요? SECURITY.md를 참조하세요. 보안 신고는 공개 이슈로 열지 마십시오.

기여

CONTRIBUTING.md를 참조하세요. ryabinski-labs/agentdraft-mcp는 AgentDraft의 비공개 애플리케이션 저장소에 있는 디렉터리의 공개 미러입니다 — 이슈와 풀 리퀘스트는 해당 저장소에서 확인되며 다음 릴리스 동기화를 통해 다시 반영됩니다.

라이선스

MIT — LICENSE를 참조하세요.