Clipia MCP

Clipia MCP

在 Claude、Cursor 和 ChatGPT 中创建 AI 图像、视频、语音、音乐和演示文稿——通过一个 MCP 端点使用 60+ 个模型。

Clipia 是一个 AI 创作平台。这个托管的远程 Model Context Protocol（MCP） 服务让任何支持 MCP 的 Agent 都能生成图像、视频、语音和音乐；与文本模型聊天；规划和制作视频；创建和编辑演示文稿；轮询结果；浏览模型；搜索提示词模板；以及查看信用额度余额——无需 SDK，也无需编写代码。

端点： https://mcp.clipia.ai/mcp——无状态 Streamable HTTP，使用 Clipia API 密钥进行身份验证。

---

快速开始

只需一条命令即可将 Clipia 连接到 Claude Code（将占位符替换为你的密钥）：

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

然后只需在聊天中提问：“用 Clipia 生成一张霓虹城市图像”——预览会直接显示在终端中。

获取密钥： 在 Clipia Developer Console 中创建密钥。密钥只会显示一次。

不产生费用的沙盒： clipia_test_ 前缀的密钥会在沙盒中运行——即时返回模拟结果，不消耗信用额度。上线前，请使用 clipia_test_* 密钥验证集成。

---

从任何客户端连接

所有客户端都使用同一个端点：https://mcp.clipia.ai/mcp。IDE 和 CLI 使用从 Developer Console 获取的 API 密钥进行身份验证；claude.ai 和 ChatGPT 则通过 OAuth 登录 Clipia 账户进行连接（无需密钥）。

可直接粘贴的配置位于 examples/。

客户端	连接方式	身份验证
Claude Code	claude mcp add --transport http clipia …（参见“快速开始”）	API 密钥
Claude Desktop	在 claude_desktop_config.json 中配置 mcp-remote 桥接	API 密钥
claude.ai（网页/桌面/移动端）	设置 → 连接器 → 添加自定义连接器	OAuth
Cursor	~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）	API 密钥
VS Code	.vscode/mcp.json（servers + inputs）	API 密钥
Cline	cline_mcp_settings.json（mcpServers）	API 密钥
Windsurf	~/.codeium/windsurf/mcp_config.json（serverUrl）	API 密钥
Codex CLI	~/.codex/config.toml（bearer_token_env_var）	API 密钥（环境变量）
Gemini CLI	gemini mcp add --transport http clipia …	API 密钥
ChatGPT	开发者模式 → 应用和连接器 → 创建	OAuth

Claude Code

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Claude Desktop

Claude Desktop 通过 mcp-remote 桥接远程 HTTP 服务。将以下内容添加到 claude_desktop_config.json（设置 → 开发者 → 编辑配置），然后重启 Claude Desktop：

{
  "mcpServers": {
    "clipia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.clipia.ai/mcp",
        "--header",
        "Authorization: Bearer <CLIPIA_API_KEY>"
      ]
    }
  }
}

claude.ai（Web／桌面／移动端）

1. 打开 Settings → Connectors。
2. 点击 Add custom connector，并粘贴 URL：https://mcp.clipia.ai/mcp
3. 点击 Connect 并登录 Clipia 账号——无需密钥（OAuth）。
4. 在新聊天中请求生成图像或视频：消息中会显示实时 Clipia 卡片，其中包含进度和结果。

费用将从已连接的 Clipia 账号中扣除。

Cursor

将以下内容添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目），然后重启 Cursor：

{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

VS Code

在工作区中创建 .vscode/mcp.json（或使用 MCP: Add Server 命令）。VS Code 会在首次运行时提示输入密钥，并安全地存储该密钥：

{
  "servers": {
    "clipia": {
      "type": "http",
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:clipia_api_key}" }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "clipia_api_key",
      "description": "Clipia API Key",
      "password": true
    }
  ]
}

Cline

Cline 会从其 cline_mcp_settings.json 中读取 mcpServers（在 Cline 面板中选择 MCP Servers → Configure MCP Servers）：

