一个URL。所有MCP客户端。您的整支机群。
只需将https://simplyprint.io/api/mcp粘贴到任意支持MCP的助手连接器设置中，批准OAuth同意屏幕后即可完成。认证模型、权限和数据与SimplyPrint其余功能相同，只是用自然语言交互，而非在面板中点击。
什么是MCP？
MCP，即Model Context Protocol，是一项开放标准，由Anthropic倡导并获所有主要AI供应商采用，让AI助手可通过统一接口调用外部工具。无需每个助手自行发明插件格式，MCP定义了一种统一结构，Claude、ChatGPT、Gemini、Cursor、Windsurf、Cline、Zed等都能理解。
SimplyPrint在https://simplyprint.io/api/mcp运行官方 MCP服务器。支持自定义连接器或 MCP服务器的任何助手均可连接，一条 URL，所有客户端。我们也以io.simplyprint/simplyprint列于官方 Model Context Protocol注册表，因此浏览该注册表的客户端可自动发现我们。
面板中几乎所有操作，均可通过原生AI工具完成
MCP服务器提供与面板相同的操作，并按供助手选择的类别分组。共约70项工具，均连接到驱动SimplyPrint网页应用的同一API端点，因此MCP调用中的打印机与API返回的打印机对象相同。
查看、发送G-code、点动、控制风扇、回零、暂停、继续、取消。
添加、重新排序、编辑、批准、拒绝、恢复、分组和评论。
搜索、筛选、估算成本、更新元数据、整理文件夹。
查看料盘、调整重量、分配、取消分配、标记为已干燥。
筛选和归档历史任务，获取成功率、耗材用量、耗时和成本数据。
用户实际会向助手提问什么
帮助中心文章示例界面中的一些真实提示，可直接映射为工具调用：
- 打印机：例如“现在在打印什么？”“让4号打印机的三个轴归零。”或“取消K2上的打印。”
- 队列：“批准Sarah提交的三个待处理项目。”：“为明天将五份benchy.gcode加入队列。”：“店里的哪台打印机能最快打印下一项？”
- 文件：“查找所有标记为‘prototype’的文件并删除。”“估算在 X1C 上打印 battery-holder.gcode 的成本。”
- 耗材：“哪些料盘低于 100 g？”“将料盘 42 的剩余重量调整为 820 g。”
- 统计：“本周我们用了多少耗材？”“显示昨天最长打印的详情。”
配置文件客户端：一个JSON块
编辑器和CLI MCP客户端（Claude Desktop、Claude Code、Cursor、Cline、Zed）会将其MCP服务器列表保存在JSON配置文件中。将SimplyPrint添加到mcpServers下，客户端会在首次使用时处理OAuth往返流程。
{
"mcpServers": {
"simplyprint": {
"url": "https://simplyprint.io/api/mcp"
}
}
}
细粒度授权范围，只授予助手所需权限
每项权限都会向助手授予您账户中特定范围的访问权限。OAuth 同意屏幕会列出助手请求的每个授权范围，您决定批准哪些权限，因此只读摘要工具绝不会获得写入权限，仅限打印队列的自动化也不会看到耗材详细信息。
- 查看与管理：几乎每个类别都有独立的读取和写入权限范围。需要严格只读的助手？跳过管理权限范围即可。需要全自动化？同时授予两者。
- 每位用户独立令牌：令牌绑定到您本人，而非账户管理员。它仅继承您在账户中的权限，绝不会超出这些权限。
- 设计上禁止访问：MCP完全不提供账单、订阅变更和账户删除功能，任何权限范围都无法解锁它们。
- 立即撤销：打开账户设置→已连接应用，查看每个已连接助手的授权范围和最后使用时间戳，点击撤销。该助手将立即停止工作。
正在开发自己的MCP客户端？
如果您正在编写自定义 MCP 客户端，身份验证流程是标准 OAuth 2.1 授权码流程，授权端点为https://simplyprint.io/oauth/authorize，令牌端点为https://simplyprint.io/oauth/token。完整的 curl 指南、权限范围参考和令牌语义请见API 文档。
兼容所有支持MCP的助手
各客户端上的集成都完全相同：同一URL、同样的OAuth流程、相同的工具集。我们为最常用的客户端提供完善的操作指南，其他所有支持MCP的工具也可使用相同设置。
可在claude.ai、Claude Desktop和Claude Code中使用。
添加指向 SimplyPrint MCP URL 的自定义连接器。
安装官方扩展，或直接添加MCP URL。
任何支持MCP的编辑器或智能体都通过相同的OAuth流程连接。
在您的客户端MCP注册表中搜索“simplyprint”以添加它。
OAuth，范围限定的令牌，可随时撤销
安全性与SimplyPrint其他功能采用相同模型，只是针对AI客户端进行了封装。
- OAuth流程，而非粘贴密钥：您在simplyprint.io登录，助手不会看到您的密码。它收到的令牌对它不可读。
- 范围控制：令牌只能调用与您批准范围匹配的工具。范围外工具会从工具列表中过滤，并在调用时被拒绝。
- 受众绑定：令牌绑定至其签发时对应的规范MCP URL（RFC 8707）。用于SimplyPrint的令牌只能用于SimplyPrint，不能跨服务器重放。
- 短时访问、轮换刷新：访问令牌有效期为1小时，刷新令牌每次使用时轮换，并在90天后到期。遵循MCP 2025-06-18规范。
- 每位用户独立，绝不共享：令牌会继承您在账户中的权限。由查看者角色连接的助手绝不可能提升权限并执行管理员操作。
- 完整调用日志：每次MCP调用都会在服务器端记录方法、参数、耗时和结果，因此您可以审计助手实际执行的操作。
与REST API和webhook搭配
MCP与SimplyPrint的其他开发者功能并列，采用相同的身份验证模型、数据结构和权限系统：
- SimplyPrint API是您的代码用于按需拉取状态的接口。
- Webhooks是在发生变化时SimplyPrint会立即推送的内容，因此您无需轮询。
- MCP是AI助手在需要对同一打印机群进行读取或操作时调用的机制，通过经过审核、按范围控制的工具注册表，而非原始端点。
方案权限：哪些方案包含 MCP？
MCP访问包含在Pro及以上套餐中，无额外费用。不收取按工具费用、按调用费用，也无需单独的AI席位。助手自身的订阅费用（Claude Pro、ChatGPT Plus、Gemini等）支付给相应供应商，而非SimplyPrint。
| Функція / обмеження | Безкоштовно | Basic | Pro | Парк принтерів | Enterprise | Школа | Хмарний слайсер | Менеджер філаменту |
|---|---|---|---|---|---|---|---|---|
|
MCP API访问
完整MCP服务器，涵盖面向用户的全部工具：打印机、队列、文件、耗材、任务和统计。基于OAuth，按权限范围限制访问，专业版及以上套餐可用。
|
||||||||
|
基础API（与MCP配套）
相同套餐，相同认证模型。REST API适用于您的代码，MCP适用于AI助手，二者均使用相同的按用户权限系统。套餐层级和限制请参阅API功能页面。
|
||||||||
|
Webhooks（打印农场及以上）
如果您的 AI 工作流需要响应事件而不是轮询事件，请将 MCP 与 Webhook 配合使用。Print Farm、School 和 Enterprise 计划均包含此功能。
|
Хочете дізнатися більше про наші плани?
Переглянути повне порівняння цін і функцій常见问题
什么是MCP？
什么是SimplyPrint MCP URL？
可连接哪些AI助手？
哪些AI助手支持MCP？
令牌刷新如何运作？
助手实际能做什么？
必须粘贴API密钥吗？
如何撤销助手的访问权限？
我的数据会被用于训练该AI吗？
SimplyPrint中的MCP如何收费？
多个助手可以连接到同一账户吗？
MCP与REST API和webhooks有何不同？
分步指南在哪里？
分步设置指南
有关逐个客户端的完整指南，包括Claude、ChatGPT、Gemini CLI和编辑器MCP客户端的具体说明，请参阅帮助中心中的通过MCP将SimplyPrint连接到任意AI助手文章。