EasyGerber: AI PCB design, layout, and routing

EasyGerber：AI PCB 设计、布局与布线

此软件包将编码 Agent 连接到 EasyGerber 托管的电路板设计工具。其公开文件包含工作流说明、连接元数据、图标和一个小型安装程序。电路板布局、布线和评分均在 EasyGerber 的服务器上运行。

此软件包及其插件说明的版本为 0.3.4。它新增了 submit_feedback 指引，用于提交经用户批准的错误报告、功能请求和一般反馈，这些内容会发送到 EasyGerber 的私人管理员收件箱。提交报告无需账户或新建电路板。开始新的电路板工作时，如果账户状态未知，它会直接启动访客电路板，而不会先探测 get_profile 等仅限账户使用的工具。现有访客会话和已授权账户会继续使用。此外，它还包含有关单独授权后删除账户电路板的说明。当已连接的服务提供托管工具时，系统会动态发现这些工具。这些说明不会扩大现有 OAuth 授权范围，也不会扩大安装程序的默认授权范围。

源代码可在公开集成仓库中获取。npm 安装程序和各平台插件软件包采用不同的客户端验证流程，并共用 EasyGerber 工作流技能和托管服务。

无需注册即可开始

访客优先访问时，请使用 https://www.easygerber.com/api/mcp。连接、初始化或发现工具均无需 EasyGerber 账户、OAuth 授权或 API 密钥。Agent 使用 start_guest_session 启动私人会话，然后使用其 guestToken 搜索目录并在该会话的唯一电路板上进行操作，包括布局、检查、预览和导出。请妥善保管令牌和私人查看器链接。

连接 URL	使用场景	登录
https://www.easygerber.com/api/mcp	通用 MCP 连接和访客优先的目录列表	访客无需登录；账户电路板、组织访问以及将访客电路板保存到账户时需要登录
https://www.easygerber.com/api/mcp/account	设置期间仅在客户端请求 OAuth 的已保存账户电路板	初始化或发现工具前必须登录；此连接不会以访客模式启动

Codex 安装程序、OpenAI 软件包和 Claude 软件包使用通用 URL。Grok 账户连接器以及下文的原生 Cursor 和 Antigravity 配置使用仅限账户的 URL。建立新的访客连接时，请勿设置身份验证；被拒绝的现有账户凭据必须重新授权，且不会自动切换为访客连接。有关会话限制和保存访客电路板的信息，请参阅 注册前试用。

Grok

连接 EasyGerber 账户一次后，即可在消费版 Grok 中打开并编辑已保存的电路板：

1. 在 Grok 中，打开 Plugins → New Connector → Custom。
2. 将连接器命名为 EasyGerber，并输入 https://www.easygerber.com/api/mcp/account 作为服务 URL。
3. 完成 EasyGerber 登录并选择 Allow access。然后让 Grok 按 EasyGerber URL 打开已保存的电路板，并进行所需修改。

例如：“打开这个已保存的 EasyGerber 电路板：[your board URL]。将其重命名为 LED indicator，然后重新读取以确认更改已保存。”

此账户入口要求在连接设置期间进行授权，并使用现有的 EasyGerber 工具和账户权限。若要新建与账户入口的连接，请完成常规登录流程。现有已发布的软件包配置仍使用 /api/mcp，支持访客使用和可选的账户授权。

2026 年 10 月 16 日，消费版 Grok 完成了授权确认，读取了一个现有的私有已保存电路板，保存了临时名称更改，并还原了原始名称。在 EasyGerber 网站上重新打开电路板后，确认了这两项更改。尚未测试 Grok Bot。由于测试浏览器不支持 WebGL，因此未验证浏览器中的 3D 渲染。此次消费版测试不能证明 Grok Build 具备交互式 OAuth 或由模型驱动的电路板工作流。

Cursor

公共代码仓库包含原生 .cursor-plugin/plugin.json 清单。它使用共享的 EasyGerber 技能和图片资源，并连接到 https://www.easygerber.com/api/mcp/account。此入口要求先进行账户授权，工具才能使用；请在 Cursor 的连接流程中完成 EasyGerber 登录并选择 Allow access。账户权限、套餐限制和生成费用仍然适用。

