Planeja+

ChatGPT/Codex プラグイン — Planeja+

ChatGPT と Codex 向けの Planeja+ MCP コネクターの Agent Plugins パッケージです。 公開カタログへの掲載は、OpenAI による承認と公開を待っている段階です。 このリポジトリは配布パッケージのみを収録しており、Planeja+ 製品は 別のリポジトリで管理されています。

自分のアカウントを接続する

OpenAI のカタログで承認・公開された後：

1. ChatGPT または Codex で「プラグイン」を開き、Planeja+ を検索します。
2. プラグインをインストールし、接続を選択します。
3. 自分の Planeja+ アカウントにサインインして、接続を承認します。
4. 照会または更新する会社を選択します。

Planeja+ アカウントが必要です。この連携では、そのアカウントでアクセスが許可されている会社のデータに接続し、アカウントの権限に従います。

プラグインのインストール内容

• クライアントが実行する OAuth 2.1（Dynamic Client Registration + PKCE）を使用する、mcp.json 内のリモート MCP サーバー planejamais（https://planejamais.planejareconsultoria.com.br/api/mcp?toolsets=…）。
• 使用フロー、companyId の取り扱い、破壊的な操作の確認ルールを記載した planejamais スキル。
• extensions.com.openai.interface 内の掲載メタデータ（名前、説明、カテゴリ、プロンプト、ロゴ）。

クライアントはブラウザー経由で OAuth 認可を実行するため、手動でのトークン入力は不要です。 認可はPlaneja+ MCP ページでいつでも取り消せます。

Hermes Agent

同じパッケージをHermes Agent にも、ポータブルな Agent Plugins v1 パッケージ（mcp.json + skills/、Python と 実行ファイルは不要）としてインストールできます。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+ のサインインページが開きます（Dynamic Client Registration と PKCE を使用する OAuth 2.1、パブリッククライアント、ループバックコールバック）。アクセスを承認すると、次のセッションで（または /reload-mcp の実行後に）ツールが読み込まれます。再度サインインするには、hermes mcp login planejamais を実行します。名前は planejamais のままにしてください。これにより、プラグインのサーバーエントリーが自分のエントリーに置き換わり、プラグインは引き続き planejamais スキルを提供します。アクセスはPlaneja+ MCP ページでいつでも取り消せます。

インストール前に

• 書き込みおよび削除アクセス。 読み取りツール（list_*、get_*、レポート）に加えて、このサーバーは計画、目標、取り組み、ステップ、ボード、タスク、チェックリスト、イベント、チケットを作成、更新、削除するツール、会議を終了するツール、会社のユーザーを削除したり、ロールやステータスを変更したりするツールを提供します。すべての呼び出しは、サインイン中のアカウントが所属する会社とロールに制限されます。ロールで許可されていない操作はバックエンドが拒否します。付属のスキルでは、破壊的な操作を実行する前に毎回確認するようエージェントに指示しています。
• メールと通知。 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 は HTTP 経由のリモートサーバー planejamais を宣言します。Cursor はブラウザーで OAuth 2.1（Dynamic Client Registration + PKCE）を使ってサインインします。プラグインには API キーやトークンは保存されません。
• ツール。 URL は Editais e Projetos を除くすべてのツールセットを選択します。これは Codex パッケージと同じカタログです。書き込みおよび削除ツールは、サインイン中のアカウントが所属する会社とロールに制限されます。また、付属のスキルでは、破壊的な操作を実行する前に確認するようエージェントに指示しています。
• スキル。 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 を開き、マーケットプレイス Planeja+ を選択してプラグインをインストールします。ChatGPT の開発モード（Settings → Apps & Connectors → Developer mode）では、OAuth をテストするために、上記の URL だけで同じコネクターを追加できます。

ディレクトリへの公開

提出は、ユニバーサルサーバー URL を使用して、OpenAI のプラグインポータル （https://platform.openai.com/plugins）の With MCP オプションから行います。要件と資料（認証済みの ID、プロンプト、 テストケース、/.well-known/openai-apps-challenge での ドメイン検証、ツールごとのアノテーション）の詳細は、製品ガイドに記載されています。

メンテナンス

• 本番 URL は https://planejamais.planejareconsultoria.com.br/api/mcp です。このパッケージでは、Codex プラグインあたりの ツール数の上限である 64,000 バイト以内にカタログを収めるため、editais_projetos を除くすべてのグループを ?toolsets= で指定しています。サーバーに新しいグループを追加する際は、ここに含めるかどうかを検討してください。 アプリのドメインを変更した場合は、plugins/planejamais/mcp.json を更新し、バージョンを上げてください。
• 新しいバージョンを公開する際は、 plugins/planejamais/plugin.json の version をインクリメントしてください。
• マニフェストで参照されている公式リンクとアセットを最新の状態に保ってください。