通过 MCP 控制 Deskgram 2

通过 MCP 控制 Deskgram 2

通过本地 MCP 地址将 AI 智能体连接到正在运行的 Deskgram 2。读取账号和模块参数结构，检查任务参数，创建任务并获取结果。

模块设置

打开设置 → MCP，设置令牌、启用监听器并保存。默认地址为 http://127.0.0.1:8765/mcp，请使用 Authorization: Bearer <token>。OpenCode 的 mcp.deskgram 配置需要 type: remote、url、headers 和 enabled: true。令牌来自设置，不要使用 deskgram_get_mcp_instructions 返回的占位符。客户端必须能访问同一台电脑；云端智能体自己的 localhost 无法连接你的程序。保持 Deskgram 运行。当前有 17 个工具：deskgram_health、deskgram_echo、deskgram_get_mcp_instructions、deskgram_list_modules、deskgram_get_module_schema、deskgram_get_profile_setup_schema、deskgram_list_accounts、deskgram_list_account_folders、deskgram_get_account、deskgram_get_account_limits、deskgram_list_tasks、deskgram_get_task、deskgram_create_task、deskgram_stop_task、deskgram_validate_batch、deskgram_create_batch、deskgram_validate_account。通过 tools/list 查询实际参数结构。详细契约支持 profile_setup.validate_account、search_channels_groups 和 collect_audience，其他允许的模块可能使用 generic_adapter。设置 allowed_modules、账号和输入对象上限。create_task 不支持 scheduler；直接移动、归档、更新账号和重置限额的旧工具已禁用。

运行前检查

先检查 health、echo 和 tools/list。使用 POST JSON-RPC；认证后的 GET /mcp 返回 405，没有独立 SSE 流，客户端兼容性需要单独验证。默认开启 dry-run，只检查参数结构、操作和上限，不检查 Telegram 会话、代理或群访问权限。实际创建任务需要 allow_dangerous_tools=true 和 dry_run=false，创建不支持 execute=false。保存 task_id，通过 deskgram_get_task 和 include_result=true 读取结果；任务完成不代表每个账号都成功。断线后先查看任务列表再重试，因为创建没有 idempotency-key。deskgram_stop_task 不需要 dangerous-mode。已完成隔离环境下的本地 HTTP 和契约测试，不声称已验证所有客户端或真实账号执行。

相关任务和指南

选择相关任务或查看详细指南。俄语指南的链接已注明语言。

更多 Deskgram 2 模块