要通过官方 Cursor CLI 加载公共代码仓库的本地检出版本：

agent --plugin-dir .

输入 /mcp，选择 Easygerber (plugin)，然后选择 Manage Server → Login 以完成浏览器授权流程。然后询问：“打开这个已保存的 EasyGerber 电路板：[your board URL]。读取它当前的名称和元件。”Cursor 会管理账户凭据。无需使用 npm 安装程序；它仅配置 Codex。根目录中的 OpenAI 和 Claude 连接配置仍保留支持访客使用的 /api/mcp 访问权限。是否发布到 Marketplace 取决于 Cursor 的审核。

Antigravity

在 Antigravity 中，使用已发布的元件、自动布局与布线、原理图编辑和制造导出功能来设计和布局 PCB。公共代码仓库包含原生 Antigravity 元数据和共享的 EasyGerber 技能。其 MCP 连接使用 https://www.easygerber.com/api/mcp/account；账户权限、套餐限制和生成费用仍然适用。

使用当前 Antigravity CLI 从公共代码仓库安装插件并启动会话：

agy plugin install https://github.com/EasyGerber/easygerber-agent-plugin
agy

使用 /mcp 检查 EasyGerber 连接。Antigravity 请求账户授权时，请完成 EasyGerber 登录并选择 Allow access。然后询问：“打开这个已保存的 EasyGerber 电路板：[your board URL]。读取它当前的名称和元件。”Antigravity 会管理账户凭据。无需使用 npm 安装程序。是否发布到 Marketplace 取决于 Antigravity 的审核。

参阅官方的 插件指南 和 MCP 指南。

Cline

Cline 可以通过 Streamable HTTP 直接连接到 EasyGerber 托管的 MCP 端点。请使用已安装并配置好模型的 Cline。此仓库中的 npm 设置安装程序仅配置 Codex；它不是 Cline 的安装方式。新建访客连接无需本地 EasyGerber 服务、构建步骤或 API 密钥。

在 Cline IDE 面板中，打开 MCP Servers → Remote Servers，将 EasyGerber 填为服务名称，将 https://www.easygerber.com/api/mcp 填为服务 URL，选择 Streamable HTTP，然后选择 Add Server。访客访问无需设置身份验证。

或者，打开 MCP Servers → Configure → Configure MCP Servers，将此条目合并到现有的 mcpServers 对象中，并保留其他服务和设置：

