# Genjutsu MCP 服务器

> 在 AI 应用里加一个地址，它就能用你的 Genjutsu 积分运行特效、发起渲染、查看进度、取回文件。价格和网页工作室完全一致。

服务器地址: https://genjutsu.live/mcp

## 连接时会发生什么

1. 应用会打开 Genjutsu 登录窗口。请用你想消耗积分的那个账号登录。
2. 授权页会写明是哪个应用、它能做什么。点「允许」之前不会共享任何东西。
3. 应用拿到一个有效期一小时的令牌，使用期间会自动续期，最长 30 天。
4. 渲染开始时扣积分，失败自动退还。随时可以在设置里断开应用。

## 在你的应用里设置

### Claude

在 Claude（网页版或桌面版）打开设置 → 连接器 → 添加自定义连接器，粘贴地址后点添加，再点连接并登录。自定义连接器需要 Claude 付费套餐。

```
https://genjutsu.live/mcp
```

### Claude Code

在终端运行这条命令，然后在 Claude Code 里输入 /mcp，选中这个服务器登录。

```
claude mcp add --transport http genjutsu https://genjutsu.live/mcp
```

### ChatGPT

在 ChatGPT 的设置 → 应用与连接器 → 高级里打开开发者模式，然后用这个地址新建连接器，认证方式选 OAuth。

```
https://genjutsu.live/mcp
```

### Codex

把这几行加到 ~/.codex/config.toml，再运行 codex mcp login 加服务器名完成登录。

```
[mcp_servers.genjutsu]
url = "https://genjutsu.live/mcp"
```

### Cursor

写入 ~/.cursor/mcp.json（或项目里的 .cursor/mcp.json）。在设置 → MCP 里，服务器旁边会出现登录按钮。

```
{
  "mcpServers": {
    "genjutsu": {
      "url": "https://genjutsu.live/mcp"
    }
  }
}
```

### VS Code

写入 .vscode/mcp.json，点服务器条目上方的「启动」，VS Code 会在浏览器里打开登录页。

```
{
  "servers": {
    "genjutsu": {
      "type": "http",
      "url": "https://genjutsu.live/mcp"
    }
  }
}
```

### Windsurf

写入 ~/.codeium/windsurf/mcp_config.json，在 Cascade 里刷新 MCP 列表，按提示登录。

```
{
  "mcpServers": {
    "genjutsu": {
      "serverUrl": "https://genjutsu.live/mcp"
    }
  }
}
```

## 八个工具

- `list_models`: 列出所有视频和图片模型，以及时长、尺寸和积分价格。
- `generate_video`: 发起文生视频或照片生视频，24 积分起。
- `generate_image`: 发起图片生成或编辑，参考图数量以模型上限为准，6 积分起。
- `list_effects`: 列出所有 Genjutsu 特效，以及所用模型、需要的素材和每秒积分。
- `apply_effect`: 对你提供链接的视频（MP4 或 MOV，3 到 30 秒）运行特效，每秒 13 积分起。开始前会先请你确认对画面中人物的授权。
- `get_task`: 查询单个渲染，完成后返回文件链接。
- `list_tasks`: 按时间倒序列出最近的渲染。
- `get_credits`: 返回积分余额。

apply_effect 需要视频文件的直链（分享页面不行），并且和工作室一样要确认授权。想拖拽上传或用前后对比滑块，请用网页工作室。

## 在脚本里用 API 密钥

不能打开浏览器的工具，可以改用 API 密钥。在设置 → API 密钥里创建，放在 Bearer 请求头里发送。API 密钥需要包含 API 权限的套餐；OAuth 登录所有账号都能用。

## 遇到问题时

### 登录窗口一直不弹出

应用可能缓存了旧连接。删除服务器后用上面的地址（以 /mcp 结尾）重新添加并连接。

### 之前能用，现在提示 401 或未授权

令牌被撤销了，或者 30 天没用。回到应用重新连接，会再次看到授权页。

### 提示积分不足

渲染没有开始，也没有扣费。可以去价格页充值，或者让助手改用更短的时长、更低的分辨率。

### 渲染一直显示处理中

大多数视频需要 1 到 4 分钟。让助手再调用一次 get_task；失败的渲染会自动退还积分。

## 常见问题

### Genjutsu MCP 服务器要额外收费吗？

不用。每次渲染消耗的积分和网页工作室一样，连接本身不收费。

### 渲染算在哪个账号上？

算在你在授权窗口里登录的账号上。作品会和网站上做的一起出现在我的视频里。

### 两个应用能共用一个 Genjutsu 账号吗？

可以。每个应用各自授权、各自持有令牌，可以分别断开。

### 通过 MCP 做的作品会公开吗？

跟随账号设置。开启私密模式（任意积分包、Pro、Ultimate 或团队套餐）后，不会出现在公开作品廊。

### Genjutsu 会保存哪些连接信息？

应用名称和回跳地址、它的访问令牌，以及最近使用时间。提示词和网站上一样，随作品保存。


---

Source: https://genjutsu.live/zh/mcp-server · Site index for AI agents: https://genjutsu.live/llms.txt · Full content: https://genjutsu.live/llms-full.txt
