Templated

Templated MCP 服务

Templated 的 MCP（Model Context Protocol）服务：Templated 是用于自动生成图像、视频和 PDF 的 API。

此服务可让 Claude、Cursor 和 ChatGPT 等 AI 助手与您的 Templated 账户交互：使用自然语言生成渲染内容、管理模板、上传素材并访问所有 API 功能。

功能

• 渲染生成：根据模板创建图像（JPG、PNG、WebP）、视频（MP4）和 PDF
• 模板管理：列出、创建、更新、克隆和删除模板
• 图层检查：获取模板图层，以了解可自定义的内容
• 素材管理：上传和管理图像、视频和自定义字体
• 文件夹整理：创建和管理模板文件夹

快速开始

获取 API 密钥

1. 在 app.templated.io 注册
2. 前往您的 API 密钥页面
3. 复制您的 API 密钥

连接选项

选项 1：远程服务（推荐）

使用我们托管的 MCP 服务——无需安装，始终保持最新。

端点： https://mcp.templated.io/mcp（OAuth 登录）——或自动化场景使用 https://mcp.templated.io/mcp?apiKey=YOUR_API_KEY

Claude（网页、桌面、移动端）

Templated 已列入 Claude 连接器目录：打开 claude.ai/directory/templatedio（或选择 Customize → Connectors 并搜索 Templated），点击 Connect，然后登录您的 Templated 账户。若要将其作为自定义连接器添加，请使用 Settings → Connectors → Add custom connector，并填写 https://mcp.templated.io/mcp。

Claude Code

claude mcp add --transport http templated https://mcp.templated.io/mcp

然后在 Claude Code 中运行 /mcp，并在出现提示时登录。

Cursor IDE

或者手动将其添加到 ~/.cursor/mcp.json。无论采用哪种方式，Cursor 提示时点击 Login，并登录 Templated：

{
  "mcpServers": {
    "templated": {
      "url": "https://mcp.templated.io/mcp"
    }
  }
}

自动化场景请改用 https://mcp.templated.io/mcp?apiKey=your-api-key-here 作为 URL。

ChatGPT

1. 前往 Settings → Connected Apps → Add MCP Server
2. 输入 URL：https://mcp.templated.io/mcp
3. 将 Authentication 设为 OAuth，并在出现提示时登录 Templated
4. 点击 Create

**替代方式（自动化）：**输入 https://mcp.templated.io/mcp?apiKey=your-api-key-here，并将 Authentication 设为 No Auth。

Cursor 和 Grok 插件

此仓库也是一个插件，将托管的 MCP 服务与三个技能打包在一起：

• templated：使用现有模板进行渲染（精确图层名称、批次、尺寸、多页 PDF 和 PDF 合并）
• templated-design：根据简短需求设计新模板，或修复现有模板的布局
• setup：首次运行流程，用于检查账户并生成首次渲染，包括尚无模板的账户

文件	使用方
.cursor-plugin/plugin.json	Cursor 和 Grok Bot（Cursor Marketplace）
.grok-plugin/plugin.json	Grok Build（xAI 插件市场）
.mcp.json	MCP 服务（https://mcp.templated.io/mcp）
skills/	上述技能（也打包在 ChatGPT 插件中）

无需配置：首次调用工具时会打开 Templated 登录页面（OAuth），您也可以在此创建账户。您的设备上不会运行任何内容；插件只会连接到托管服务。

若要在 Cursor 中本地试用，请将此仓库克隆到 ~/.cursor/plugins/local/templated，然后运行 Developer: Reload Window。

选项 2：本地服务

在您的设备上本地运行 MCP 服务。需要 Node.js 18+。

Claude Desktop

若要改为本地运行服务，而非使用远程连接器，请将以下内容添加到配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "templated": {
      "command": "npx",
      "args": ["mcp-server-templated"],
      "env": {
        "TEMPLATED_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor IDE（本地）

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "templated": {
      "command": "npx",
      "args": ["mcp-server-templated"],
      "env": {
        "TEMPLATED_API_KEY": "your-api-key-here"
      }
    }
  }
}

手动安装

# Using npx (no install needed)
npx mcp-server-templated

# Or install globally
npm install -g mcp-server-templated

身份验证

远程服务支持两种身份验证方式：

