Skip to main content
Glama
resign13
by resign13
npm run desktop:watch

npm run dev 仅启动前端开发服务器,不等同于完整桌面 MCP 服务。

第一步:配置本地 MCP 与工作区任务

  1. 打开桌面端的网关管理页面,设置宿主 MCP。

  2. 确认监听端口,例如 28766;后续所有示例均以此端口说明。

  3. 在认证配置中启用 OAuth,准备界面提供的 Client ID、Client Secret 和授权口令。

  4. 保存配置并启动 MCP。

  5. 在“工作区任务”中新建任务,选择实际项目目录。

  6. 复制任务 ID,供网页对话绑定使用。 在网关任务界面创建的任务会自动加入可绑定列表。删除任务只移除配置,不会删除对应本地目录。首次验证建议准备两个不同目录的任务。 如果沿用旧版独立工作区配置,需要确认已启用网关且目标任务在可访问列表内。

Related MCP server: Coding Tools MCP

第二步:配置 Cloudflare 公网入口

选择哪种模式

模式

域名要求

地址特点

适用场景

Named Tunnel

自有域名已在 Cloudflare 激活

固定 HTTPS 地址

长期使用,推荐

Quick Tunnel

不需要自有域名

临时地址,重启可能变化

首次体验、临时测试

两种模式都不需要额外购买 VPS,也不要求家庭网络具有公网 IP。本地电脑、桌面 MCP 服务和隧道需要保持运行;电脑关机或休眠时远程调用会中断。

方案 A:Named Tunnel,长期使用

1. 接入域名

  1. 在 Cloudflare 添加域名。

  2. 在域名注册商处,将 Nameserver 修改为 Cloudflare 为该域名分配的两个地址。

  3. 等待 Cloudflare 域名状态显示 Active。

  4. 为 MCP 选择独立子域名,例如 mcp.example.com。 已有网站可以继续使用其他主机名。为 MCP 创建新子域名即可,无需修改网站原有记录。

2. 创建隧道并取得 Token

  1. 进入 Cloudflare Zero Trust 控制台。

  2. 在网络相关菜单中找到 Tunnels;不同界面可能显示在 Networks、Connectors 等入口下。

  3. 创建隧道,连接器类型选择 cloudflared。

  4. 为隧道命名,例如 gpt-tools-mcp。

  5. 在安装连接器页面找到运行命令,复制其中的 Tunnel Token。 命令一般包含类似 --token <TOKEN> 或 service install <TOKEN> 的内容。桌面 Token 字段仅填 Token 本身,不粘贴整条命令。由桌面端管理隧道时,按桌面流程启动即可。

3. 填写桌面端隧道配置

配置项

填写内容

隧道类型

Cloudflare

模式

Named Tunnel

Tunnel Token

上一步取得的 Token

公网 URL

https://mcp.example.com

网络代理

按本机网络情况选择;启用时使用全局代理配置

点击“保存配置”,再启动隧道。回到 Cloudflare,确认连接器在线后继续设置公开路由。

公网 URL 填根地址,不附加 /mcp。应用会为 MCP 和 OAuth 等接口分别生成完整地址。保存后配置和 Token 由应用持久化,下次使用同一应用配置无需重复填写。

4. 配置公开主机名

在该隧道的 Public Hostname 或 Published application routes 页面添加:

字段

示例

Subdomain

mcp

Domain

example.com

Path

留空

Service Type

HTTP

Service URL

127.0.0.1:28766

保存路由后,最终 MCP 地址为:

https://mcp.example.com/mcp

本地端口应与桌面 MCP 的实际监听端口一致。Path 留空,让 MCP、OAuth 授权和元数据路由都到达同一个本地服务。外部使用 HTTPS,本地服务使用 HTTP。

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to develop within a local project workspace by reading and modifying files, running commands and tests, checking Git state, and persisting progress as history sessions that can be restored in later conversations.
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI clients to safely read, search, understand, and edit local project code and files, with Git inspection, code indexing, and controlled command execution within permissioned workspaces.
    4 npm
    6
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables ChatGPT to work on a local project by reading and editing files, running shell commands, keeping terminals and desktop sessions open, and splitting work across durable workers whose context persists between tasks. Long-running work can be steered mid-flight, tracked with Goal, and carried into fresh chats via Compact & Resume.
    MIT