---
title: "安装与更新 GEOly Codex 插件"
summary: "从 geoly-ai/codex-plugins 安装 geoly-mcp@geoly，通过 OAuth 连接。更新时先刷新插件源，再重新安装插件并打开新会话。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "GEOly", "Skills", "MCP"]
canonical: /tips/geoly-codex-plugin/
---

# 安装与更新 GEOly Codex 插件

从 geoly-ai/codex-plugins 安装 geoly-mcp@geoly，通过 OAuth 连接。更新时先刷新插件源，再重新安装插件并打开新会话。

GEOly 文档包含 Codex 配置说明，写在 MCP 文档。这是官方插件仓，把托管 MCP 和 `geoly-mcp` 技能打在一起。源是 `geoly-ai/codex-plugins`。

```bash
codex plugin marketplace add geoly-ai/codex-plugins
codex plugin add geoly-mcp@geoly
```

清单 `.agents/plugins/marketplace.json` 的 name 是 geoly，插件 name 是 geoly-mcp，所以是 `geoly-mcp@geoly`。CLI 动词是 `plugin add`，不是 `install`。会话斜杠才是 `/plugin install geoly-mcp@geoly`。

安装后应打开 GEOly OAuth 授权页面。若未打开，运行：

```bash
codex mcp login geoly
```

桌面先在终端跑完 `marketplace add` 和 `plugin add`，**彻底退出** Codex 应用再开。桌面若 OAuth 后工具仍不出现，官方建议改走 CLI。0.154 起先看**当前会话**的 `/plugins`，应能看到 `geoly-mcp@geoly`。没有再新开。IDE 扩展没有 `/plugins`。

更新插件时，先刷新插件源，再更新已安装的副本：

```bash
codex plugin marketplace upgrade geoly
codex plugin add geoly-mcp@geoly
```

然后彻底退出并新开会话。授权过期再接 OAuth。卸插件：

```bash
codex plugin remove geoly-mcp
codex plugin marketplace remove geoly
```

插件 MCP 表名是小写 `geoly`。远程 URL 是 `https://app.geoly.ai/api/mcp`。地址以 `/api/mcp` 结尾。插件 `.mcp.json` 还带 `oauth_resource` 指向同一地址，以及静态头 `X-Client-Name` / `X-Client-Version`。插件会管理这些配置，无需重复添加同名服务。

多组织授权默认只读；写操作需要指定一个组织。远程 URL 可加查询参数 `org_id`，把组织 id 接在等号后面。请填入实际组织 ID。

此插件推荐使用 OAuth。无头 / CI 走 GEOly CLI 或只读 token，不是这套插件。密钥通过环境变量等凭据配置提供。

技能随插件一起安装和更新。

MCP Credits 不是 AI Credits。付费公域情报才扣 MCP Credits；自有品牌监测、额度查询和免费工具不扣。额度用 `get_quota` 查。写工具要人确认；全组织授权没有写工具。

网页 Cloud 不读取本机 marketplace。配置后用 `codex plugin list` 核对 `geoly-mcp@geoly`；`codex mcp get geoly` 看 url 是 `https://app.geoly.ai/api/mcp`。

## 来源

- [GEOly · MCP User Guide](https://www.geoly.ai/docs/mcp)
- [geoly-ai/codex-plugins](https://github.com/geoly-ai/codex-plugins)
- [geoly-ai/GEOly-MCP](https://github.com/geoly-ai/GEOly-MCP)