前提条件
开始之前,请确保你已具备:- AIsa 账号(console.aisa.one)。你将通过浏览器登录。
- macOS、Linux 或 Windows WSL2 上的终端
1. 安装 Codex
2. 添加 AIsa MCP 服务器
codex mcp login aisa --no-browser 并在其他设备上打开输出的 URL。
使用 API key 代替 OAuth
使用 API key 代替 OAuth
对于无头环境,导出你的 AIsa 密钥并告知 Codex 存储该密钥的环境变量。Codex 会在运行时读取它,因此密钥绝不会写入
config.toml:3. 验证
enabled,且 Auth 列显示 OAuth(或 Bearer token)。启动新的 Codex 会话以加载工具;在 Codex 内部,输入 /mcp 可查看已连接的服务器。
4. 使用 AIsa 能力
search、list_categories、get_details、batch_get_schema 和 batch_quote(对具体调用进行报价而不实际执行)是免费的;use 和 batch_use 会执行调用并按次计费。
尝试:
可选:在 AIsa 模型上运行 Codex
Codex 还可以将 AIsa 用作模型提供商。这需要一个导出为AISA_API_KEY 的 AIsa API key(console.aisa.one/api-keys)。将以下内容添加到 ~/.codex/config.toml:
env_key告知 Codex 哪个环境变量存储了你的密钥。- Codex 仅支持
wire_api = "responses",因此请在模型目录中选择列有POST /v1/responses的模型,例如gpt-5.5、gpt-5.4或gpt-5.3-codex。
快速参考
故障排查
相关
在 Claude 中使用 AIsa
在 Claude 中将 AIsa 添加为自定义连接器。
通过 MCP 连接
其他客户端的 MCP 配置。
模型目录
浏览支持 Responses API 的模型。