API 与 MCP 集成指南

想为你的 AI Agent 装上一个懂艺术的超能力？

想象一下，你的 AI Agent 能够瞬间将想法转化为专业图形 — 海报、信息图、名片、社交媒体视觉 — 全部在几秒钟内完成，就在你的对话流程中。

这正是 Mew Design MCP 工具所做的。

我们为什么要做这个工具

OpenClaw 和 AI Agent 正在迅速成为我们与软件交互的标准界面。但问题是：今天的大多数 Agent 都是纯文本的。它们可以出色地写作、分析和推理 — 但它们无法向你展示视觉上引人注目的内容。

有了 Mew Design 的 MCP 集成，你的 Agent 获得了以下能力：

✨ 将文本转化为视觉 — 将会议笔记转化为演示幻灯片，将数据转化为信息图，将想法转化为海报 🎨 精准设计 — 将 Logo、二维码和照片精确放置在它们应该在的位置 ⚡ 以 Agent 的速度工作 — 在几秒钟内生成专业设计，而不是几小时 🔄 自然迭代 — 通过对话优化设计，就像与人类设计师合作一样

无论你使用的是 OpenClaw、OpenCode、Claude Code、GeminiCli、Antigravvity、Codex、Cursor，还是 Cherry Studio，本指南都将向你展示如何在 AI 工作流中解锁视觉创造力。

什么是 MCP？

模型上下文协议 (MCP) 是一个开放标准，使 AI Agent 能够安全地连接外部工具和服务。可以把它想象成一种通用语言，让你的 Agent 能够与专业工具对话 — 比如用于图形的 Mew Design，用于数据的数据库，或用于实时信息的 API。

通过 MCP，你的 AI Agent 可以：

直接从对话中生成专业设计
访问外部数据源和服务
跨多个工具自动化复杂工作流
将其能力扩展到纯文本生成之外

步骤 1. 生成 API 密钥

API 密钥允许外部应用程序代表您访问 Mew Design。

进入账户设置
- 访问账户设置
- 滚动到”API 密钥”部分
创建新的 API 密钥
- 点击”创建 API 密钥”
- 给它一个描述性名称（例如”Claude Desktop”、“Cline 集成”）
- 立即复制密钥 — 它不会再次显示
管理您的密钥
- 查看每个密钥的使用统计
- 撤销不再需要的密钥
- 跟踪每个密钥的积分消耗

步骤 2. 设置 MCP 服务器

Mew Design 提供云端 MCP 服务，您可以通过 HTTP/SSE (Server-Sent Events) 直接连接，无需本地安装任何环境。

适用于 OpenClaw / OpenCode / Antigravvity / Codex

这些工具是强大的 AI Agent 平台，原生支持 MCP 集成。

进入设置
- 打开工具设置
- 导航到 MCP Servers 配置
添加新的 MCP 服务器
- 选择连接类型为 HTTP 或 SSE (Remote)
- URL: https://api.mew.design/mcp
- Headers:
  - Key: X-Api-Key
  - Value: 你的-API-密钥
保存并连接
- 保存配置，平台将自动连接并验证。

适用于 Claude Code / GeminiCli

这些是强大的命令行界面 (CLI) 工具，通过配置文件管理 MCP。

编辑配置
- 找到工具的配置文件 (通常位于 ~/.claude/config.json 或 ~/.gemini/config.json)

添加服务器配置

{
  "mcpServers": {
    "mew-design": {
      "url": "https://api.mew.design/mcp",
      "headers": {
        "X-Api-Key": "你的-API-密钥"
      }
    }
  }
}

重启工具
- 重新运行 CLI 命令即可生效。

适用于 Cursor

Cursor 是一个 AI 驱动的代码编辑器，内置 MCP 支持。

打开 Cursor 设置
- 进入 Settings → Features → MCP
添加 HTTP 服务器
- 点击 “Add New MCP Server”
- 选择类型: SSE (或 HTTP)
- URL: https://api.mew.design/mcp
配置 API 密钥
- 如果 Cursor 界面暂不支持配置 Headers，请等待后续版本更新支持。

适用于 Cherry Studio

Cherry Studio 是一个全能的 AI 工作台，支持多种模型和工具。

打开设置
- 点击左下角的设置图标
- 选择 Tools (工具) 或 Plugins (插件) 选项卡
添加 MCP 工具
- 点击 ”+” 添加新工具
- 选择 MCP 类型
- URL: https://api.mew.design/mcp
- Headers: {"X-Api-Key": "你的-API-密钥"}
保存
- 保存并启用工具