{
  "mcpServers": {
    "easygerber": {
      "type": "streamableHttp",
      "url": "https://www.easygerber.com/api/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

明确指定 streamableHttp 类型很重要：省略它会让 Cline 选择旧版 SSE。请保持工具审批启用。如果 easygerber 已存在，请检查该条目，而不要替换它或创建重复项。

使用当前版本的 Cline CLI，可通过以下等效配置命令进行配置：

cline mcp add easygerber https://www.easygerber.com/api/mcp --transport http --yes

此命令会保存连接配置；仅凭此命令本身无法证明设置成功。在 Cline 中确认连接成功，并且能看到 EasyGerber 工具，例如 search_parts、get_part 和 start_guest_session。若仅检查安装情况，请在发现工具后停止；不要启动访客会话、创建或修改电路板、生成布局、导出文件或发送反馈。

对于之后由用户请求的电路板操作，访客访问在注册前每个会话仅支持一块电路板。保存到账户的电路板需要获得 EasyGerber OAuth 授权同意。在连接设置期间要求授权的客户端，可以使用上文单独介绍的 https://www.easygerber.com/api/mcp/account 条目。账户授权和电路板工作流需要单独使用 Cline 进行验证；访客连接检查不会验证这些功能。

这些说明遵循官方的 Cline MCP 指南。2026 年 10 月 18 日，Cline CLI 3.0.73 读取了提议的 README，并在一个工具审批已启用的空白隔离配置文件中写入了原生连接配置。另一次检查使用其已安装的 @cline/core 0.0.95，在未经身份验证的情况下连接并发现了 17 个 EasyGerber 工具。Agent 本身并未验证工具发现情况。未调用任何 EasyGerber 工具；OAuth 和电路板操作均未测试。

Kiro

通过 Powers → Add Custom Power 安装 Kiro power 文件夹，或从此公开仓库的本地检出目录运行 kiro-cli --v3 powers install ./kiro，然后启动 kiro-cli --v3。无需使用 npm 安装程序。该 power 使用支持访客访问的 /api/mcp 入口，并在其技能中包含完整的 EasyGerber 工作流。

2026 年 10 月 18 日，Kiro CLI 2.32.0 V3 导入并明确激活了该 power，读取了完整技能，并在无需 EasyGerber 身份验证的情况下发现了 17 个托管工具。其原生访客工作流选择了已发布的部件，创建并修订了电路板，完成了布局生成，读取了预览数据，检查了阻塞项，并导出了制造文件和 EasyGerber 文件。另行配置的 /api/mcp/account 连接完成了 OAuth，并在恢复同一对话后成功将该访客电路板保存到个人账户；随后读取确认了账户中的电路板及其已保存的布局。另一次独立的浏览器检查渲染了已保存电路板的 3D 部件。

在此 CLI 版本中，该 power 的会话中自动 OAuth 未能完成。有关账户操作和保存访客电路板，请参阅 Kiro README 中的可选账户连接和恢复说明。请在 Kiro 的本地回调侦听器运行期间完成浏览器授权；此前一次账户端点尝试在约 60 秒后过期，这与该 power 的会话中授权状态错误无关。Kiro 中的令牌刷新、删除、反馈和仅通过关键词激活仍未经过测试。目录审核与这些检查相互独立。

Gemini CLI

在当前的 Gemini CLI 中安装 EasyGerber 扩展。Gemini 的模型登录与 EasyGerber 相互独立：新的 EasyGerber 访客连接无需账户或 API 密钥。

gemini extensions install https://github.com/EasyGerber/easygerber-agent-plugin
gemini extensions list
gemini skills list
gemini mcp list

检查扩展的 MCP 连接，并接受常规安装提示。安装后，重启已打开的 Gemini 会话。确认 easygerber 扩展和共享技能已启用，并且 EasyGerber MCP 连接可用。具有相同服务或技能名称的现有用户或工作区设置可能优先于扩展；如果显示的连接或技能来自其他来源，请检查这些设置。

该扩展通过 Streamable HTTP 连接到 https://www.easygerber.com/api/mcp，并加载现有的 skills/easygerber 工作流。它不包含本地 EasyGerber 服务或引擎。保持启用 Gemini 的常规工具批准提示。尝试：“使用 EasyGerber，根据此固件中的引脚分配创建一块电路板。”Agent 会选择已发布的组件，并使用上文所述的访客工作流。

已通过 Gemini CLI 0.65.0 验证：扩展安装、共享技能发现，以及 MCP 连接已激活。另使用该已安装 CLI 的 MCP 传输进行了检查，发现了 17 个工具，并完成了访客会话创建、已发布零件搜索和零件查询。此检查未涉及交互式模型会话、电路板创建、布局、导出或账户授权。

对于已保存到账户的电路板，或将现有访客电路板保存到账户，Gemini 记录了交互式命令 /mcp auth easygerber。完成 EasyGerber 授权后，继续原始任务；如果适用，还需认领访客电路板。访客发现流程无法验证账户 OAuth、令牌刷新或工具调用期间的自动授权。请参阅 Gemini 的 MCP 授权文档。

该扩展通过此仓库及其专用 Gemini 发布归档进行分发。若要更新已安装的副本，请运行 gemini extensions update easygerber。gemini-cli-extension 仓库主题可启用图库的每日发现流程；图库索引与发布相互独立，也不代表 Google 背书或在消费者版 Gemini 应用中分发。

Devin

公开源码导出内容包含 .devin-plugin/plugin.json，它连接到支持访客访问的 https://www.easygerber.com/api/mcp 端点，并加载现有的 skills/easygerber 工作流和作品。Devin 自身的账户登录与 EasyGerber 授权相互独立。新的 EasyGerber 访客连接无需账户或 API 密钥。

如需在本地验证，请使用已登录 Devin CLI 的公开集成仓库检出版本：

devin plugins install --local .
devin

安装后启动一个新会话，并使用 /easygerber:easygerber 加载工作流。保持常规工具审批启用。如需进行最简连接检查，可询问：“以访客身份使用 EasyGerber，查找一个已发布的两针连接器，并确认其目录引脚。不要创建电路板。”Agent 会启动一个访客会话并使用目录工具；必须对访客令牌和私人查看器链接保密。

2026 年 10 月 20 日，Devin CLI 3000.11.92 安装了生成的本地软件包，并发现其共享技能和托管 MCP 配置。使用 Free 账户可用的 SWE-1.6 Slow 模型启动全新的原生会话后，系统创建了一个访客会话，搜索已发布的连接器，并读取返回的元件以确认其两个目录引脚。此次未测试创建电路板、布局、导出或 EasyGerber 账户授权。先前尝试使用 SWE-2 时因需要 Pro 而在调用工具前停止；未购买付费升级。市场审核和上架与这些原生检查是分开的。

Devin 文档介绍了用于插件 OAuth 连接的 devin mcp login easygerber。账户访问、访客转账户的后续流程以及电路板工作流都需要单独进行原生验证；安装插件或列出工具并不能证明这些功能已验证。市场提交和上架与共享软件包的发布检查分开进行。请参阅官方的 Devin 插件指南。

VS Code 或终端中的 Codex

需要 Node.js 22 或更高版本以及 Codex。安装 0.3.4 版本：

npx @easygerber/[email protected] setup --dry-run
npx @easygerber/[email protected] setup
npx @easygerber/[email protected] doctor

安装程序会安装 ~/.agents/skills/easygerber，并向 $CODEX_HOME/config.toml（默认为 ~/.codex/config.toml）添加一个小型托管 MCP 表。它会保留现有的 TOML 文本和其他服务。所有权凭据位于 ~/.easygerber/agent-plugin/codex-install.json。不会修改任何项目文件或固件。Codex 是默认且唯一的安装目标；使用可选参数 --client codex 可明确指定该目标。所有命令都支持无人值守使用，脚本也可以使用 --yes。

设置完成后，重启 Codex 聊天窗口或 IDE，然后询问：“创建一块小型 3.3 V LED 电路板，显示预览，并导出生产文件和 EasyGerber 文件。”Agent 会使用你已连接的账户，或自动通过 https://www.easygerber.com/api/mcp 启动访客电路板。

如需使用已保存到账户中的电路板或开展组织工作，请在 MCP 设置中连接 EasyGerber。如果已安装 Codex CLI，请运行：

codex mcp login easygerber

客户端会打开账户授权流程并保存凭据。托管 MCP 配置会请求 boards:read、boards:write、boards:generate、boards:export 和 offline_access，因此账户授权涵盖常规电路板工作流和可续期访问权限，但不包括删除操作。删除需要单独明确授予 boards:delete 权限；已有的 boards:write 授权不足以执行删除。组织权限、账户限制和用户的授权仍会控制账户访问。安装程序不会请求、读取或存储访问令牌或访客权限。doctor 会检查本地配置和技能完整性，但不会验证身份验证、访客模式或在线服务是否正常工作。

试试：“使用 EasyGerber，根据这份固件中的引脚分配创建一块电路板。”Agent 会读取相关的本地代码、选择已发布的元件，并通过 MCP 服务发送电路板要求。常规账户权限范围为 boards:read、boards:write、boards:generate 和 boards:export；组织权限、配额和账单仍适用。

注册前试用

EasyGerber 生产环境中的 MCP 服务现已开放访客访问，并使用已发布的元件目录。Agent 可以在每个会话中创建一块电路板，并在注册前不限次数地编辑、布局、检查、预览，以及导出制造用 ZIP 或 .egb 文件。电路板和会话不会自动过期。常规的请求速率、电路板复杂度和共享计算资源保护措施仍然适用。服务返回 limits: { boards: 1 }；expiresAt: null 表示不会按计划过期。电路板数量限制针对会话，而非经过验证的个人。

Agent 会在其工具上下文中保留访客凭证。请保存其私密查看器链接，以便返回电路板；任何拥有该链接的人都能访问访客设计。原始令牌和该链接都不应放入固件代码仓库、公开问题或诊断日志。查看器会移除令牌片段，并使用私密浏览器会话。访客访问依赖于保留该凭证或链接；创建另一个会话无法找回丢失的凭证。下载链接会在十五分钟后过期，导出对象自创建起二十四小时后便可清理。这些产物限制不会使访客电路板过期。

如需拥有账户所有权、通过账户恢复，以及在常规套餐下使用更多电路板，请从私密查看器登录或创建账户。完成登录交接后，查看器会自动将电路板保存到你的个人账户。如果在已登录的浏览器中仅打开访客预览，电路板仍会保留为访客电路板。在包含访客电路板的 Agent 任务中，选择登录或处理账户电路板也会一并保存该电路板，无需单独确认 保留电路板。但如果登录仅用于删除账户电路板或提交反馈，则例外：Agent 会使用 claim_guest_board 和原始访客令牌启动授权，并在完成常规账户授权后重试认领。通用原生设置中的 Authenticate 没有访客电路板上下文，因此 Agent 必须在登录后继续认领；仅有回调不会保存电路板。

认领成功后会返回新的账户电路板 ID，并结束访客访问。Agent 会在继续修改前读取该账户电路板。如果布局仍在运行，Agent 会等待并自动重试，不会取消任务；如果认领失败或响应丢失，Agent 会保留原始令牌以便安全重试。请重复使用原始访客会话；不要创建额外会话来绕过电路板数量限制或服务保护措施。过期的账户连接必须重新授权；它不会悄然变成访客连接。

删除账户看板

明确要求删除指定的账户看板。Agent 会读取其当前修订版本，并且只会针对该请求调用 delete_board。删除是永久性的，无法恢复，并且会取消看板上的活动任务。创建、编辑或导出看板均不代表授权删除或清理。

删除需要单独授予 boards:delete OAuth 权限，并且用户必须是个人所有者，或拥有组织所有者/管理员角色。安装程序和默认客户端配置不会请求此权限范围；客户端必须支持获取额外授权。现有的 boards:write 授权无法删除看板。仅限于先前权限范围的客户端注册，必须通过客户端正常的重新连接或注册流程主动更新或替换，之后才能请求删除授权。现有注册和授权不会自动获得删除权限。无法通过此工具删除访客看板，Agent 不得为了删除而声称拥有该看板。仅为删除账户看板而登录，并不代表授权认领无关的访客看板。

对于没有配置 OAuth 客户端 ID 的 Codex 安装程序 easygerber 连接，请使用以下命令明确启用删除功能；已通过 Codex CLI 0.163.0-alpha.10.2 验证：

codex mcp logout easygerber
codex mcp login easygerber \
  --scopes boards:read,boards:write,boards:generate,boards:export,boards:delete,offline_access \
  --oauth-client-registration dcr

注销会清除本地缓存的客户端 ID 和令牌。登录会使用列出的权限范围创建新的动态客户端注册，并打开浏览器以获取新的授权，包括删除权限。这些标志仅适用于本次登录；不会更改 config.toml 中由安装程序管理的权限范围。注销不会撤销先前在服务端创建的客户端或授权。请参阅 Codex CLI 权限范围选择和注销实现。

即使启用了此标志，配置了 OAuth 客户端 ID 的连接也会绕过动态注册。客户端要获取新的授权，其提供方注册必须允许 boards:delete；上述命令并不能通用地解决原生插件或其他客户端的问题。请参阅 Codex OAuth 客户端注册。获得授权后，Agent 仍会再次读取指定的账户看板，并且只会在用户明确要求时删除。

只有成功返回 { boardId, deleted: true } 才能确认删除。在具备所需 OAuth 权限范围时，看板不可用、所有权不足，以及对不存在的看板重复发出请求，都会返回 not_found；此结果不能证明发生过删除。如果响应丢失，Agent 会报告状态不确定，而不会将之后看板缺失的结果视为确认。

发送反馈

让你的 Agent 向 EasyGerber 发送错误报告、功能请求或一般反馈。只有在你提出请求或同意后，它才会使用 submit_feedback，将修剪后长度为 10–2000 个字符的简明消息发送到私人管理员收件箱。它不会自动发送对话记录、原始诊断信息、板卡导出文件、凭据或私人链接。提交成功后会返回回执 ID 和时间戳；这不代表承诺回复或纳入路线图。

常规 /api/mcp 连接接受匿名反馈，无需登录、启动访客会话或创建板卡。已连接的账户或现有有效访客会话可以标明报告的归属。无需额外的板卡权限范围，默认安装程序的权限范围保持不变。无效的现有凭据仍会被拒绝，不会悄然变成匿名状态。仅为发送反馈而登录，并不授权认领访客板卡。仅限账户的连接仍要求在设置期间登录。

Agent 在不确定的提交需要重试时，会保留相同的 UUID requestId，以及完全相同的报告内容和归属信息。如果工具、连接或服务不可用，请使用 GitHub Issues。GitHub issues 是公开的，发布时需要 GitHub 账户：发布前请检查并删去报告中的敏感信息，切勿包含凭据、私人链接或机密板卡数据。

ChatGPT 和原生 Codex 插件

可移植的根清单和 mcp.json 支持提交至 OpenAI 的插件目录审核。它们声明了混合公开访问和 OAuth 访问：访客无需账户授权即可发现工具，账户操作则使用已注册的公开 OAuth 客户端，并采用 PKCE 和常规授权流程。其客户端 ID 是公开元数据，不是凭据。这不会改变 npm 安装程序自动注册 Codex 的行为。每个客户端都需要分别检查访客发现和可选的账户授权；软件包验证并不能证明已获目录批准或被原生客户端接受。原生 Codex 软件包使用单独的兼容清单和 MCP 文件，并支持自动 OAuth 发现；它不会复制仅供目录使用的客户端 ID。请在受支持的桌面客户端中使用该原生软件包，或在终端和 IDE 中使用 Codex 时采用上述独立安装方式。可移植目录 ZIP 与原生 ZIP 不能互换。请避免在同一客户端中安装重复集成。

对于仅在设置期间请求账户授权的自定义连接器，如需访问已保存的账户板卡，请使用 https://www.easygerber.com/api/mcp/account，并在连接时完成登录和授权。此账户入口要求在初始化之前完成 OAuth，并使用相同的工具、权限和板卡服务。如需优先以访客身份访问，请使用 https://www.easygerber.com/api/mcp；此连接上的账户授权为可选项。

两个入口使用不同的 OAuth 资源。选择账户入口时，请新建连接；现有客户端注册和令牌仍绑定到原来的资源。请勿在两个入口之间复制令牌。已发布的软件包清单会保留其现有连接 URL。

Claude

Claude 软件包已在公开仓库的 claude 文件夹中准备就绪，其中包含 .claude-plugin/plugin.json 和 .mcp.json。它与 OpenAI 软件包共用 EasyGerber 技能、素材和托管服务。npm 安装程序仍仅支持 Codex。如需使用 Claude Code 2.1.281 或更高版本进行本地验证和加载，请在公开仓库的检出副本中执行：

claude plugin validate ./claude --strict
claude --plugin-dir ./claude

在 Claude Code 中使用 /mcp 检查 EasyGerber 连接，并在需要时授权账户访问。在 Claude 对话和 Cowork 中，可从插件的 Connectors 选项卡添加或连接 EasyGerber。EasyGerber 已在 Claude 目录中获批并发布，可通过 /api/mcp 访客访问。

更新与移除

运行 npx @easygerber/[email protected] setup，然后重启 Codex 聊天或 IDE，以加载最新的访客启动、账户保存、删除和反馈说明。从 0.2.x 升级还会将已弃用的名称 score_board 替换为 check_board_layout；不提供兼容别名。

运行新版软件包中的 setup，可更新未更改的受管理文件。重复执行相同的设置操作不会产生任何变化。如果 MCP 条目冲突或技能文件已修改，设置操作会停止，不会替换该文件。请保留该文件，或自行将其移至其他位置后重试。为避免更改意外位置，系统会拒绝符号链接形式的受管理目标。

npx @easygerber/[email protected] uninstall --dry-run
npx @easygerber/[email protected] uninstall

卸载时只会移除未更改的文件和未更改的受管理连接，并保留无关设置和已修改文件。系统会报告保留的路径，并保留其所有权凭据。请在 Codex 或 EasyGerber 中单独撤销账户连接；删除本地文件不会撤销 OAuth 授权，也不会使现有访客查看链接失效。访客访问权限会在认领或撤销后结束，不会通过自动计时器结束。已弃用的访客数据在认领或撤销 24 小时后可供清理；已认领的账户副本仍可访问。中断的设置操作可以根据其凭据恢复。如果仍存在过期的安装程序锁，请先确认没有安装程序进程正在运行，再移除 CLI 报告的锁路径。

网络与数据

此集成会直接连接到 https://www.easygerber.com/api/mcp；对于原生 Cursor 和 Antigravity 配置以及面向消费者的 Grok 账户连接器，则会连接到 /api/mcp/account。授权使用所选条目所公布的元数据和账户流程。工具请求可能包含你为任务批准的电路板要求、元件选择、原理图编辑、电路板或组织标识符，以及反馈消息。EasyGerber 会返回生成的制品链接。托管服务会保留 Agent 活动分析数据一年，其中包括电路板被认领后的访客历史记录。安装程序不会上传代码仓库、检查环境文件、运行生命周期钩子或收集遥测数据。常规 npm 软件包获取由 npm 处理。

请参阅集成文档与支持、隐私政策和条款。

维护者验证与发布

公共仓库的默认分支为 main。方形 Grok 市场 Logo仅导出到仓库中，不会包含在 npm 和插件软件包内。归档标签 codex/grok-submission-assets 保留了原始艺术作品 URL。

仓库的 server.json 声明了MCP Registry 条目 io.github.EasyGerber/easygerber的 0.1.1 版本，并使用通用 URL https://www.easygerber.com/api/mcp 进行访客发现和可选账户授权。导入 Registry 元数据的目录应使用该 URL，以优先支持访客访问。上文另有账户专用的客户端配置。清单仅导出到公共仓库；npm 和插件软件包不包含本地 MCP 服务或私有引擎。Registry 版本 0.1.1 独立于 npm 和插件版本 0.3.4，用于跟踪托管服务元数据。 产品常规的保存和发布脚本不会发布到 npm、公共集成仓库或 MCP Registry。私有检出目录中的 npm run release:agent-plugin -- --output <directory> 会准备经过净化的构件；npm run check:agent-release -- --release-dir <directory> 会对其进行验证。只将生成的 public-source 文件发布到现有公共仓库，并保留已审核的客户端配置。使用 mcp-publisher validate 验证 public-source/server.json，然后使用 mcp-publisher publish 在现有 Registry 身份下发布，并核验最新元数据。Registry 版本不可变，因此，Registry 元数据发生变化时，必须独立于 npm 软件包发布新 Registry 版本。

对于 npm 版本 0.3.4，请在 <directory>/public-source 中运行 npm pack --ignore-scripts --pack-destination ..。在私有检出目录中，使用 npm run check:agent-release -- --release-dir <directory> --npm-tarball <directory>/easygerber-agent-plugin-0.3.4.tgz 验证生成的归档。使用 npm publish <directory>/easygerber-agent-plugin-0.3.4.tgz --access public 发布这个经过验证的确切归档。

该软件包包含安装器运行时、连接元数据、技能和资源。公共仓库还包含一个 GitHub Actions 工作流和安装器冒烟测试。每当推送代码或创建拉取请求时，工作流都会使用 Node.js 22 和 24，在 Linux、Windows 和 macOS 上检查打包后的安装器。测试使用临时用户配置文件，不会连接 EasyGerber，也不会使用账户凭据。这些检查涵盖安装行为；但不能证明在特定 Agent 客户端中通过了身份验证或电路板操作测试。实际运行状态请参阅 Actions 结果。

生产服务支持访客创建、布局、预览、阻塞项检查、两种导出方式和账户保存。发布时，必须使用确切的软件包和客户端验证这些操作以及登录后的继续流程；较早进行的服务或软件包检查不能证明新的客户端构件符合验收要求。

工作流和冒烟测试不会包含在 npm 软件包和插件 ZIP 文件中。更全面的回归测试套件和发布工具仍保留在 EasyGerber 的私有开发检出目录中。这些工具会根据明确的文件允许列表生成 OpenAI ZIP、Claude ZIP 和公共源代码，并验证生成的归档内容。公共源代码包含一个生成的 claude 文件夹：请在现有仓库中提交该插件路径。Claude 需要单独的文件夹，因为根目录 npm 安装器包含一个 bin/ 目录，而 Claude 聊天和 Cowork 无法安装该目录。发布过程中会从规范来源复制共享技能和美术资源；维护者无需编辑第二份副本。导出的安装器运行时仅使用 Node.js 内置模块和公共 smol-toml 解析器；它不会导入 EasyGerber 的私有软件包。Claude 软件包仅包含文档、美术资源和远程连接元数据。

同一发布流程还会根据共享元数据生成根目录 .cursor-plugin/plugin.json。其内嵌 MCP 连接会选择账户入口，不会更改根目录 OpenAI 身份验证设置。Cursor 使用现有的根目录技能和资源；无需维护单独的副本。Cursor 清单仅包含在公共仓库中，不包含在 npm 软件包和 OpenAI/Claude ZIP 文件中。请提交公共仓库 URL 以供 Cursor 审核。

Antigravity 使用生成的 .antigravity-plugin/plugin.json 和根目录 mcp_config.json，并使用相同的根目录技能和美术资源。这两个文件仅包含在公共仓库中，不包含在 npm 软件包和 OpenAI/Claude ZIP 文件中。根目录 OpenAI 清单和其他客户端的配置均保持不变。 Kiro 使用生成的八文件 kiro 文件夹，其中包含标准 Agent Plugins 清单和支持访客访问的端点。由于在测试过的原生会话中，相对工作流引用无法解析，因此其技能内联包含了完整的规范工作流。独立的参考文件保持不变。Kiro 文件夹仅存在于仓库中，不会向 npm 包或 OpenAI/Claude ZIP 包添加文件；提交其公开文件夹 URL 供 Kiro 审核。

Gemini CLI 使用生成的根目录 gemini-extension.json 和同一个根目录技能。其 Streamable HTTP 配置使用 httpUrl，并将授权设为可选，以支持访客访问。此版本还会生成 easygerber-gemini-extension-0.3.4.zip，其中包含清单、共享技能和工作流参考、图稿、README 及许可证。清单和 Gemini 压缩包不属于 npm 包或其他客户端的包。将经过验证的压缩包作为对应 GitHub 发布版本中唯一可安装的资源发布；从仓库 URL 安装时，Gemini 优先选择最新发布版本。保留历史发布版本，包括评审视频，并确保最新发布版本中包含有效的扩展压缩包。Gemini 分发无需发布到 npm。

Devin 使用生成的根目录 .devin-plugin/plugin.json、共享根目录技能和 assets/logo.svg。其内联 MCP 配置选择了支持访客访问的通用端点；Devin 原生清单不会自动读取可移植的根目录 mcp.json。这些仅存在于仓库中的元数据不会向 npm 包或其他客户端的压缩包添加文件。市场条目需引用现有公开仓库中经审核的完整提交 SHA。提交前，请遵循市场的原生安装流程和实际工具调用要求。发布仅包含仓库元数据的更新时，请保留已发布的 Gemini 版本及其资源。

发布前，请确认你拥有 npm 作用域、官方公开集成仓库和供应商发布身份的所有权。验证生产环境登录，并在受支持的客户端中完整执行一次创建／修改／生成／导出流程。从公开导出内容运行 npm pack --dry-run --json 并检查结果。仅发布经过清理的包／仓库；产品单体仓库及其历史记录必须保持私有。此包中的图标和上架文案是可编辑的发布材料，并不能证明已通过市场审核。不要添加 npm 安装生命周期钩子。

MIT 许可证仅适用于此集成包，不适用于托管服务或私有引擎。