agentdraft-mcp — MCP-сервер для AgentDraft

Сервер MCP, который предоставляет AgentDraft — операционный API для AI-агентов с входящими, бесконфликтным календарём и инструментами аудита — как набор инструментов, которые может вызывать любой MCP-совместимый AI-клиент.

Используйте это, если ваша среда выполнения агента — Claude Desktop, Claude Code, Cursor, Cline, приложение OpenAI Agents SDK или любой другой MCP-хост. Сервер — это тонкая обёртка вокруг Python SDK agentdraft — та же аутентификация, те же ошибки, та же семантика, что и в REST API и языковых SDK.

Установка

pip install agentdraft-mcp

Требуется Python 3.10+ и действующий ключ агента avs_live_… из панели управления AgentDraft.

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_..."
      }
    }
  }
}

Для локальной разработки с dev-бэкендом также установите AGENTDRAFT_BASE_URL=http://localhost:8080.

Claude Desktop — расширение рабочего стола .mcpb (перетаскивание)

Каждый выпуск также включает пакет расширения рабочего стола .mcpb в GitHub Releases. Перетащите agentdraft-mcp.mcpb в Claude Desktop → Настройки → Расширения и вставьте ваш API-ключ avs_live_… — без редактирования JSON и без pip install.

Инструменты

Все времена — строки ISO 8601 (2026-06-01T14:00:00Z). Все инструменты записи принимают idempotency_key для безопасных повторных попыток. create_hold и commit_booking также принимают необязательные title и invitee ({name, email, notes}), указывающие, для кого предназначен слот — отображается владельцу в панели управления.

Как проявляются конфликты

Когда два агента соревнуются за один и тот же слот, побеждает ровно один. Проигравшие агенты получают структурированный payload 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."
}

Ваш агент должен обработать это и предложить альтернативу, а не повторять попытку для того же слота.

Чем это отличается от SDK AgentDraft

Используйте SDK, когда вы пишете агента. Используйте этот MCP-сервер, когда чужой агентский рантайм (Claude Desktop, Cursor, Cline, универсальный MCP-хост) должен вызывать AgentDraft от имени пользователя без пользовательского кода.

Ссылки

• Спецификация протокола: 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. Не открывайте публичный issue для отчёта о безопасности.

Участие в разработке

См. CONTRIBUTING.md. ryabinski-labs/agentdraft-mcp — опубликованное зеркало каталога в частном репозитории приложения AgentDraft — issues и pull requests читаются там и попадают обратно через следующую синхронизацию релизов.

Лицензия

MIT — см. LICENSE.