大多数兼容 MCP 的工具都支持 HTTP/SSE 连接。只需在配置中填写以下信息：

服务器 URL: https://api.mew.design/mcp
请求头 (Headers): X-Api-Key: 你的-API-密钥

步骤 3. 使用设计工具

连接后，您的 AI 助手可以使用自然语言生成设计：

示例提示词

基础设计生成：

为 Fleurish Co. 花店创建母亲节促销海报，
包含 20% 折扣优惠，网站 https://fleurish.com，
电话 057 xxxx xx，地址：纽约州纽约市列克星敦大道 100xx 号

带风格参考：

生成一张极简主义商务名片，使用现代排版。
使用 [图片 URL] 作为配色参考。

带素材：

为我们的新产品发布设计一张 Instagram 帖子。
包含我们的 Logo [logo URL] 和产品照片 [product URL]。
使用鲜艳的颜色和粗体排版。

可用参数

MCP 工具支持以下参数：

参数	类型	描述	默认值
`userQuery`	string	完整的设计需求（必填）	-
`designConcept`	string	视觉风格方向（可选）	-
`referenceImage`	object	带 URL 和标签的风格参考（可选）	-
`width`	number	设计宽度（像素，1-5000）	1080
`height`	number	设计高度（-1 为自适应，100-5000）	-1
`assetImages`	array	要集成的素材（Logo、二维码）	-

步骤 4. 最佳实践

积分管理

监控使用情况：在账户设置中检查 API 密钥使用情况
设置限制：每次设计生成消耗 4 积分
优化提示词：清晰、具体的提示词可减少迭代次数

提示词编写技巧

具体明确：包含所有文本内容、布局要求和风格偏好
提供上下文：说明设计用途（海报、传单、社交媒体）
使用真实 URL：始终为素材和参考提供有效的图片 URL
逐步迭代：从简单开始，然后通过后续提示词进行优化

安全最佳实践

定期轮换密钥：定期生成新密钥
使用独立密钥：不同应用使用不同密钥
撤销未使用的密钥：删除不再需要的密钥
监控活动：检查异常使用模式

故障排除

连接问题

问题：MCP 服务器无法连接

解决方案：

验证 API 密钥正确且有效
检查 claude_desktop_config.json 语法（有效的 JSON）
确保使用绝对路径（而非相对路径）
配置更改后重启 Claude Desktop
检查 Claude Desktop 日志中的错误消息

生成失败

问题：设计生成失败或超时

解决方案：

简化提示词（降低复杂度）
检查图片 URL 是否可访问
验证您有足够的积分
如果使用固定高度，尝试更小的尺寸
等待 2 分钟超时（复杂设计需要时间）

无效 URL

问题：素材出现”无效 URL”错误

解决方案：

确保 URL 可公开访问
使用直接图片 URL（而非网页 URL）
验证 URL 返回图片内容（PNG、JPG 等）
切勿使用占位符 URL，如”placeholder.jpg”

API 参考

对于构建自定义集成的开发者，请参考我们的 API 文档：

基础 URL：https://api.mew.design
端点：/mcp
认证：x-api-key 请求头
速率限制：每分钟 60 次请求
超时：每次请求 120 秒

API 调用示例

curl -X POST https://api.mew.design/mcp \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "创建一张现代商务名片",
    "width": 1080,
    "height": -1
  }'

响应格式

成功响应 (200 OK):

{
  "success": true,
  "designUrl": "https://cdn.mew.design/designs/abc123.png",
  "message": "设计生成成功。"
}

错误响应 (4xx/5xx):

{
  "success": false,
  "message": "错误描述"
}

API 与 MCP 集成指南

想为你的 AI Agent 装上一个懂艺术的超能力？

我们为什么要做这个工具

什么是 MCP？

步骤 1. 生成 API 密钥

步骤 2. 设置 MCP 服务器

适用于 OpenClaw / OpenCode / Antigravvity / Codex

适用于 Claude Code / GeminiCli

适用于 Cursor

适用于 Cherry Studio

步骤 3. 使用设计工具

示例提示词

可用参数

步骤 4. 最佳实践

积分管理

提示词编写技巧

安全最佳实践

故障排除

连接问题

生成失败

无效 URL

API 参考

API 调用示例

响应格式

资源