---
title: "连接 Hex 插件"
summary: "在 Plugins 中搜索 Hex，连接 Hex app 并完成 OAuth。项目查询和编辑能力取决于当前账号权限。"
category: mcp
level: starter
surfaces: [cli, app]
tags: ["MCP", "Hex", "plugins", "OAuth"]
canonical: /tips/hex-codex-plugin/
---

# 连接 Hex 插件

在 Plugins 中搜索 Hex，连接 Hex app 并完成 OAuth。项目查询和编辑能力取决于当前账号权限。

Hex 可通过 Codex 的公共插件目录连接。Team / Enterprise 才能用；MCP 目前 beta。Explorer 及以上才能搜项目、开 Threads；Editor 及以上才能改 notebook。

ChatGPT Business / Enterprise 工作区里，管理员可能要先在 Workspace settings → Apps 打开 Hex app，用户才能在 Codex 装这个插件。

官方 Codex 专节：

1. Codex 应用打开 Plugins，搜 Hex
2. 在 Hex 插件旁点 Connect
3. 按提示连捆绑的 Hex app，完成 OAuth，多 workspace 时选对工作区

博客和 changelog 还写：Plugins 先装 Data Analytics plugin，再 Connect Hex。以专节的 Plugins 搜 Hex 为准；目录里看到 Data Analytics 再连 Hex 也是同一条产品路径。

0.154 起先在**当前会话**看 `/plugins`；当前会话没有再新开。IDE 扩展没有 `/plugins`，用桌面或 CLI。安装后重新打开会话，用 `@` 点名插件或捆绑技能，或直接问「在 Hex 里查本季 churn」。Explorer 可以搜项目、开 Threads；Editor 才能改 cell，或走插件捆绑的 Hex CLI。CLI 命令请参考 Hex 文档。

自定义域部署请参考 Hex 的客户端支持说明。其他客户端的 MCP 地址为 `https://app.hex.tech/mcp`；切换到 EU、HIPAA 或单租户域名时，保留 `/mcp` 路径。

标成 Sensitive 的数据连接，MCP 不会用。对话里上传的文件也传不进 Hex。Threads 往往要几分钟；MCP 开的 Thread 是独立的，接不上 Hex 应用里已有的 Thread。改 notebook 只动草稿，不会改已发布 app。Admin 角色也不会自动获得每个项目的编辑权。

网页 Cloud 不读取 `~/.codex/config.toml`。Cloud 也走 Plugins 搜 Hex。配置后用 `codex plugin list` 核对已装。

## 来源

- [Hex · MCP server](https://learn.hex.tech/docs/api-integrations/mcp-server)
- [Hex · Hex is now in Codex](https://hex.tech/blog/hex-in-codex/)