• OAuth 2.1：通过 Templated 授权服务器进行身份验证。通过 https://mcp.templated.io/mcp 连接且不提供 API 密钥时，交互式客户端（Claude、ChatGPT、Cursor、Claude Code）会自动使用此方式。
• API 密钥：通过 URL 中的 ?apiKey=YOUR_API_KEY 或 Authorization: Bearer YOUR_API_KEY 标头进行身份验证，适用于自动化和多租户范围限定（folderId/externalId）。

可用工具

完整参考文档包含输入、权限类别（读取、写入或敏感写入）和副作用：docs/tools.md（运行 npm run build && npm run docs:tools 重新生成）。

渲染操作

工具	描述
create_render	根据模板创建图像、视频或 PDF
get_render	获取特定渲染的详细信息
list_renders	列出账户中的所有渲染
delete_render	删除渲染
merge_renders	将多个 PDF 渲染合并为一个

模板操作

工具	描述
list_templates	列出所有模板（支持搜索/筛选）
get_template	获取模板详细信息
get_template_layers	获取模板的所有图层
get_template_pages	获取多页模板的页面
create_template	创建新模板（单页模板使用 layers，多页/多尺寸模板使用 pages）
update_template	更新现有模板（通过 pages 添加或编辑页面）
clone_template	克隆模板（可选的新 name）
delete_template	删除模板
list_template_renders	列出由模板生成的渲染

文件夹操作

工具	描述
list_folders	列出所有文件夹
create_folder	创建新文件夹
update_folder	重命名文件夹
delete_folder	删除文件夹

资源操作

工具	描述
list_uploads	列出已上传的资源
create_upload	从 URL 上传文件
delete_upload	删除已上传的文件
list_fonts	列出自定义字体
upload_font	上传自定义字体
delete_font	按名称删除自定义字体

账户

工具	描述
get_account	获取当前周期的渲染用量

聊天内渲染预览

在支持 MCP Apps 的宿主环境中（Claude 网页版、桌面端和移动端、ChatGPT、VS Code 等），create_render 和 get_render 会在对话中以预览卡片显示结果：

• 图像（PNG、JPG、WebP）会适配卡片显示；MP4 渲染会显示视频播放器；PDF 会显示为文件卡片。
• 多页模板会以网格形式显示页面（PDF 则显示为列表）。
• 每张卡片都有 下载 和 在编辑器中打开 按钮，并会采用宿主环境的浅色或深色主题。
• 仍在处理中的渲染会显示等待状态，并在文件就绪时自动更新。

此卡片是 UI 资源 ui://templated/render-card-v1.html，是一个独立的 HTML 文件（约 21 KB），只会从 cdn.templated.media 和 templated-assets.s3.amazonaws.com 加载渲染文件。对于不支持 MCP Apps 的客户端（Cursor、Claude Code、脚本），会返回与之前相同的 JSON 文本结果，此外还会通过 structuredContent 提供渲染的 URL、格式、大小和状态。

使用示例

配置完成后，你可以向 AI 助手提出以下请求：

• “列出我的模板”
• “使用模板 [ID] 创建渲染，并将标题设为 ‘Hello World’”
• “生成姓名为 ‘John Doe’ 的 PDF 证书”
• “模板 [ID] 有哪些图层？”
• “创建一个名为 ‘Social Post’、包含标题和图像图层的新模板”
• “克隆我的 Instagram 模板并重命名”
• “将这张图像上传到我的账户”
• “显示我的 API 用量和账户信息”

创建渲染结果

"Create a render using template abc-123 with these changes:
- Set the 'title' layer text to 'Welcome!'
- Set the 'photo' layer image to https://example.com/photo.jpg
- Output as PNG with transparent background"

Claude 将使用 create_render 工具，并附上：

{
  "template": "abc-123",
  "format": "png",
  "transparent": true,
  "layers": {
    "title": { "text": "Welcome!" },
    "photo": { "image_url": "https://example.com/photo.jpg" }
  }
}

开发

# Clone the repository
git clone https://github.com/templated-io/mcp-server-templated.git
cd mcp-server-templated

# Install dependencies
npm install

# Build (the server, then the preview card into dist/ui/render-card.html)
npm run build

# Test
npm test

# Run in stdio mode (for local MCP clients)
TEMPLATED_API_KEY=your-key node dist/index.js

# Run in HTTP mode (for remote access)
PORT=3456 node dist/index.js
# Then access: http://localhost:3456/mcp?apiKey=your-key

使用 MCP Inspector 测试

npx @modelcontextprotocol/inspector npx mcp-server-templated

资源

• Templated 文档
• MCP 文档
• 模板库

许可证

MIT