Skip to Content
AI设计助理MCP Server 配置指引

Calicat MCP Server 配置指引

基础配置文件

mcp.json 配置文件示例:

{
  "mcpServers": {
    "calicat": {
      "type": "http",
      "url": "https://www.calicat.cn/mcp"
    }
  }
}

OpenAI Codex

OpenAI codex 配置

将以下配置添加到 OpenAI codex 配置文件中（$CODEX_HOME/config.toml）

$CODEX_HOME/config.toml 配置文件中的 CODEX_HOME 环境变量默认值为 ~/.codex。更多信息参考 OpenAI codex MCP 配置指引 

[mcp_servers.calicat]
url = "https://www.calicat.cn/mcp"

并确保打开 experimental_use_rmcp_client = true 以便正常通过 OAuth 授权。

experimental_use_rmcp_client = true

Calicat MCP 授权

完成配置后，在终端运行 codex 会显示提示需要登录 Calicat:

codex 需要登录

退出 codex（Ctrl+C）在终端输入:

codex mcp login calicat

codex 会自动跳转到浏览器并打开 Calicat 登录或授权页面。登录 Calicat 账号并完成授权后，自动跳转回 codex 终端。

登录成功后，再次运行 codex 即可开始使用。

Claude Code

在终端中运行以下命令添加 Calicat MCP Server

claude mcp add --transport http calicat --scope user https://www.calicat.cn/mcp

或修改 .claude.json 文件添加以下内容:

{
  "mcpServers": {
    "calicat": {
      "type": "http",
      "url": "https://www.calicat.cn/mcp"
    }
  }
}

访问 Connect Claude Code to tools via MCP  查看官方 MCP 添加指引。

Calicat MCP 授权

完成配置后，在终端运行 claude 会显示提示需要登录 Calicat:

claude 需要登录

跟随指引输入 /mcp 进入 MCP 列表，选择 Calicat 并回车，会自动跳转至浏览器并打开登录或授权页面，完成授权后，自动跳转回 claude 终端完成授权。

使用方法见 MCP Server 使用方法

Github Copilot Visual Studio Code

添加 Calicat MCP Server

在 VS Code 中，使用快捷键 ⌘ + Shift + P(Windows: Ctrl + Shift + P), 输入 MCP Add Server 点击进入添加

copilot MCP Add Server

选择 HTTP 类型 copilot MCP add server http

输入 Calicat MCP Server 地址 https://www.calicat.cn/mcp  copilot MCP add server url

输入 Calicat MCP Server 名称 calicat copilot MCP add server name

选择 MCP Server 安装位置，全局表示所有项目中都可使用，工作区表示只有在当前工作区中添加。 copilot MCP add server location

确定安装位置后，vscode 会出现弹窗，询问是否允许进行身份认证,请点击允许。随后 vscode 可能会出现选项，询问使用哪个账号访问 Calicat，此时选择“登录到其他账户”，在新的「是否打开外部网站」弹窗中选择打开 copilot MCP add server auth select

点击登录，会自动跳转至浏览器并打开登录或授权页面。 copilot MCP add server auth login

授权完成后回到 vscode 此时可查看到自动打开的 MCP 配置 JSON 文件中显示 calicat MCP Server 正在运行，5 个工具，即配置完成。之后即可在 Copilot chat 侧边栏中通过 Agent 模式使用 MCP。 copilot MCP add server auth complete

Cursor

点击下方链接在 cursor 中添加 Calicat MCP Server

Install MCP Server

其他客户端

对于目前不支持 Streamable HTTP 的 MCP 客户端，可以通过 mcp-remote 模块实现。在相应客户端中添加以下 MCP 配置:

{
  "mcpServers": {
    "calicat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://www.calicat.cn/mcp"
      ]
    }
  }
}

例如通义灵码: lingma_mcp_config

常见问题

添加失败

Calicat 基于 MCP 协议构建，是支持 OAuth 授权的 Streamable HTTP remote Server。请确保你使用的 MCP 客户端支持最新协议版本的 Remote Server。（比如 Cline 目前不支持 Streamable HTTP MCP Server） 对于不支持 Streamable HTTP 的客户端，可以通过 mcp-remote 模块实现。 见上方的其他客户端配置指引。

如果使用 mcp-remote 添加失败，请检查输入的日志，确保 node 版本符合 mcp-remote 的要求 (大于 20)。

vscode 中设置失败，请先检查 vs code 版本号，需要 1.106 及以上版本。然后删除 VS code mcp 配置，保存，然后重启 vs code 重试（一定要重启）。

mcp-remote 方式配置后不自动跳转浏览器打开授权

请按照以下步骤尝试:

  1. 删除 mcp Calicat 配置
  2. 完全退出 IDE
  3. 在终端执行:
  • macOS 执行: rm -rf ~/.mcp-auth
  • Windows 执行: Remove-Item -Recurse -Force "$HOME\.mcp-auth"
  1. 重新打开 IDE，重新添加 Calicat MCP Server

请求超出上下文 API Error: 400

如果页面设计较为复杂，图层较多，调用 get_design_data 工具可能会出现较多的 Token，导致请求超出上下文。 建议使用上下文窗口更大的模型，如: Kimi K2、GLM 4.6、doubao seed 1.6 等，最好是 200k 以上的上下文窗口。

github copilot 未弹出授权弹窗，或提示授权失败

快捷键 ⌘ + Shift + P 或 Windows Ctrl + Shift + P 输入 MCP open user configuration(或 mcp open workspace folder configuration)。 在打开的 mcp.json 文件中，删除 Calicat MCP Server 配置。然后完全重启 VS Code。 之后参照配置流程重新设置添加 Calicat MCP Server 即可。

提示缺少 access_token 和 token_type 字段

这种情况也是客户端没有自动跳转浏览器打开授权链接导致的，推荐使用 mcp-remote 配置。

如果还不行，尝试删除 mcp 配置文件，重启客户端，再次重新添加配置看是否能成功。

如果还不行，在输出中，查看日志，手动在浏览器打开授权链接完成授权。

mcp-remote_output

为什么 MCP 可以访问我的文件，而且我加了密码也能访问？

配置 MCP 的过程中，会跳转浏览器要求你登录并授权 MCP 客户端。Calicat 会在你授权后，给 MCP 客户端生成 Token。MCP 客户端携带 Token 调用我们开放的工具，会验证这个 Token 是否有对某个文件的权限，有权限就可以访问，没权限就访问不了。

简单理解就是，相当于你在 MCP 客户端登录了你的 Calicat 账号，你的账号有权限的文件，MCP 客户端就有权限。

你可以在账号设置里取消对某个 MCP 客户端的授权， Token 就会失效，之后 MCP 客户端就无权访问任何文件了。

如需更多配置方法指引，请加入用户群咨询。

企业微信群 扫码加入用户群

MCP Server 使用方法画布操作