dooray-mcp-js

Node.js で実装された Dooray MCP サーバーです。dooray-go/dooray-mcp のツール名と API の動作に従っていますが、Go や Homebrew は必要ありません。

要件

• Node.js 18 以降

• Dooray 個人 API トークン

Related MCP server: mcp-gdocs

公式ドキュメント

• Dooray API 公式ドキュメント

対象範囲

この MCP サーバーはすべての Dooray API をラップしているわけではありません。頻繁に使用されるアカウント、カレンダー、プロジェクト、投稿、添付ファイル、メッセンジャー API に焦点を当てています。

ほとんどの /admin/v1 および /admin/v2 管理 API は、特に書き込み可能な管理エンドポイントについては、デフォルトでは意図的に公開されていません。

読み取り専用モード

Dooray 個人 API トークンは、読み取り専用と書き込みの権限が別々に発行されるわけではありません。書き込み API を呼び出せるトークンは、Dooray API レベルでは依然としてその権限を持っている可能性があります。

より安全なインストールのために、このサーバーは MCP ツール層で読み取り専用モードを提供します。読み取り専用モードでは、書き込み可能なツールは tools/list に公開されず、tools/call を通じて呼び出すこともできません。

実行

npx -y dooray-mcp-js --token "{personal-token}"

環境変数を使用することもできます:

DOORAY_TOKEN="{personal-token}" npx -y dooray-mcp-js

読み取り専用ツールのみを公開して実行:

DOORAY_TOKEN="{personal-token}" npx -y dooray-mcp-js --mode read-only

Codex

パッケージを Codex に直接登録します:

codex mcp add dooray-mcp-js --env DOORAY_TOKEN="$DOORAY_TOKEN" -- npx -y dooray-mcp-js

トークンがまだ DOORAY_TOKEN にない場合は、登録時に渡します:

codex mcp add dooray-mcp-js --env DOORAY_TOKEN="{personal-token}" -- npx -y dooray-mcp-js

サーバーは Codex が起動したときに DOORAY_TOKEN を読み取るため、トークンをコマンド引数に含める必要はありません。

Codex 読み取り専用登録

同じパッケージとトークンで 2 つ目の MCP サーバーを登録しますが、読み取り専用ツールのみを公開します:

codex mcp add dooray-mcp-js-read-only --env DOORAY_TOKEN="$DOORAY_TOKEN" -- npx -y dooray-mcp-js --mode read-only

環境変数でモードを設定することもできます:

codex mcp add dooray-mcp-js-read-only --env DOORAY_TOKEN="$DOORAY_TOKEN" --env DOORAY_MCP_MODE=read-only -- npx -y dooray-mcp-js

Claude Desktop

{
  "mcpServers": {
    "dooray-mcp-js": {
      "command": "npx",
      "args": ["-y", "dooray-mcp-js"],
      "env": {
        "DOORAY_TOKEN": "{personal-token}"
      }
    }
  }
}

読み取り専用の Claude Desktop 設定:

{
  "mcpServers": {
    "dooray-mcp-js-read-only": {
      "command": "npx",
      "args": ["-y", "dooray-mcp-js", "--mode", "read-only"],
      "env": {
        "DOORAY_TOKEN": "{personal-token}"
      }
    }
  }
}

Claude Code

claude mcp add dooray-mcp-js --env DOORAY_TOKEN="{personal-token}" -- npx -y dooray-mcp-js

読み取り専用登録:

claude mcp add dooray-mcp-js-read-only --env DOORAY_TOKEN="{personal-token}" -- npx -y dooray-mcp-js --mode read-only

プロジェクト構造

dooray-mcp-js/
├── src/
│   └── index.js      # MCP server entry point
├── package.json
└── README.md

ローカル開発

クローンしたリポジトリから作業する場合は、ローカルのエントリポイントを直接実行します:

DOORAY_TOKEN="{personal-token}" node ./src/index.js

ツール

dooray-mcp-js パッケージは、現在実装されているすべてのツールを公開します。現在のサーバーには削除ツールはまだありません。

• dooray_messenger

• dooray_calendar_calendars

• dooray_calendar_events

• dooray_calendar_post_event

• dooray_account_members

• dooray_account_member

• dooray_project

• dooray_posts (タスク投稿を検索し、タスク本文と、インライン本文画像/ファイルを含むことができる fileIdList を公開します)

• dooray_post_logs (投稿のコメントとアクティビティログを検索します)

