Codex CLI

要從 Codex CLI 查詢 Framedash 遙測資料，請將 Framedash MCP Server 註冊到 Codex。你無需外掛即可獲得 Claude Code 外掛所提供的相同 MCP 工具。

使用 codex mcp add 註冊

將伺服器註冊為 stdio MCP 伺服器：

codex mcp add framedash \
  --env FRAMEDASH_API_KEY=fd_xxx \
  --env FRAMEDASH_PROJECT_ID=your-project-uuid \
  -- npx -y @framedash/mcp-server

--env 每個變數指定一次。FRAMEDASH_PROJECT_ID 為選填。

透過 config.toml 註冊

codex mcp add 會將伺服器定義儲存到 Codex 設定中。若要手動註冊，請在 ~/.codex/config.toml 中新增以下項目：

[mcp_servers.framedash]
command = "npx"
args = ["-y", "@framedash/mcp-server"]

[mcp_servers.framedash.env]
FRAMEDASH_API_KEY = "fd_xxx"
FRAMEDASH_PROJECT_ID = "your-project-uuid"

請將 API 金鑰作為環境變數傳入，切勿貼到聊天中。

環境變數

變數	必填	說明
FRAMEDASH_API_KEY	是	具有所用 MCP 工具所需 scope 的 API 金鑰。
FRAMEDASH_PROJECT_ID	否	預設專案 UUID。
FRAMEDASH_BASE_URL	否	API 基礎 URL（預設：https://app.framedash.dev）。

scope 詳情請見 MCP Server。

透過 AGENTS.md 指示代理

Codex 會讀取儲存庫的 AGENTS.md。將 Framedash 文件、CLI 和 MCP Server 的參照放入 AGENTS.md，代理便能了解如何埋點與查詢。可複製的程式碼片段請見 AGENTS.md 程式碼片段。

Claude 技能的非外掛等價物

Claude Code 外掛打包了用於 SQL 查詢和 CI 配方的技能。Codex 不會獲得這些技能，但相同的內容可在以下頁面查閱：

• 事件結構：可查詢的欄位與驗證規則。
• 疑難排解：事件未到達時的排查步驟。
• MCP Server：工具與資源參考。

列數上限

MCP query 工具將結果限制為 1000 列。如需更大的結果集，請使用支援最多 10000 列的 REST /v1/query 端點。