让 Claude 直接驱动 Mira 101
把 Mira 101 配置成 MCP (Model Context Protocol) server， Claude.ai / Claude Code / Claude Desktop / Cursor 都能用对话式调你的工作流、角色护照、模板。
第 0 步 · 拿一把 API Key
所有接入方式都需要 Pixify API Key（mk_ 开头）。 在站内 API 页面 点「Create Key」生成一把（注意：明文只展示一次，关闭就再也看不到了）。
第 1 步 · 选接入方式
两条路线，按你的 client 选：
HTTP 直连
Streamable HTTP (推荐)
不用装东西，把 MCP URL + API Key 填到 client 配置里即可。适合 Claude.ai web 和 Claude Code 的新版本。
stdio 本地进程
Node.js MCP server
把 packages/mcp-server build 出来，让 client 当子进程拉起。适合不支持远程 HTTP MCP 的 client。
HTTP 接入
Claude.ai web connector + Claude Code
A · Claude.ai （web）
- 登录 Claude.ai · Settings · Connectors
- 点 Add connector → 选 Custom MCP server
- 填以下信息：
URL: https://pixify-api-claude-667622338983.us-central1.run.app/api/v1/mcp
Auth: API Key (Bearer)
Token: mk_xxxxxxxxxxxx （从 /api 页面创建）点 Connect 后会要求登录 — 在弹窗里粘贴你的 API Key 提交即可，无需 OAuth 流程。
B · Claude Code（CLI）
v0.2+ 支持 HTTP transport，一行命令搞定：
claude mcp add --transport http mira101 https://pixify-api-claude-667622338983.us-central1.run.app/api/v1/mcp \
--header "Authorization: Bearer mk_YOUR_KEY"装好后输入 /mcp 应能看到 mira101 列在已连接列表里。
stdio 接入
Claude Desktop / Cursor / 老版本 client
前置：构建 mcp-server 包
# 拉仓库 + 构建
git clone https://github.com/mira-gift-hq/pixify
cd pixify
pnpm install
pnpm --filter @pixify/mcp-server build
# 入口（记下这个绝对路径）
echo "$(pwd)/packages/mcp-server/dist/index.js"A · Claude Desktop
编辑配置文件（macOS：~/Library/Application Support/Claude/claude_desktop_config.json， Windows：%APPDATA%\Claude\claude_desktop_config.json）：
{
"mcpServers": {
"mira101": {
"command": "node",
"args": ["/absolute/path/to/Pixify/packages/mcp-server/dist/index.js"],
"env": {
"PIXIFY_API_KEY": "mk_xxxxxxxxxxxx"
}
}
}
}保存后**完全重启** Claude Desktop（菜单 → Quit，不是关窗口）。重启后右下角应看到 mira101 的连接指示。
B · Cursor
编辑 ~/.cursor/mcp.json：
{
"mcpServers": {
"mira101": {
"command": "node",
"args": ["/absolute/path/to/Pixify/packages/mcp-server/dist/index.js"],
"env": {
"PIXIFY_API_KEY": "mk_xxxxxxxxxxxx"
}
}
}
}可用工具一览
12 个，按类型分组
工作流
list_workflows列出当前用户的所有工作流get_workflow获取工作流完整定义（nodes + edges）create_workflow创建新工作流（让 Claude 帮你搭 pipeline）update_workflow改既有工作流（agent debug 后保存）execute_workflow触发执行；返回 task_idget_task查任务状态 + outputs资产
list_templates浏览公开模板（create_workflow 的参考）list_models列可用 AI 模型（FAL / MiniMax / Hailuo / OpenAI）list_characters列已铸造的角色护照list_creations列创作历史single_task不走工作流的一次性任务（如 t2i / t2v）账户
get_credit_balance查积分余额试着说点什么
配置完后，对你的 Claude / Cursor 说
- "列一下我现在所有的工作流，按更新时间倒序"
- "帮我用 textToImage + imageToVideo 搭一个生成赛博朋克短片的 workflow，跑一遍"
- "用 short-drama-cat-rain 模板跑一次，把 textInput 改成「黎明前的渔港」"
- "查一下 task_xxx 的状态，完成了的话把视频 URL 给我"
搞不动？
- Claude.ai 显示 401 / Unauthorized
- API Key 没填对 / 拼错了 / 包含了多余空格。重新去 /api 创建一把粘贴。
- Claude Desktop 看不到 mira101 连接
- 完全 Quit 后重启（不是关窗口）。检查 absolute path 是否真实存在；检查 PIXIFY_API_KEY 是否填了。
- execute_workflow 报 'taskId required'
- 老版本 bug，已修。如果还遇到，确认你的部署版本是 claude-dev 最新。
- FAL 那边没收到生成请求
- 检查 textInput 节点的 prompt 是否被 inputs 字段实际注入。MCP 新版会自动注入按 node id / label 匹配。
- 想自己调试 MCP 协议
- Inspector 工具：
npx @modelcontextprotocol/inspector， 填 URL + Bearer 即可看 raw JSON-RPC frames。