• dooray_post_log (ID で 1 つのコメントまたはアクティビティログを検索します)

• dooray_post_log_create (投稿にコメントを追加します。本文は { "mimeType": "text/x-markdown", "content": "..." } です)

• dooray_post_log_update (同じ本文形式でコメントまたはアクティビティログを更新します)

• dooray_post_files (通常の添付ファイルを一覧表示します。空の結果または AUTH_FORBIDDEN_ERROR は、fileIdList の項目をダウンロードできるかどうかを決定するものではありません)

• dooray_post_file_download (dooray_posts.fileIdList の ID(インライン本文画像を含む)、または media=raw を使用した通常の添付ファイル ID をダウンロードします。認可は設定された API オリジンと HTTPS file-api.dooray.com に限定されます)

• os

タスク URL と本文ファイルの読み取り

リクエストが Dooray タスク本文、本文に埋め込まれた画像、または本文で参照されているファイルを求める場合は、このワークフローを使用します。コメントとアクティビティログは別のリソースであり、このワークフローには必要ありません。

1. タスク URL を解析します。/task/{projectId}/{postId} は両方の ID を直接提供します。レガシーな /project/tasks/{postId} 形式は postId のみを提供するため、その末尾の数値を projectId として使用してはなりません。

2. レガシーな URL 形式の場合のみ、プロジェクトを解決します。必要な type、scope、state フィルターを指定して operation=find_projects で dooray_project を呼び出します。関連するフィルターの組み合わせを繰り返し、すべての結果ページがチェックされるまで size を最大 100 にして page 値を続けます。

3. 一致する投稿を検索します。新しい URL 形式のプロジェクト ID、またはレガシー URL で見つかった候補プロジェクト ID を使用して dooray_posts を呼び出します。size を最大 100 にして、必要に応じて page 値を続け、返された投稿 ID を URL の postId と照合します。誤ったプロジェクト ID の下での検索や、最初の結果ページのみの検索は、タスクまたはそのファイルが利用できないという証拠にはなりません。

4. 一致する dooray_posts の結果からタスク本文を読み取ります。ユーザーが明示的にコメントやアクティビティ履歴を求めない限り、dooray_post_logs を呼び出さないでください。

5. 一致する投稿に fileIdList が含まれている場合は、検証済みの同じ projectId と postId を使用して、リストされたすべての ID に対して dooray_post_file_download を 1 回ずつ呼び出します。これらの ID は通常、タスク本文に埋め込まれた画像を表しますが、他の本文ファイルを表すこともあります。

6. 返されたローカルの filePath を画像ビューアまたは適切なドキュメントパーサーで検査します。ダウンロード結果には fileName、mimeType、size、temporary も含まれます。

dooray_post_files は通常の添付ファイルの一覧表示用に公開されていますが、本文ファイルで使用される fileIdList パスとは別のものです。dooray_posts.fileIdList からの直接ダウンロードが機能する場合でも、空のリストまたは AUTH_FORBIDDEN_ERROR を返すことがあります。したがって、どちらの結果も本文画像またはファイルにアクセスできないという証拠として報告すべきではありません。dooray_post_file_download からの fetch failed エラーまたはタイムアウトも、権限の結果ではなく転送の失敗であり、再試行するか、別途報告する必要があります。直接ダウンロードが検証済みの projectId、postId、fileId で 403 や 404 などの Dooray の最終応答を返した場合にのみ、ファイルを禁止または欠落として報告してください。

読み取り専用モードのツール

--mode read-only または DOORAY_MCP_MODE=read-only が設定されている場合、書き込み可能な Dooray ツールは tools/list に公開されず、tools/call を通じて呼び出すこともできません。

読み取り専用モードで公開されるもの:

• dooray_calendar_calendars

• dooray_calendar_events

• dooray_account_members

• dooray_account_member

• dooray_project

• dooray_posts

• dooray_post_logs

• dooray_post_log

• dooray_post_files

• dooray_post_file_download

• os

読み取り専用モードで非表示になるもの:

• dooray_messenger

• dooray_calendar_post_event

• dooray_post_log_create

• dooray_post_log_update

オプション

• --token: Dooray 個人 API トークン。デフォルトは DOORAY_TOKEN です。

• --endpoint: Dooray API エンドポイント。デフォルトは https://api.dooray.com です。

• --mode: ツール公開モード。full または read-only を使用します。デフォルトは DOORAY_MCP_MODE または full です。