{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

Cline 也可以自行安装此服务——请参阅 llms-install.md。

Windsurf

将以下内容添加到 ~/.codeium/windsurf/mcp_config.json（请注意 Windsurf 专用的 serverUrl 字段），然后刷新 Cascade → MCPs：

{
  "mcpServers": {
    "clipia": {
      "serverUrl": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

Codex CLI

将以下内容添加到 ~/.codex/config.toml，并将密钥导出到环境中——Codex 会自动从该变量注入 Authorization: Bearer：

# ~/.codex/config.toml
[mcp_servers.clipia]
url = "https://mcp.clipia.ai/mcp"
bearer_token_env_var = "CLIPIA_API_KEY"

# in your environment:
# export CLIPIA_API_KEY=<CLIPIA_API_KEY>

Gemini CLI

gemini mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

使用 gemini mcp list 验证连接。

ChatGPT（Developer Mode）

1. 在 ChatGPT（Web）中：选择 Settings → Apps & Connectors → Advanced settings → 启用 Developer mode（Plus、Pro、Business、Enterprise）。
2. 返回 Apps & Connectors → Create。将名称设为 Clipia，MCP 服务 URL：https://mcp.clipia.ai/mcp。
3. 身份验证 — OAuth，勾选 “I trust this application”，然后点击 Create。
4. 在弹出窗口中登录 Clipia 账号。在聊天中按 + → More → Clipia，然后用普通文本提出请求。

支持的身份验证标头方案： Authorization: Bearer clipia_*（推荐）、Authorization: Key <key> 或 X-Api-Key: <key>。

---

工具

此服务始终向 Agent 提供 10 个核心工具。截至 2026-07-26，生产环境提供 15 个 Agent 工具：10 个核心工具，以及聊天、场景规划、服务端视频合成、演示文稿生成和演示文稿编辑工具。7 个仅供应用使用的辅助工具不会向 AI Agent 显示。精简的架构可减少 Agent 的上下文窗口占用。

工具	功能说明
generate_image	根据文本提示词生成图像，也可选择提供参考图像（用于编辑／图生图）。短暂等待后，通常会直接返回已完成的图像（URL + 小尺寸预览）。返回消耗的点数。
generate_video	根据文本提示词（文生视频）或起始图像（图生视频，通过 image_url 传入）开始生成视频。立即返回 request_id 和消耗的点数——渲染需要 1–10 分钟，可通过 wait_generation 轮询。
generate_audio	使用选定的语音和语言，将文本生成为语音。完成后返回音频文件（格式为 mp3 或 wav，具体取决于模型）。
generate_music	根据对情绪、流派和节奏的描述生成背景音乐或配乐，也可根据你自己的歌词创作歌曲。
wait_generation	等待生成完成（最长轮询 wait_seconds，然后返回当前状态）。重复调用，直到状态为 COMPLETED、FAILED 或 CANCELED。完成后返回输出 URL（以及内嵌预览）。
get_generation	不等待，直接获取生成任务的当前状态／结果。状态为 COMPLETED 时，output.images[].url 是内嵌的 webp 预览，output.images[].original_url 是全画质 PNG/JPG。
list_models	列出 AI 模型及其类型（文本／图像／视频／音频）、功能和点数定价（文本模型按每 1K 计费，其他模型为基础价格）。可按 type／search 筛选；当 truncated 为 true 时，可通过 offset 翻页。
get_model	获取模型详情和定价：生成模型的 input_schema；文本模型的上下文限制以及每 1K 输入／输出费率。
get_balance	获取已连接的 Clipia 账户的点数余额，以及当前 API 密钥近 30 天的用量。
search_templates	搜索 3500 多个精选提示词模板（结合文本与语义的混合搜索，支持俄语或英语查询）。每条结果都包含可直接使用的提示词和推荐模型。
chat	_目前已启用，受功能开关控制：_使用提示词或消息数组与文本 LLM 聊天；返回回复文本、令牌用量和点数消耗。
generate_scenario	_目前已启用，受功能开关控制：_将简短描述转换为逐场景的视频提示词和配乐提示词。
compose_video	_目前已启用，受功能开关控制：_将 2–20 个已完成的场景拼接为最终 MP4，可选择添加配音、配乐和字幕。
generate_presentation	_目前已启用，受功能开关控制：_根据结构化的演示文稿规范，生成可编辑的 PPTX、PDF 和预览图。
edit_presentation	_目前已启用，受功能开关控制：_编辑现有演示文稿、调整或替换幻灯片、修改文本和主题，并重用未更改的插图。
app_get_generation	_内部／仅供应用使用：_供 Clipia 生成查看器卡片（MCP Apps）轮询状态的工具。对模型隐藏；建议使用 get_generation。
默认模型（未传入 slug 时使用）：图像使用 nano-banana-2，视频使用 seedance-2-fast-t2v / seedance-2-fast-i2v。可通过 list_models 中的模型 slug 覆盖。

模型不识别的参数。 如果 input 或顶层参数中包含拼写错误的名称，或包含所选模型已知不适用的参数（例如，在未声明该参数的模型上使用 seed），generate_image、generate_video、generate_audio 和 generate_music 会在开始生成前拒绝调用。invalid_request 错误会指出被拒绝的参数，并列出模型声明的参数——请通过 get_model 查看并重试。被拒绝的调用不会生成任何内容，也不会预留额度。

---

为什么选择 Clipia

• 在俄罗斯和独联体付款 — 支持俄罗斯银行卡、SBP、MIR，无需 VPN。这些地区不受西方支付处理商支持；Clipia 专为这一市场打造（也支持国际用户）。
• 60 多款旗舰模型，一个端点 — 西方和中国模型一站集成：Veo 3.1、Kling 3、Seedance 2、Hailuo、Wan 2.7、Nano Banana、FLUX、Midjourney V7、Imagen 4 等。无需在多个海外订阅之间来回切换。
• 沙盒测试不扣费 — clipia_test_* 密钥会立即返回模拟结果，不消耗额度，非常适合接入集成或 CI。
• 聊天中的实时预览（MCP Apps） — 在 claude.ai（网页端／桌面端／移动端），每次生成都会显示交互式卡片，其中包含实时进度、生成完成的媒体以及“原始内容”按钮。在 Claude Code 中，预览会直接显示在终端内，便于通过视觉反馈迭代。
• 3500 多个提示词模板 — search_templates 为 Agent 提供精选的即用型提示词（混合搜索，支持俄语／英语），每个模板都附有推荐模型。
• 每次响应都包含费用 — 每次生成都会返回精确的额度费用，get_balance 会显示剩余额度。没有隐藏的 MCP 标记。
• 精简的工具集 — 10 个核心工具配备精简的架构，让 Agent 的上下文窗口保持轻量；启用的功能只会添加所需工具。

---

SDK

想通过自己的代码调用 Clipia，而不是使用 Agent？可使用官方 SDK，通过同一公共 API 调用（异步 submit → status → result 队列，按额度计费）：

• TypeScript / Node： clipia-ai — npm install clipia-ai（还附带 clipia CLI）。
• Python： clipia — pip install clipia（支持同步和异步客户端）。

两者都支持通过 HMAC-SHA256 进行签名验证的 Webhook，以及相同的 clipia_test_* 沙盒密钥。

---

Glama 服务运行时

此仓库包含一个精简的 Docker 运行时，供 Glama 启动公共服务入口并检查其 MCP 工具定义。容器是连接到托管端点的 stdio 桥接程序；其中不包含 Clipia 应用或任何凭据。

请在 Glama 中将 CLIPIA_API_KEY 配置为密钥。使用带有 clipia_test_ 前缀的沙盒密钥，确保验证过程不会消耗额度。可选设置 CLIPIA_MCP_URL 的默认值为 https://mcp.clipia.ai/mcp，且只接受 HTTPS URL。

docker build -t clipia-mcp-glama .
docker run --rm -i \
  -e CLIPIA_API_KEY='<CLIPIA_TEST_API_KEY>' \
  clipia-mcp-glama

---

定价

费用从已关联的 Clipia 账户中以额度扣除，与网站使用同一余额。每次生成都会返回精确的额度费用，get_balance 会显示剩余额度。不同模型所需的额度各不相同，具体取决于分辨率、时长和质量。

新账户会获赠少量欢迎额度，用于体验平台；之后需要订阅。提供四种月度套餐（Basic / Standard / Pro / Ultima）——请参阅 clipia.ai/tariffs。

clipia_test_* 沙盒密钥会返回模拟结果，不扣除额度——可用于开发和测试，无需花费。

---

🇷🇺 俄罗斯和独联体地区

Clipia 是一个 AI 平台，可用于生成图像、视频、语音、音乐和演示文稿，也支持文本 AI 聊天和制作成品视频。俄罗斯和独联体地区的用户可使用俄罗斯银行卡、快速支付系统（СБП）和 МИР 付款，无需 VPN。60 多种欧美和中国模型（Veo 3.1、Kling 3、Seedance 2、Nano Banana、FLUX、Midjourney V7）可通过一个 MCP 端点，直接在 Claude、Cursor 和 ChatGPT 中使用。

一条命令即可连接（密钥可在开发者控制台中获取）：

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

clipia_test_* 密钥是用于调试的沙盒密钥，不会扣除点数。采用点数计费，每次生成的费用都会在响应中返回。价格方案：clipia.ai/tariffs。

---

链接

• 开发者 / REST API 和 SDK： clipia.ai/developers
• MCP 介绍页： clipia.ai/mcp
• 模型目录： clipia.ai/models
• 价格： clipia.ai/tariffs
• 获取 API 密钥： clipia.ai/en/developer

---

支持与法律信息

• 网站： clipia.ai
• 文档： clipia.ai/en/docs/mcp
• 隐私政策： clipia.ai/privacy
• 条款： clipia.ai/terms
• 支持： [email protected]

---

许可证

MIT — 详见 LICENSE。© 2026 Clipia（个体企业家 Zakharov Maksim Sergeevich）。