返回服务目录

OpenCode — 通过 MCP 连接 AI 智能体

将 OpenCode 连接到 Deskgram 2 MCP：本地地址、Bearer 令牌、配置示例与只读工具检查。

OpenCode — 通过 MCP 连接 AI 智能体
AI 与 MCPAI 智能体

OpenCode 是支持 MCP 服务器的 AI 智能体。它可以连接 Deskgram 2 的本地 MCP，读取获准使用的工具、模块参数架构和任务状态。OpenCode 使用的语言模型需要单独配置。

准备 Deskgram

启动 Deskgram，打开 MCP 设置，设置令牌、启用监听并保存。默认地址为 http://127.0.0.1:8765/mcp。如果修改过端口，请在智能体配置中使用新值。

首次检查保留只读模式，仅开放所需工具。实际支持的能力应以已安装版本返回的 MCP 工具目录为准。

配置 OpenCode

将以下服务器加入配置。启动智能体之前，将环境变量 DESKGRAM_MCP_TOKEN 设置为 Deskgram 中保存的同一个令牌。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "deskgram": {
      "type": "remote",
      "url": "http://127.0.0.1:8765/mcp",
      "headers": { "Authorization": "Bearer {env:DESKGRAM_MCP_TOKEN}" },
      "oauth": false,
      "enabled": true
    }
  }
}

如果已有 MCP 服务器，请把 deskgram 加入原有 mcp 对象，不要覆盖其他配置。oauth: false 表示使用 Bearer 令牌，而非自动尝试 OAuth。

127.0.0.1 指向运行 OpenCode 的环境。在容器或远程服务器中，它不会自动指向你电脑上的 Deskgram。

不启动任务的检查

运行 opencode mcp list，再让智能体调用 deskgram_health 和 deskgram_list_modules。使用 deskgram_get_module_schema 查看参数，例如 profile_setup。

读取架构不会启动模块。创建任务前，请核对账号、参数、MCP 权限和执行模式。写入操作可能需要额外权限；工具出现在目录中，不代表当前已获准执行。

OpenCode 与 OpenRouter

OpenCode 负责对话和 MCP 工具调用；OpenRouter 提供模型。如果智能体选择 OpenRouter，需要单独设置其密钥与计费。Deskgram 中保存的模型密钥不会自动配置 OpenCode，也不会授予 MCP 访问权限。

故障排查与文档

无法连接时，检查 Deskgram 和监听是否运行，端口及 /mcp 是否一致。认证失败时，检查环境变量和 Bearer 请求头；修改环境后重启 OpenCode。浏览器 GET 返回405不能验证完整 MCP 交换，应使用 MCP 客户端。

参考 OpenCode MCP 文档、Deskgram MCP 和 OpenRouter 配置。

条款与说明

模型费用取决于所选服务商. 按钮直接访问官方网站，不含推荐代码。本指南不代表与服务开发者存在官方合作关系。

设置核对日期：2026年10月20日。

访问网站