关于 faktry
faktry MCP 将 faktry 的媒体工具提供给兼容 MCP 的客户端,用于生成和编辑图像、视频、音频、PDF 与 3D 资产。它适合通过 AI 客户端处理媒体的用户,提供托管服务、异步任务跟踪和可复用的媒体库。
主要功能
- 01生成和编辑图像、视频与音频
- 02创建和处理 PDF
- 03从文本或图像生成 3D 资产
- 04跟踪异步生成任务
- 05保存和浏览媒体库资产
- 06查看账户积分和用量
适用场景
- 01创建并修改产品图像
- 02将产品图像制作成带字幕的视频
- 03生成旁白或音乐并处理音频
- 04创建、合并或提取 PDF 内容
MCP 相关
托管的 MCP 服务提供 70 多个媒体生成与编辑、任务状态、积分和媒体库管理工具。客户端可通过 OAuth 或 API 密钥远程连接,也可使用 stdio 桥接程序。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://faktry.ai/api/mcpclaude mcp add --transport http faktry-faktry https://faktry.ai/api/mcp{"mcpServers":{"faktry-faktry":{"type":"http","url":"https://faktry.ai/api/mcp"}}}在 Cursor 中打开{"servers":{"faktry-faktry":{"type":"http","url":"https://faktry.ai/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"faktry-faktry":{"type":"http","url":"https://faktry.ai/api/mcp"}}}{"mcpServers":{"faktry-faktry":{"serverUrl":"https://faktry.ai/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
faktry MCP
将完整的 faktry 媒体工具栈引入你已经在使用的工具。
在任何兼容 MCP 的客户端中生成和编辑图像、视频、音频及 PDF。
faktry MCP 服务将完整的 faktry 工具包开放给所有支持模型上下文协议的客户端,包含 70 多种图像、视频、音频、PDF 和 3D 生成及编辑工具。生成产品图,将其剪辑成 UGC 风格视频并配上画外音、添加字幕,再导出缩略图合集,全程无需离开聊天界面。
**托管式远程服务。**连接到 https://faktry.ai/api/mcp,无需运行本地服务。仅支持 stdio 的客户端可使用npx -y @faktry/mcp桥接程序。- **OAuth 或 API 密钥,任选其一。**从 Claude.ai、Claude Desktop、Cursor 和 Hermes 一键连接,或在任何基于配置的客户端中填入静态 API 密钥。
- **默认异步。**长时间运行的任务(视频以及部分图像/音频任务)会立即返回
job_id;轮询faktry_job_status直到任务完成。 - **会记住内容的资料库。**使用
faktry_library_save保存任意结果,并通过faktry_library_list在后续会话中取回。 - **费用从 faktry 账户扣除。**使用量将从现有余额中扣除,可随时通过
faktry_credits查看。
安装
一键连接/OAuth
这些客户端会为你处理身份验证——粘贴 URL、登录并批准即可。
MCP 服务 URL:
https://faktry.ai/api/mcp
Claude.ai
- 打开 Claude.ai → 设置 → 集成。
- 点击 添加 MCP 服务,并粘贴上方的 URL。
- Claude.ai 会将你重定向到 faktry;登录并点击 批准。
- 完成——Claude.ai 会自动保存令牌。
Claude Desktop
- 打开 Claude Desktop → 设置 → 开发者 → MCP 服务。
- 点击 添加服务,并粘贴上方的 URL。
- 浏览器窗口会打开;登录 faktry 并点击 批准。
- 如果工具没有立即显示,请重启 Claude Desktop。
Cursor
- 打开 Cursor → 设置 → AI → MCP 服务。
- 点击 添加 MCP 服务,并粘贴上方的 URL。
- Cursor 会检测到 OAuth,并打开浏览器登录窗口。
- 登录 faktry、批准访问权限,然后返回 Cursor。
Hermes Agent
- 打开 Hermes Agent → 设置 → MCP 服务。
- 点击 + 并粘贴上方的 URL。
- Hermes 会打开浏览器登录页面;登录 faktry 并批准。
- 启用该服务——工具会立即显示。
ChatGPT Desktop (仅限 Business / Enterprise / Edu)
- 在“设置 → Beta 功能”中启用 开发者模式。
- 前往 设置 → MCP 服务 → 添加服务。
- 粘贴上方的 URL,并按照浏览器中的 OAuth 流程操作。
首先在 faktry.ai/api/keys 创建 API 密钥,然后将 faktry 添加到客户端的配置中。将 YOUR_API_KEY_HERE 替换为你的真实密钥——创建时只会显示一次。
Claude Code
添加到 .mcp.json(项目级)或 ~/.claude.json(用户级):
{
"mcpServers": {
"faktry": {
"type": "http",
"url": "https://faktry.ai/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
}
}
}
会自动加载,无需重启。
VS Code (Copilot)
添加到 .vscode/mcp.json(工作区),或通过 设置 → MCP 服务器 添加:
{
"servers": {
"faktry": {
"type": "http",
"url": "https://faktry.ai/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
}
}
}
Windsurf
编辑 ~/.codeium/windsurf/mcp_config.json(Windows 上为 %USERPROFILE%\.codeium\windsurf\mcp_config.json)——请注意,Windsurf 使用 serverUrl,而非 url:
{
"mcpServers": {
"faktry": {
"serverUrl": "https://faktry.ai/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
}
}
}
重启 Windsurf 以启用这些工具。
Continue.dev
添加到 ~/.continue/config.yaml:
mcpServers:
faktry:
type: http
url: https://faktry.ai/api/mcp
requestOptions:
headers:
Authorization: "Bearer YOUR_API_KEY_HERE"
Continue.dev 会自动重新加载。
Codex CLI
添加到 ~/.codex/config.toml:
[mcp.servers.faktry]
type = "http"
url = "https://faktry.ai/api/mcp"
[mcp.servers.faktry.headers]
Authorization = "Bearer YOUR_API_KEY_HERE"
使用 codex mcp list 验证。
stdio 客户端(npx) — Zed、较旧的 Claude Desktop 配置,以及任何不支持远程 MCP 的客户端
@faktry/mcp 包是连接托管服务的轻量级 stdio 桥接程序。需要 Node 18+。
通用格式:
FAKTRY_API_KEY=YOUR_API_KEY_HERE npx -y @faktry/mcp
Claude Desktop(claude_desktop_config.json)及大多数其他 mcpServers 客户端:
{
"mcpServers": {
"faktry": {
"command": "npx",
"args": ["-y", "@faktry/mcp"],
"env": { "FAKTRY_API_KEY": "YOUR_API_KEY_HERE" }
}
}
}
Zed(settings.json,Windows 上为 %APPDATA%\Zed\settings.json):
{
"context_servers": {
"faktry": {
"source": "custom",
"command": "npx",
"args": ["-y", "@faktry/mcp"],
"env": { "FAKTRY_API_KEY": "YOUR_API_KEY_HERE" }
}
}
}
如果要通过浏览器登录(OAuth),请省略 FAKTRY_API_KEY。
Kilo Code
- 打开 Kilo Code 扩展设置 → MCP 服务器。
- 使用与上方 Claude Code 相同的 JSON 片段添加新服务。
- 将
YOUR_API_KEY_HERE替换为你的真实密钥。
其他 MCP 客户端
添加一个远程 HTTP 服务,指向 https://faktry.ai/api/mcp,并设置以下标头:
Authorization: Bearer YOUR_API_KEY_HERE
也可以在 faktry.ai/mcp 生成针对各客户端的完整配置片段和路径。
工具
客户端会根据你的提示词选择要调用的工具——你无需按名称调用它们。faktry 提供 70 多种工具,分为五个类别:
| 类别 | 示例 | 功能范围 |
|---|---|---|
faktry_image_* | generate、edit、inpaint、outpaint、upscale、removebackground、effects、collage、watermark、smartcrop | 文本生成图像、编辑、放大、移除背景、合成 |
faktry_video_* | text2video、image2video、avatar、motioncontrol、subtitle、reframe、stabilize、upscale、scenedetect | 生成、编辑、虚拟形象、动作控制、字幕、重新构图 |
faktry_audio_* | generatespeech、clonevoice、generatemusic、generatesound、mix、transcribe、trim | 语音合成、声音克隆、音乐/音效生成、混音 |
faktry_pdf_* | create、merge、split、compress、extract、mdconvert | PDF 创建与处理 |
faktry_3d_* | image23d、text23d | 根据图像或文本生成 3D 资产 |
此外还有实用工具:
| 工具 | 功能 |
|---|---|
faktry_job_status | 通过 job_id 轮询异步任务,直到状态变为 completed,并返回 result_url |
faktry_credits | 查看积分余额和当月用量 |
faktry_library_list | 浏览之前保存的媒体资产 |
faktry_library_save | 将结果 URL 保存到资料库,以便在不同会话中重复使用 |
异步任务模式
大多数生成工具(视频、部分图像/音频工具)均为异步:
- 调用生成工具 → 接收
job_id。 - 每隔几秒使用该
job_id轮询faktry_job_status。 - 状态变为
completed后,响应中会包含result_url。 - 可选择使用
faktry_library_save保存结果。
示例提示词
连接 faktry 后,试试这些:
Generate a studio product shot of a matte black wireless speaker on a
white background, then upscale it to 4K.
Turn this product image into a 9:16 UGC-style video with a voiceover
reading the description, and add subtitles.
Remove the background from this photo, then composite it onto a
gradient backdrop.
Clone this voice sample and generate a 30-second narration reading
this script.
Check my faktry credits, then show me what's in my library.
故障排除
连接后未显示工具
- Claude.ai / Desktop: 设置 → 集成(或 Developer → MCP Servers),确认 faktry 显示为已连接。如果连接悄无声息地失败,请移除后重新添加;确保未屏蔽弹出窗口,以便打开 OAuth 窗口。
- Claude Code:
claude mcp list应显示该服务。 - Codex:
codex mcp list应显示faktry。添加后启动新会话。 - 快速冒烟测试:向客户端询问 “检查我的 faktry 额度”。
身份验证或 API 密钥错误
- 对于配置文件客户端,请确认已将
YOUR_API_KEY_HERE替换为从 faktry.ai/api/keys 获取的有效密钥;密钥仅在创建时显示一次。 - 对于 OAuth 客户端,请断开连接后重新连接该连接器,以重新完成授权流程。
生成任务一直处于加载状态
视频渲染以及某些音频/图像任务所需时间会比普通图像生成更长。工具会立即返回待处理的 job_id;请持续轮询 faktry_job_status,直到其报告 completed。
链接
- MCP 设置界面 — faktry.ai/mcp
- API 密钥 — faktry.ai/api/keys
- faktry — faktry.ai
许可证
MIT © faktry
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。