MCP 集成指南

前提条件

在开始使用 ImgMCP 平台之前，请确保您已准备好以下内容：

一个 ImgMCP 账户: 您需要在平台注册。如果还没有账户，请前往管理平台完成注册。
一个 API 密钥: 为了验证您的请求，需要一个 API 密钥。注册并登录后，您可以在管理平台的 API 密钥页面找到您的默认 API 密钥。

请妥善保管您的 API 密钥，确保其安全。

核心配置

MCP 端点 URL:
```
https://api.imgmcp.com/mcp
```
认证方式 (Authentication Method): ImgMCP 使用 API 密钥进行认证。您需要在 HTTP 请求的 Authorization 头中按以下格式提供密钥：
```
Authorization: Bearer <您的 API 密钥>
```
提示: 如果您使用的 MCP Host 配置 Bearer <密钥> 格式不方便，可以尝试直接使用您的 API 密钥作为 Authorization 头的值。但推荐尽可能使用包含 Bearer 的标准格式。

MCP Host 配置指南

Cherry Studio

Cherry Studio 支持 Streamable HTTP MCP 协议。

打开 Cherry Studio，导航至 设置 (Settings) - MCP 服务器 (MCP Servers)。
点击 添加服务器 (Add Server)，然后选择 从JSON导入 (Import from JSON)。
粘贴以下 JSON 内容：

{
    "name": "ImgMCP",
    "type": "streamableHttp",
    "description": "Connecting Models to Your Creativity.",
    "provider": "ImgMCP",
    "providerUrl": "https://imgmcp.com",
    "logoUrl": "https://cdn.imgmcp.com/imgmcp-favicon.png",
    "baseUrl": "https://api.imgmcp.com/mcp"
}

导入后，点击列表中新创建的 "ImgMCP" 服务。
在 请求头 (Request Headers) 部分添加您的 API 密钥：

Authorization=Bearer <您的 API 密钥>

(请务必将 <您的 API 密钥> 替换为您的真实密钥)

点击保存。

Chatwise

ChatWise 支持直接配置 Streamable HTTP MCP 服务。

打开 Chatwise，导航至 Settings - 工具
点击左下角加号添加工具，选择 可流式传输的 HTTP 请求
输入 URL 为 https://api.imgmcp.com/mcp
输入 HTTP 请求头 为 Authorization=Bearer <你的 API Key>
点击 查看工具，如果正确配置，下方会显示工具列表

Claude Desktop

Claude Desktop 暂时还不支持 Streamable HTTP MCP 协议，需要使用 mcp-remote 工具代理请求。

打开 Claude Desktop，导航至 Settings - Developer
点击 Edit Config 按钮，会打开 claude_desktop_config.json 文件
粘贴以下 JSON 内容并保存文件：

{
  "mcpServers": {
    "ImgMCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.imgmcp.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <你的 API Key>"
      }
    }
  },
  "globalShortcut": ""
}

重启 Claude Desktop 后，即可看到 ImgMCP 被加载。
注意，Claude Desktop 默认不展示 MCP 工具返回的图片链接，需点击跳转后显示。

Cursor

Cursor 暂时还不支持 Streamable HTTP MCP 协议，需要使用 mcp-remote 工具代理请求。

打开 Cursor，导航至 Settings - MCP Tools
点击 New MCP Server，会打开 mcp.json 文件
粘贴以下 JSON 内容并保存文件：

{
  "mcpServers": {
    "ImgMCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.imgmcp.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <你的 API Key>"
      }
    }
  }
}

回到 MCP Tools 页面，如果配置正确，即可看到 ImgMCP 被加载。
注意，Cursor 默认不展示 MCP 工具返回的图片链接，需点击跳转后显示。

验证连接

配置完成后，您需要验证 MCP Host 是否能通过新配置与 ImgMCP 平台成功通信。

基础检查: 在您的 MCP Host 中，检查 MCP 工具列表。如果能看到来自 ImgMCP 的工具正常显示，说明基础连接已建立。
功能验证:
1. 在 Host 中选择一个合适的 LLM，并启用 ImgMCP 工具集。
2. 发起一个简单的交互。例如，可以尝试提问：“查询历史任务”，或者让它执行一个需要通过 ImgMCP 后端获取信息的操作（比如查询可用的模型列表）。
3. 如果 LLM 能够正确响应，并返回了来自 ImgMCP 的信息（例如历史任务列表或模型列表），则表明配置成功，您可以开始正常使用了。

后续步骤:

您已成功配置 MCP Host。现在可以通过它来探索 ImgMCP 提供的各种 AI 模型交互能力了。请参阅后续章节，了解更详细的使用示例。

MCP 总览

上一页

关于模型

下一页

目录

MCP Host 配置指南