客户端集成指南¶

本指南说明了如何将 MiniMax-MCP 服务器集成到常见的兼容客户端中。

Claude Desktop 集成¶

按照以下步骤在 Claude Desktop 中配置 MiniMax-MCP 服务器：

打开 Claude Desktop 设置：导航至 Claude > Settings > Developer > Edit Config > claude_desktop_config.json。
在 mcpServers 对象中添加一个新的条目，命名为 MiniMax（或其他您喜欢的名称）：

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "在此处插入你的 API 密钥",
        "MINIMAX_MCP_BASE_PATH": "本地输出目录路径，例如 /Users/your_username/Desktop/mcp_output",
        "MINIMAX_API_HOST": "你的区域对应的 API 主机地址",
        "MINIMAX_API_RESOURCE_MODE": "url" 
      }
    }
    // ... 其他可能已有的 MCP 服务器配置
  }
}

配置详解： - command: 指定启动服务器的可执行文件。这里使用 uvx，它是 uv 包管理器提供的工具，用于运行 Python 包。 - args: 传递给 command 的参数。minimax-mcp 是要运行的包名，-y 可能是一个确认或默认配置选项。 - env: 一个包含环境变量的对象，用于配置服务器行为。 - MINIMAX_API_KEY: 必须替换为您的有效 MiniMax API 密钥。 - MINIMAX_MCP_BASE_PATH: (可选) 如果您希望将生成的文件保存在本地，请设置此项并确保目录存在。如果省略或 MINIMAX_API_RESOURCE_MODE 为 url，则不需要此项。 - MINIMAX_API_HOST: 必须设置为与您的 API 密钥匹配的区域主机地址（全球或中国大陆）。请参考快速开始。 - MINIMAX_API_RESOURCE_MODE: (可选) 设置为 url (默认) 或 local。

区域匹配: 再次确认 MINIMAX_API_KEY 和 MINIMAX_API_HOST 属于同一区域。
Windows 用户: 如果您在 Windows 上使用 Claude Desktop，可能需要先启用开发者模式。在左上角的汉堡菜单中选择 Help > Enable Developer Mode。

配置完成后，重启 Claude Desktop 或等待其自动重新加载配置。之后，您应该能在 Claude 的工具调用界面看到 MiniMax 提供的工具。

来源：README.md

Cursor 集成¶

在 Cursor 编辑器中配置 MiniMax-MCP 服务器的步骤类似：

打开 Cursor 设置：导航至 Cursor -> Preferences -> Cursor Settings -> MCP。
点击 Add new global MCP Server。
填入与 Claude Desktop 配置类似的详细信息：
- Name: MiniMax (或其他您喜欢的名称)
- Command: uvx
- Args: minimax-mcp, -y
- Environment Variables: 添加 MINIMAX_API_KEY, MINIMAX_API_HOST, MINIMAX_MCP_BASE_PATH (可选), MINIMAX_API_RESOURCE_MODE (可选) 等环境变量及其对应的值。

确保环境变量的值正确无误，特别是 API 密钥和主机地址的区域匹配。

来源：README.md

其他客户端集成¶

对于其他支持 Model Context Protocol (MCP) 的客户端（例如 Windsurf, OpenAI Agents 等），集成方法通常遵循相同的模式：

找到客户端配置 MCP 服务器的部分。
指定启动服务器的命令：uvx minimax-mcp -y。
配置必要的环境变量：MINIMAX_API_KEY, MINIMAX_API_HOST，以及可选的 MINIMAX_MCP_BASE_PATH, MINIMAX_API_RESOURCE_MODE。

请参考具体客户端的官方文档以获取详细的配置步骤。

来源：README.md