Arckép

Arckép MCP 服务（arckep.ru）

Arckép（Arckep）的官方远程模型上下文协议（MCP）服务——多模态 AI 工作室和 API，可通过单一的按量付费 RUB 余额生成图像、视频、电影特效、语音和语音克隆、转录文本、3D 模型、PPTX/PDF 幻灯片、Word/Excel/PDF 文档、市场商品卡片，并生成大模型补全内容。

• 端点： https://arckep.ru/api/v1/mcp
• 传输方式： MCP Streamable HTTP
• 身份验证： OAuth 2.1（浏览器授权流程）或 Authorization: Bearer ark_live_... API 密钥
• 注册表名称： ru.arckep/mcp
• 开发者门户与定价： https://arckep.ru/developer · MCP 指南

---

快速连接

选项 1 — 一键 OAuth 2.1（推荐用于桌面端和 IDE Agent）

任何支持 Streamable HTTP + OAuth 2.1 发现机制的 MCP 客户端，只需配置服务 URL：

https://arckep.ru/api/v1/mcp

客户端会自动发现 OAuth 元数据，在浏览器中打开 Arckép 授权页面，并在设置 → API下创建专用的可撤销密钥（MCP: <client name>）。批准 OAuth 本身不会触发付费生成，你也可以随时在https://arckep.ru/settings?tab=api撤销访问权限。

Claude Code

claude mcp add --transport http arckep https://arckep.ru/api/v1/mcp

VS Code（.vscode/mcp.json）

{
  "servers": {
    "arckep": {
      "type": "http",
      "url": "https://arckep.ru/api/v1/mcp"
    }
  }
}

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "arckep": {
      "url": "https://arckep.ru/api/v1/mcp"
    }
  }
}

---

选项 2 — 用于无头 Agent 和 CI 的 API 密钥（Bearer）

在**设置 → API**中创建作用域受限的 API 密钥，并将其放入 Authorization 标头中（将密钥存储在客户端的机密存储区或环境变量中，切勿写入已提交的配置文件）：

claude mcp add --transport http arckep https://arckep.ru/api/v1/mcp \
  --header "Authorization: Bearer ${ARCKEP_API_KEY}"

{
  "mcpServers": {
    "arckep": {
      "url": "https://arckep.ru/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ARCKEP_API_KEY}"
      }
    }
  }
}

---

功能与工具类别

类别	工具	亮点
目录、余额与用量	list_models、get_balance、get_usage	实时模型目录，包含功能、参数、卢布定价、当前余额和支出明细
图像	estimate_image、create_image、list_images、get_image	文生图与图像编辑，支持参考照片、多种宽高比和最高 4K 分辨率
视频与电影	estimate_video、create_video、list_videos、get_video、*_higgsfield_*、cancel_higgsfield_video	文本/图像/参考素材生成视频、原生音频、电影摄影机预设、动作迁移、对象替换、风格重绘
语音（TTS）与声音克隆	estimate_speech、create_speech、list_speech、get_speech、list_speech_voices、list_my_speech_voices、design_speech_voice、replicate_speech_voice、delete_speech_voice	单人声与双人对话 WAV 合成、根据文本描述设计自定义声音、经同意验证的声音克隆
语音转文本（STT）	estimate_transcription、create_transcription	音频转录，支持说话人分离和时间戳
3D 模型	estimate_3d、create_3d、list_3d、get_3d、download_3d_stl	文本/图像生成 3D 模型（glb、fbx、obj、usdz），并可导出可打印的二进制 STL
幻灯片（PPTX / PDF）	estimate_presentation、create_presentation、list_presentations、get_presentation、revise_presentation、cancel_presentation	生成多页演示文稿，并迭代修改幻灯片，支持 PPTX、PDF 和幻灯片预览
文档（DOCX / XLSX / PDF）	estimate_document、create_document、list_documents、get_document、revise_document、cancel_document	结构化 Word 报告、含公式的 Excel 电子表格，以及支持迭代修改的 PDF
电商平台商品卡片	estimate_marketplace_cards、create_marketplace_cards、list_marketplace_cards、get_marketplace_cards	根据产品照片，为 Wildberries 和 Ozon 生成完整的电商信息图卡片组
媒体上传	upload_media	上传参考图像、音频、视频或源文档（通过 MCP 上传最大 10 MiB；通过 HTTP REST 上传最大 25 MB）
聊天、决策与批处理	chat_completion、decide、create_chat_batch、list_chat_batches、get_chat_batch、get_chat_batch_results、cancel_chat_batch	多模态大模型调用、多模型共识决策和异步批处理

内置成本与安全控制

• 先获取免费报价： 每个付费工具都有对应的免费 estimate_* 工具，可在执行前返回准确或典型的卢布成本。
• 支出上限（max_cost_rub）： 付费媒体创建工具支持 max_cost_rub，如果报价超出上限，会在扣费前拒绝执行。
• 幂等性（idempotency_key）： 安全重试，不会重复扣费。
• 限定范围的 API 密钥： 将密钥限制为特定权限（images:write、videos:write、audio:write、presentations:write、documents:write、models3d:write、chat:write、read）。

---

中文 — 快速连接到 Arckép MCP

公共 MCP 服务 Arckép 为 AI Agent（Claude Code、Claude Desktop、Cursor、VS Code 等）提供直接访问图像、视频和配音生成、语音克隆、音频转录、3D 模型、PPTX/PDF 演示文稿、Word/Excel/PDF 文档、Wildberries 和 Ozon 商品卡片以及语言模型的能力，所有服务共用一个卢布余额，无需 VPN。

• MCP 地址： https://arckep.ru/api/v1/mcp
• 通过浏览器登录（OAuth 2.1）： 只需填写 URL https://arckep.ru/api/v1/mcp——Agent 会自动打开 arckep.ru 上的确认窗口，并在 设置 → API 中创建单独的密钥（随时可以删除密钥以撤销访问权限）。
• 通过密钥登录（Bearer）： 在 https://arckep.ru/settings?tab=api 页面创建具有所需权限的密钥，并传入请求头 Authorization: Bearer ark_live_...。
• 完整文档和含价格的模型目录： https://arckep.ru/developer 和 https://arckep.ru/developer/docs#mcp。

---

支持与安全

• 文档： https://arckep.ru/developer/docs
• 支持与安全联系邮箱： [email protected]（参见 SECURITY.md）
• 许可证： 本仓库中的文档和配置示例采用 MIT 许可证。托管的 Arckép API 和 MCP 服务的使用受 Arckép 服务条款约束。