agentdraft-mcp — AgentDraft用MCPサーバー

エージェント向けオペレーションAPI（受信トレイ、競合のないカレンダー、監査ツールを備えたAgentDraft）を、MCP対応のAIクライアントが呼び出せるツール群として公開するMCPサーバーです。

エージェントの実行環境がClaude Desktop、Claude Code、Cursor、Cline、OpenAI Agents SDKアプリ、その他のMCPホストであれば、このサーバーを利用できます。このサーバーはagentdraftPython 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}）も受け付けます。これらはダッシュボードで所有者に表示されます。

競合の検出方法

2つのエージェントが同じスロットを競合した場合、正確に1つだけが勝ちます。負けたエージェントには、文字列エラーではなく構造化された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を参照してください。