Planeja+

ChatGPT/Codex 插件 — Planeja+

适用于 ChatGPT 和 Codex 的 Planeja+ MCP 连接器 Agent Plugins 套件。 该插件仍在等待 OpenAI 批准并发布到公开目录。本仓库仅用于分发套件；Planeja+ 产品由另一个仓库维护。

连接自己的账号

经 OpenAI 批准并发布到目录后：

1. 在 ChatGPT 或 Codex 中打开插件并搜索 Planeja+。
2. 安装插件并选择 连接。
3. 使用自己的 Planeja+ 账号登录并授权连接。
4. 选择要查询或更新的公司。

你需要拥有 Planeja+ 账号。集成会访问该账号获准访问的公司数据，并遵循相应权限。

插件安装内容

• 在 mcp.json 中配置远程 MCP 服务 planejamais（https://planejamais.planejareconsultoria.com.br/api/mcp?toolsets=…），由客户端通过 OAuth 2.1（Dynamic Client Registration + PKCE）执行授权。
• planejamais 技能，包含使用流程、companyId 注意事项，以及破坏性操作的确认规则。
• extensions.com.openai.interface 中的目录元数据（名称、描述、类别、提示词和徽标）。

客户端通过浏览器执行 OAuth 授权，无需手动提供令牌。 可在 Planeja+ MCP 页面撤销授权。

Hermes Agent

同一套件也可作为便携式 Agent Plugins v1 套件（mcp.json + skills/，不含 Python 或可执行文件）安装到 Hermes Agent。你需要拥有 Planeja+ 账号。

从 Hermes 插件目录安装：

hermes plugins install planejamais
hermes plugins enable planejamais

也可以直接从此仓库安装：

hermes plugins install hendrykcosta75/planejamais-codex-plugin/plugins/planejamais --no-enable
hermes plugins enable planejamais

然后登录一次。Hermes 只会为你自行添加的 MCP 服务执行 OAuth，因此请使用相同名称添加服务：

hermes mcp add planejamais --url "https://planejamais.planejareconsultoria.com.br/api/mcp?toolsets=planejamentos,meu_espaco,agenda,meetings,notifications,tickets,users,dados_publicos" --auth oauth --connect-timeout 300

浏览器将打开 Planeja+ 登录页面（OAuth 2.1，采用 Dynamic Client Registration 和 PKCE、公共客户端及 loopback 回调）。批准访问后，工具将在下次会话中加载（或在执行 /reload-mcp 后加载）。如需再次登录，运行 hermes mcp login planejamais。请保留名称 planejamais：这样，你的条目就会取代插件中的服务条目，而插件仍会提供 planejamais 技能。你可以随时在 Planeja+ MCP 页面撤销访问权限。

安装前须知

• 写入和删除权限。 除读取工具（list_*、get_*、报告）外，服务还提供用于创建、更新和删除计划、目标、项目、步骤、看板、任务、清单、活动和工单的工具，也可结束会议、移除公司用户或更改其角色和状态。每次调用仅限于已登录账户所属的公司及其角色权限；后端会拒绝角色无权执行的操作。随附的技能会指示 Agent 先确认每项破坏性操作。
• 电子邮件和通知。 invite_company_user（仅限所有者）会向指定地址发送邀请邮件，带有提及成员的评论会通知被提及的成员。
• 信任。 该插件将其服务标记为 untrusted，因此 Hermes 会在每次非只读调用前征求确认，并在 cron 和无人值守运行中拒绝此类调用。按文档设置 OAuth（hermes mcp add planejamais）会将该条目替换为 Hermes 默认信任级别的原生条目，除非你设置 mcp_servers.planejamais.trust: untrusted。
• 网络和数据。 工具调用只会发送至 planejamais.planejareconsultoria.com.br；你请求的公司数据会作为工具输出返回给你的模型提供方。请参阅隐私政策。
• 远程工具集。 工具在运行时由远程 MCP 服务提供，不受固定提交版本的约束。
• 共享登录。 共用同一 Hermes 配置文件的聊天会共用同一 Planeja+ 登录状态。
• 无遥测、无付款。 此软件包不会收集遥测数据，也无法购买、签订合同或处理付款。

Cursor

同一文件夹也是 Cursor 插件：仓库根目录下的 .cursor-plugin/marketplace.json 指向 plugins/planejamais，其清单文件为 plugins/planejamais/.cursor-plugin/plugin.json。需要 Planeja+ 账户。

• MCP 服务。 mcp.cursor.json 将远程服务 planejamais 声明为 HTTP 服务。Cursor 会在浏览器中使用 OAuth 2.1（Dynamic Client Registration + PKCE）登录；插件中不会存储 API 密钥或令牌。
• 工具。 该 URL 会选择除 Editais e Projetos 之外的所有工具集，目录与 Codex 软件包相同。写入和删除工具仅限于已登录账户所属的公司及其角色权限，随附的技能会要求 Agent 确认破坏性操作。
• 技能。 skills/planejamais/SKILL.md 描述了工作流和 companyId 规则。
• 本地测试。 将 plugins/planejamais 复制到 ~/.cursor/plugins/local/planejamais，然后重新加载 Cursor 窗口。

该插件采用 MIT 许可（请参阅 LICENSE）。可在 Planeja+ MCP 页面撤销授权。

官方链接

• Planeja+ 集成
• 支持
• 隐私
• 使用条款

相同的政策文本也可在 docs/privacidade.md 中查看。 从软件包 1.0.7 起，清单中的隐私 URL 指向上述官方页面，该页面公开且无需身份验证即可访问。

供审核的演示

观看 ChatGPT 中的真实录屏。 演示使用的是专供审核人员使用的虚构公司。插件在目录中发布后，客户可连接自己的账户。

测试安装

使用 Codex CLI：

codex plugin marketplace add hendrykcosta75/planejamais-codex-plugin

然后，在 ChatGPT/Codex 应用中打开 Plugins Directory，选择 marketplace Planeja+ 并安装插件。在 ChatGPT 的开发模式下 （Settings → Apps & Connectors → Developer mode），也可以仅使用上述 URL 添加同一连接器，以测试 OAuth。

在目录中发布

在 OpenAI 插件门户（https://platform.openai.com/plugins）中选择 With MCP，并使用服务器的通用 URL 提交。产品指南中详细说明了要求和材料（已验证身份、提示词、测试用例、在 /.well-known/openai-apps-challenge 中验证域名，以及各工具的注释）。

维护

• 生产环境 URL 为 https://planejamais.planejareconsultoria.com.br/api/mcp。此软件包使用 ?toolsets=，包含除 editais_projetos 之外的所有分组，以使目录符合 Codex 每个插件 64.000 字节的工具限制。在服务器中创建新分组时，请评估是否将其纳入此处。 如果应用更改域名，请更新 plugins/planejamais/mcp.json 并提升版本。
• 发布新版本时，请递增 plugins/planejamais/plugin.json 中的 version。
• 请及时更新清单中引用的官方链接和资源文件。