前提条件
开始之前,请确保你已具备:- 一个 AIsa 账号(console.aisa.one),通过浏览器登录。
- 已安装 Cursor
1. 添加 AIsa MCP 服务器
1
打开 MCPs
在 Cursor 侧边栏中选择 Customize,然后选择 MCPs。
2
添加服务器
点击 New MCP Server,Cursor 会打开
~/.cursor/mcp.json。添加 AIsa 配置并保存文件:.cursor/mcp.json。
2. 登录
在 Customize → MCPs 中,aisa 会显示 Needs authentication。点击 Authenticate,在浏览器中登录 AIsa 并批准访问,无需复制 key。连接就绪后,aisa 会出现在 Connected 下,并显示已启用的工具数量。使用 API key 代替 OAuth
使用 API key 代替 OAuth
将 key 作为 Bearer 请求头传入。Cursor 会从启动它的环境中解析
${env:AISA_API_KEY},从而避免将 key 写入配置文件。在 ~/.zshrc 或 ~/.bashrc 中添加 export AISA_API_KEY="sk-aisa-...",然后退出 Cursor 并通过新终端运行 cursor . 重新打开(从 Dock 启动的应用程序可能无法继承 Shell 环境变量)。未设置该变量时将发送空 token:Cursor CLI (cursor-agent)
Cursor CLI (cursor-agent)
cursor-agent 会读取相同的 mcp.json。批准该服务器,然后登录:cursor-agent mcp list-tools aisa 确认工具可用。3. 使用 AIsa 能力
Cursor 的智能体现已获得 AIsa 工具。search、list_categories、get_details、batch_get_schema 以及 batch_quote(对具体调用报价而不实际运行)均免费;use 和 batch_use 会执行调用并按次计费。
尝试输入:
可选:使用 AIsa 模型
Cursor 还支持兼容 OpenAI 的 API key,因此聊天和智能体请求可以直接使用 AIsa 目录中的模型。这需要 AIsa API key(console.aisa.one/api-keys)。1
配置端点
在 Cursor Settings(齿轮图标)→ Models → API Keys 中,将你的 AIsa key(
sk-aisa-...)粘贴到 OpenAI API Key 中并开启 Use OpenAI API Key。然后开启 Override OpenAI Base URL 并输入 https://api.aisa.one/v1。2
添加模型
在同一页面中,点击 Add Custom Model 并输入准确的 AIsa 模型 ID,例如
gpt-5.5、kimi-k2.5、claude-opus-4-8 或 deepseek-v4.1-flash。启用它们,然后在模型选择器中选取一个。完整列表见模型目录。自定义 API key 适用于 Cursor 的聊天和智能体请求。Cursor 原生功能(例如 Tab 自动补全)将继续使用 Cursor 自己的模型和订阅。
快速参考
故障排查
相关
在 Claude 中使用 AIsa
在 Claude 中将 AIsa 添加为自定义连接器。
通过 MCP 连接
面向其他客户端的 MCP 配置指南。
模型目录
在添加到 Cursor 之前浏览模型 ID。