MaxCompute MCP 服务使用文档

公网Endpoint

公网 MCP Endpoint 按服务地域开通。当前已开通地域如下：

访问非默认地域的 project 时，在对话里直接说明地域即可，例如：“请查看cn-shanghai 地域 <project> 下有哪些表”。

未列入“服务地域”的 Region ID 表示该地域的公网 MCP Endpoint 尚未开通，请不要直接拼接域名。

VPC Endpoint

无论选择公网还是 VPC Endpoint，未在对话或工具参数中说明地域时，服务默认按当前连接的服务地域处理。如当前连接 cn-hangzhou Endpoint 时，默认地域为 cn-hangzhou；连接 cn-hongkong Endpoint 时，默认地域为 cn-hongkong。

Claude Code

推荐使用命令行添加 HTTP MCP server：

claude mcp add --transport http --scope user maxcompute-mcp \
  https://mcp.cn-hangzhou.maxcompute.aliyun.com/mcp

添加后可以查看连接状态：

claude mcp list
claude mcp login maxcompute-mcp

也可以在 Claude Code 会话内输入 /mcp 查看并触发登录。若只希望在当前项目使用，可以把 --scope user 改成 --scope local 或按团队约定使用 project scope。

Codex

推荐使用命令行添加 Streamable HTTP MCP server：

codex mcp add maxcompute-mcp \
  --url https://mcp.cn-hangzhou.maxcompute.aliyun.com/mcp

添加后查看服务列表并发起登录：

codex mcp list
codex mcp login maxcompute-mcp

如果需要手工配置，在 ~/.codex/config.toml 中加入：

[mcp_servers."maxcompute-mcp"]
url = "https://mcp.cn-hangzhou.maxcompute.aliyun.com/mcp"

Qwen Code

推荐使用命令行添加 HTTP MCP server：

qwen mcp add --transport http --scope user maxcompute-mcp \
  https://mcp.cn-hangzhou.maxcompute.aliyun.com/mcp

如果当前客户端发行版使用了不同命令名，请把上面的 qwen 替换成实际命令名。添加后动 Qwen Code，并在会话内输入 /mcp 查看连接状态和可用工具。也支持通过在 ~/.qwen/settings.json 中手工加入：

{
  "mcpServers": {
    "maxcompute-mcp": {
      "httpUrl": "https://mcp.cn-hangzhou.maxcompute.aliyun.com/mcp"
    }
  }
}

如果文件里已经有其他配置，只需要合并 mcpServers 这一段，不要覆盖已有设置。
除非客户端或企业环境有额外要求，否则不需要手工配置 Authorization header；首次连接会通过 OAuth 流程完成登录。

配置文件方式

config.json示例：

{
  "maxcompute": {
    "maxcompute_endpoint": "https://service.cn-hangzhou.maxcompute.aliyun.com/api",
    "defaultProject": "<DEFAULT_PROJECT_NAME>",
    "namespaceId": "<ALIBABACLOUD_ACCOUNT_UID>",
    "accessKeyId": "<ALIBABA_CLOUD_ACCESS_KEY_ID>",
    "accessKeySecret": "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>"
  }
}

环境变量方式

export MAXCOMPUTE_ENDPOINT="https://service.cn-hangzhou.maxcompute.aliyun.com/api"
export MAXCOMPUTE_DEFAULT_PROJECT="<DEFAULT_PROJECT_NAME>"
export MAXCOMPUTE_NAMESPACE_ID="<ALIBABACLOUD_ACCOUNT_UID>"

# 方式 1：AK/SK
export ALIBABA_CLOUD_ACCESS_KEY_ID="<ALIBABA_CLOUD_ACCESS_KEY_ID>"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="<ALIBABA_CLOUD_ACCESS_KEY_SECRET>"

# 方式 2：STS
export ALIBABA_CLOUD_ACCESS_KEY_ID="<STS_ACCESS_KEY_ID>"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="<STS_ACCESS_KEY_SECRET>"
export ALIBABA_CLOUD_SECURITY_TOKEN="<STS_TOKEN>"

