---
title: "安装与配置 JFrog Codex 插件"
summary: "安装 jfrog@codex-plugin，将插件 .mcp.json 中的地址改为自己的 JFrog 实例，再通过 OAuth 登录。"
category: skills
level: starter
surfaces: [cli, app, ide]
tags: ["plugins", "JFrog", "Skills", "MCP"]
canonical: /tips/jfrog-codex-plugin/
---

# 安装与配置 JFrog Codex 插件

安装 jfrog@codex-plugin，将插件 .mcp.json 中的地址改为自己的 JFrog 实例，再通过 OAuth 登录。

JFrog 给 Codex 有正式插件仓，把平台技能、包审查和捆绑 MCP 打在一起。清单 `.agents/plugins/marketplace.json` 的 name 是 `codex-plugin`，插件 name 是 `jfrog`，所以是 `jfrog@codex-plugin`。在普通终端执行安装命令：

```bash
codex plugin marketplace add jfrog/codex-plugin
codex plugin add jfrog@codex-plugin
codex plugin list
```

`codex plugin list` 应看到 `jfrog@codex-plugin` 一行是 installed, enabled，并给出安装路径。0.154 起先看**当前会话**；当前会话没有再新开。桌面改 marketplace 仍要重启应用。不要用 `npx skills add jfrog/jfrog-skills` 当 Codex 插件安装器。

插件已经带 MCP，表名就是 `jfrog`。捆绑文件是安装路径下的 `.mcp.json`，占位主机要改成你们的 JPD，路径是 `/mcp`。示例：

```json
{
  "jfrog": {
    "url": "https://acme.jfrog.io/mcp"
  }
}
```

平台管理员必须先在实例上打开 JFrog MCP Server。改完主机再登录，这是 OAuth，**不要**把 access token 写进配置：

```bash
codex mcp login jfrog
codex mcp list
```

然后新开会话。技能还要本机 `jf` CLI：先 `jf login`，或从没配过就 `jf config add`。Agent Guard（可选）还要 Node.js 18、npx，以及带 AI Catalog 的订阅；JFrog CLI 2.105.0 起才能从 CLI 配置自动解析凭据。

MCP 连不上时，官方要你跑 `jfrog-init`，必要时再改 `.mcp.json` 主机、`mcp login jfrog`、重启。**不要**以为 `export JFROG_PLATFORM_URL` 会替 Codex 登记 MCP；Codex 读的是插件 `.mcp.json` 里的 url。占位符没改，只重装插件不够。

相关服务与配置：

- 集成文档给 Codex 抄的是 `mcpServers` JSON。Codex 用户层是 `[mcp_servers.jfrog]`。只要 MCP、不要插件时才手写：

```bash
codex mcp add jfrog --url https://acme.jfrog.io/mcp
codex mcp login jfrog
```

使用插件时无需重复添加同名连接。

- `jf agent plugins install jfrog --harness codex` 是 Artifactory 的 agentplugins 仓，装到 `~/.agents/plugins/local/`。那不是 GitHub marketplace 这条。
- 密钥不要写进 chat。Agent Guard 要密钥时会给你一条在终端跑的命令。

网页 Cloud 不读取这份本机插件和 `~/.codex/config.toml`。配置后重新打开会话。用 `codex mcp get jfrog` 看 url 是 `https://acme.jfrog.io/mcp`。

## 来源

- [jfrog/codex-plugin](https://github.com/jfrog/codex-plugin)
- [JFrog · Add MCP server to a client](https://docs.jfrog.com/integrations/docs/add-the-jfrog-mcp-server-to-an-mcp-client)
- [JFrog · OpenAI Codex](https://jfrog.com/integrations/openai-codex/)