---
title: "安装 Apify Codex 插件"
summary: "安装 apify@apify-plugins 后自动登记远程 MCP，通过 OAuth 登录。无头工作流使用 APIFY_TOKEN。"
category: skills
level: starter
surfaces: [cli, app, ide]
tags: ["plugins", "Apify", "Skills", "MCP"]
canonical: /tips/apify-codex-plugin/
---

# 安装 Apify Codex 插件

安装 apify@apify-plugins 后自动登记远程 MCP，通过 OAuth 登录。无头工作流使用 APIFY_TOKEN。

Apify 给 Codex CLI 和桌面都有专节。插件**会**替 Codex 登记 MCP，这点和 n8n 技能仓相反。官方安装页只写了 `/plugins` 点选；清单 `.agents/plugins/marketplace.json` 的 name 是 apify-plugins，插件 name 是 apify，CLI 等价是：

```bash
codex plugin marketplace add apify/apify-codex-plugin
codex plugin add apify@apify-plugins
```

`codex plugin list` 应看到 `apify@apify-plugins` 为 installed, enabled。桌面在 Plugins → Personal 的 Apify Plugin 下装。IDE 扩展没有 `/plugins`，用 CLI 装完新开会话。

插件 `.mcp.json` 把远程写成 `https://mcp.apify.com/?client=codex+plugin`，表名是 `apify`。**不要**再 `codex mcp add apify --url https://mcp.apify.com` 叠一张。也不要跑 `apify mcp install codex`——那会再写一张用户层 `apify` 表。

装插件或第一次连 MCP 时走 OAuth。浏览器没弹，把终端里的 URL 粘进浏览器。官方 CLI 页写搜索 Store 可以不登录；仓库 README 写默认入口所有工具都要账号。跑 Actor、读数据集必须登录。无头 / SSH 才在**启动 Codex 的那个进程**里准备 `APIFY_TOKEN`，不要写进 `http_headers`，也

只要 MCP、不要技能，才手写：

```bash
codex mcp add apify --url https://mcp.apify.com
codex mcp login apify
```

OAuth 与 Bearer token 请选择一种认证方式。API key 那张用 `bearer_token_env_var = "APIFY_TOKEN"`，不要再 `mcp login`。默认 URL **没有** `/mcp` 后缀。token 通过凭据配置提供。不要抄即将弃用的 SSE，也不要抄本机 `npx @apify/actors-mcp-server` 当插件主路径。

`apify-actor-development`、`apify-actorization`、`apify-ultimate-scraper` 还要本机 Apify CLI：

```bash
npm install -g apify-cli
apify login
```

`apify-sdk-integration` 和无头工作流才读进程里的 `APIFY_TOKEN`。长 Actor 可能超过单次工具等待，拆小再跑。Actor 计费是 Apify 套餐，不是 Codex 额度。能改仓库的技能保持工具批准。

网页 Cloud 不读取 `~/.codex/config.toml`。配置后重新打开会话。用 `codex mcp get apify` 看传输是 streamable_http，url 带 `mcp.apify.com`。

## 来源

- [Apify · Codex CLI](https://docs.apify.com/integrations/codex-cli)
- [Apify · Codex desktop](https://docs.apify.com/integrations/codex-app)
- [apify/apify-codex-plugin](https://github.com/apify/apify-codex-plugin)