Skip to main content

Codex Configuration Guide

Codex can install the CloudBase plugin through the plugin marketplace to get both MCP tool connectivity and AI Skills in one go, or connect manually via MCP configuration. The plugin marketplace approach is recommended.

For example:

  • "Create a user table" — AI automatically creates a database collection
  • "Deploy this function" — AI automatically uploads and configures cloud functions
  • "Deploy frontend to CDN" — AI automatically uploads files and configures hosting

No need to switch to the cloud console — all operations can be done in Codex using natural language.

Prerequisites​

Before configuring, ensure the following conditions are met:

Node.js environment and CloudBase environment ready

Node.js Environment: Make sure Node.js v18.15.0 or later is installed:

node --version

If not installed, download from the Node.js website.

CloudBase Environment: See the guide Create a CloudBase Environment. New users can try it for free.

The plugin marketplace installs both MCP tools and AI Skills simultaneously — one installation provides full capabilities.

通过 Codex App 的图形界面添加 CloudBase 插件市场并安装插件。

1
打开插件目录

在 Codex App 中点击右上角的 + 按钮。

2
添加插件市场

在菜单中选择 添加插件市场。

3
填写市场信息

在弹窗中填写以下信息：

来源：TencentCloudBase/CloudBase-MCP
Git 引用：main
稀疏路径：留空
4
点击添加市场

添加成功后，在插件列表中找到 Tencent CloudBase 市场。

5
安装 CloudBase 插件

点击 cloudbase 插件旁的安装按钮。

6
新开线程验证

安装后建议新开一个 Codex 线程，让插件、技能和 MCP 工具完整加载。

Method 2: Connect via MCP Configuration​

If you only need MCP tool connectivity, you can also configure manually:

Client

Configure your AI tool to connect with CloudBase capabilities. Supports local and hosted connection. See connection modes.

Step 1: Install / Configure CloudBase

前置步骤：

bash
npm i @cloudbase/cloudbase-mcp -g

根据运行系统在终端中运行指令：

MacOS, Linux, WSL:

bash
codex mcp add cloudbase --env INTEGRATION_IDE=CodeX -- cloudbase-mcp

Windows Powershell:

bash
codex mcp add cloudbase --env INTEGRATION_IDE=CodeX -- cmd /c cloudbase-mcp
Need help?View OpenAI Codex CLI docs

Step 2: Chat with AI

Enter the following in your AI chat in order:

prompt
Install CloudBase Skills: run npx skills add tencentcloudbase/cloudbase-skills -y
Use CloudBase Skills: 更新 CloudBase 云函数的环境变量

FAQ​

Q: MCP connection failed? A: Check if the command executed correctly, restart Codex, and verify your network connection.

Q: Showing 0 tools? A: See the FAQ.

More questions: Full FAQ

相关资源