OpenProject

OpenProject MCP サーバー

OpenProject API v3 向けの、書き込みに対応した包括的な Model Context Protocol サーバーです。41 個の専用ツールで、プロジェクト、作業パッケージ、添付ファイル、リレーション、ボード、ユーザー、ウォッチャー、通知、参照データを扱えます。

添付ファイル用ツールでは、作業パッケージ上のファイルを一覧表示し、その内容を取得できます。テキストベースのファイルは直接返され、バイナリファイルは埋め込み MCP リソースとして返されます。アップロードとダウンロードには、リクエストごとのサイズ制限があります。

このパッケージは、 OpenProject for Codex の一部として保守されており、Codex のワークフローガイダンスとポータブルインストーラーも含まれています。

MCP クライアントで実行する

以下の環境変数を設定します。

• OPENPROJECT_URL：OpenProject インスタンスのルート URL。
• OPENPROJECT_API_TOKEN：必要な権限のみを持つ API トークン。

既存の MCP 設定との互換性のため、OPENPROJECT_BASE_URL と OPENPROJECT_API_KEY もエイリアスとして使用できます。

オプションの設定：

• OPENPROJECT_PAGE_SIZE：コレクションのデフォルトページサイズ。1〜100（デフォルトは 25）。
• OPENPROJECT_TIMEOUT_MS：リクエストのタイムアウト。1000〜300000 ミリ秒（デフォルトは 30000）。
• OPENPROJECT_AUTH_MODE：幅広い互換性を持つ basic（デフォルト）、または OpenProject 17.2 以降向けの bearer。
• OPENPROJECT_ALLOWED_UPLOAD_DIRS：アップロードツールがファイルを読み取れるディレクトリ。プラットフォーム固有の区切り文字で区切ります（デフォルト：現在の作業ディレクトリ）。

次に、stdio サーバーを起動します。

npx -y openproject-codex-plugin

MCP 設定の例：

{
  "mcpServers": {
    "openproject": {
      "command": "npx",
      "args": ["-y", "openproject-codex-plugin"],
      "env": {
        "OPENPROJECT_URL": "https://tasks.example.com",
        "OPENPROJECT_API_TOKEN": "your-api-token"
      }
    }
  }
}

API トークンをコミットしたり、公開ログやスクリーンショットに含めたりしないでください。

機能

• プロジェクトの CRUD、件数取得、ネイティブフィルター、並べ替え、ページネーション。
• 作業パッケージの検索、CRUD、コメント、アクティビティ履歴、スケジュール、見積もり、進捗、階層、担当者、責任者、優先度、ステータス、バージョン。
• 添付ファイルの一覧表示、認証済み読み取り、ローカルファイルのアップロード、削除。
• リレーションとウォッチャーの管理。
• 現在のユーザーの検索、ユーザー検索、権限を考慮した担当可能なユーザーの取得。
• アプリ内通知とカンバン形式のボードの確認。
• ステータス、優先度、タイプ、バージョンの確認。
• /api/v3 配下の未対応パスに対する、GET のみの制限付きパススルー。

読み取り、書き込み、破壊的なツールには MCP アノテーションが付与されているため、互換性のあるクライアントは適切な確認ポリシーを適用できます。コレクションのレスポンスには、total、count、offset、pageSize、hasMore のメタデータが含まれます。

ライセンス

MIT