i40Pilot

i40Pilot MCP 服务

通过 Claude、ChatGPT、Cursor 或任何 MCP 客户端，构建制造业仪表板、OEE 报告、计划和 3D 零件。

i40Pilot 是一个工业 BI 平台。本仓库介绍其托管的 Model Context Protocol 服务。将客户端连接到一个 URL，登录后，AI 助手即可 在你的 i40Pilot 项目中读取和创建内容。

https://api.i40pilot.app/mcp

无需安装，也无需复制 API 密钥：服务使用 OAuth 2.1（PKCE、动态客户端注册）。你可以在授权页面选择 项目以及只读或读写权限，也可以随时撤销授权。

🇫🇷 i40Pilot 托管的 MCP 服务：将上述 URL 粘贴到你的 AI 客户端，登录并选择项目 和访问权限级别。随后，你的助手即可读取和创建仪表板、TRS/OEE、计划和 3D 零件。

60 秒快速试用

1. 连接 — 在 Claude.ai 中：Settings → Connectors → Add custom connector → https://api.i40pilot.app/mcp → Connect。登录或创建免费账户，然后选择一个项目。
2. 提问 — 在新对话中粘贴以下任一提示。前两个提示完全不需要数据：

计划 — 用 i40Pilot 规划一次变速箱大修：停机挂牌 1 小时、排油 1.5 小时、拆卸 3 小时、轴承作业 2.5 小时（需要先拆卸，且需要等待 4 小时的零件交付；交付从一开始就进行）、停机挂牌后检查传感器 1 小时、轴承和传感器检查完成后重新组装 2 小时、测试 1.5 小时。关键路径是什么？每项任务有多少时差？

3D — 用 i40Pilot 在钢制底座上设计一台齿轮电机：包括电机、法兰、焊接在支脚上的铸铁外壳、带键输出齿轮，并让每个螺栓都成为真实的连接件。然后给我看一张渲染图。

仪表板 — 先导入示例数据：下载 examples/data/machine-downtime-sample.xlsx（199 次停机、9 台机器、3 条产线、9 月），然后将其导入 i40Pilot → Spreadsheets。接着提问：使用我的 i40Pilot 工作簿“machine-downtime-sample”，创建一个停机仪表板：显示停机总分钟数、停机原因帕累托图，以及每条产线和每台机器的停机分钟数，并区分计划内和计划外停机。

在 Claude Code 或 Cursor 中，无需手动导入：Agent 可以自行上传文件（先调用 drive_create_upload_url，再调用 spreadsheet_create_workbook_from_file）。Claude.ai 聊天无法向 URL 发送文件，因此需要在那里手动导入。

一个连接，使用所有 i40Pilot 应用

应用	向 AI 客户端提问……
📊 仪表板和 OEE	“连接我的生产数据库，并按产线构建 OEE 操作台：可用率、性能、质量，以及停机原因帕累托图。”
📈 电子表格	“读取我上传的停机工作簿，并添加一列，显示停机时长（分钟）。”
🗓️ 甘特图和排程	“规划变速箱大修：有这 8 项任务和这些依赖关系——关键路径是什么？有哪些时差？”
🧊 3D 设计（文本转 CAD）	“在钢制底座上设计一台齿轮电机，让每个螺栓都成为真实的连接件，然后给我看一张渲染图。”
📅 日历	“在维护日历中安排大修，并邀请两位技术人员。”
📝 表单	“在停机申报表中添加一个‘根本原因’下拉菜单。”
🔄 Power BI	“将此仪表板导出到 Power BI。”

也可以用通俗语言，通过 i40pilot_chat 将整个请求交给 i40Pilot Agent。

连接客户端

客户端	操作方法
Claude.ai / Claude Desktop	Settings → Connectors → Add custom connector → 粘贴 URL → Connect
ChatGPT	Settings → Connectors → Create → 粘贴 URL → OAuth
Claude Code	claude mcp add --transport http i40pilot https://api.i40pilot.app/mcp，然后输入 /mcp 登录
Cursor	将 examples/cursor-mcp.json 添加到 .cursor/mcp.json
VS Code	将 examples/vscode-mcp.json 添加到 .vscode/mcp.json
脚本 / 服务	使用静态项目令牌，参见 docs/static-token.md

你需要一个 i40Pilot 账户 — 免费创建。

免费试用

免费计划支持使用全部 56 个工具 — 无需信用卡：

• 每月 500 次 MCP 调用
• 每月 100 个 AI 点数 — 20 个工具（读取、描述、排程）免费；大多数用于创建或更改内容的工具消耗 1 个点数；自动仪表板构建器消耗 10 个点数，信息图消耗 18 个点数。

需要更多？付费计划会提高这两项限额 — 详见 i40pilot.app。

工具

9 个领域共 56 个工具，另有一个对话式入口。完整列表：docs/tools.md。

领域	示例
Agent	i40pilot_chat — 用自然语言将完整请求交给 i40Pilot Agent 处理
仪表板（BI）	bi_create_dashboard、bi_add_widget、bi_run_dashboard_agent、bi_export_powerbi
数据源	bi_create_data_source_from_template、bi_introspect_schema、bi_create_dataset、bi_add_computed_column
电子表格	spreadsheet_create_workbook_from_file、spreadsheet_read_context、spreadsheet_update_rows
排程	schedule_cpm、schedule_dates、gantt_append_task、gantt_update_data
3D CAD（文本转 CAD）	drawboard_run_program、drawboard_view_render、drawboard_inspect_part
日历、表单、文件、信息图	calendar_create_events、forms_append_field、drive_create_upload_url、infographic_generate

服务会实时提供工具列表（tools/list）：新增功能无需你进行任何更新即可使用。

安全性

• 默认只读。 只有在授予写入权限后，写入工具才会显示。
• 仅限一个项目。 令牌绝不会访问其他项目。
• 以你的身份运行。 OAuth 调用会在你自己的行级权限下执行。
• 可撤销。 在客户端中移除连接，或在 i40Pilot 的 Connections 中移除连接。

发现漏洞？请在此代码库中使用 Security → Report a vulnerability（私密） — 请勿公开提交问题。

反馈

遇到 Bug、缺少工具或客户端无法连接？提交问题。请告诉我们你使用的客户端以及提出的请求。

许可证

此代码库中的文档和示例采用 MIT 许可证。i40Pilot 服务本身为专有软件。