# 方式 3：凭证服务 URI，适合生产或平台托管环境
export ALIBABA_CLOUD_CREDENTIALS_URI="http://localhost:8765/credentials"

凭证解析规则：

• 如果环境变量或配置文件中设置了 AK/SK，MCMCP 会使用这组静态凭证。

• 如果没有设置静态 AK/SK，MCMCP 会使用阿里云 Credentials SDK 默认凭证链。

• 默认凭证链可使用 ALIBABA_CLOUD_CREDENTIALS_URI、本地阿里云配置、ECS RAM

  Role、OIDC 等来源。

• 需要自动刷新 STS 时，优先使用凭证服务 URI、RAM Role 或其他动态凭证来源。

Qoder / Cursor / Claude Code / 通用stdio客户端

• 常见客户端配置位置

  客户端	配置位置
  Cursor	~/.cursor/mcp.json
  Claude Code	项目根目录.mcp.json
  其他MCP客户端	参考对应客户端的MCP server配置说明

• 配置方式

  使用配置文件

  {
    "mcpServers": {
      "alibabacloud-maxcompute-mcp-server": {
        "command": "uv",
        "args": ["--directory", "/absolute/path/to/alibabacloud-maxcompute-mcp-server", "run", "alibabacloud-maxcompute-mcp-server"],
        "env": {"MAXCOMPUTE_CATALOG_CONFIG": "/absolute/path/to/config.json"}
      }
    }
  }

  仅使用环境变量

  {
    "mcpServers": {
      "alibabacloud-maxcompute-mcp-server": {
        "command": "uv",
        "args": ["--directory", "/absolute/path/to/alibabacloud-maxcompute-mcp-server", "run", "alibabacloud-maxcompute-mcp-server"],
        "env": {
          "MAXCOMPUTE_ENDPOINT": "https://service.cn-hangzhou.maxcompute.aliyun.com/api",
          "MAXCOMPUTE_DEFAULT_PROJECT": "<DEFAULT_PROJECT_NAME>",
          "MAXCOMPUTE_NAMESPACE_ID": "<ALIBABACLOUD_ACCOUNT_UID>",
          "ALIBABA_CLOUD_ACCESS_KEY_ID": "<AK_ID>",
          "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "<AK_SECRET>"
        }
      }
    }
  }

DataWorks个人实例 + Claude Code

DataWorks个人实例通常会注入ALIBABA_CLOUD_CREDENTIALS_URI。在这种环境中，config.json只需要包含endpoint、默认项目和可选的namespaceId：

{
  "maxcompute": {
    "maxcompute_endpoint": "https://service.cn-hangzhou.maxcompute.aliyun.com/api",
    "defaultProject": "<DEFAULT_PROJECT_NAME>",
    "namespaceId": "<ALIBABACLOUD_ACCOUNT_UID>"
  }
}

.mcp.json 示例：

{
  "mcpServers": {
    "alibabacloud-maxcompute-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/alibabacloud-maxcompute-mcp-server",
        "run",
        "alibabacloud-maxcompute-mcp-server"
      ],
      "env": {
        "MAXCOMPUTE_CATALOG_CONFIG": "/absolute/path/to/alibabacloud-maxcompute-mcp-server/config.json",
        "ALIBABA_CLOUD_CREDENTIALS_URI": "<VALUE_FROM_DATAWORKS_ENV>"
      }
    }
  }
}

可在实例内通过以下命令查看平台注入的凭证 URI：

echo "$ALIBABA_CLOUD_CREDENTIALS_URI"

Streamable HTTP模式

默认建议使用 stdio。需要远程或多进程接入时，可以启动 HTTP 模式：

uv run alibabacloud-maxcompute-mcp-server \
  --config /absolute/path/to/config.json \
  --transport http \
  --host 127.0.0.1 \
  --port 8000

客户端 MCP 地址填写：

http://127.0.0.1:8000/mcp