Edworking MCP

Edworking MCP

公式のオープンソース Edworking MCP サーバーです。アカウントからアクセスできるプロジェクト、タスク、ドキュメント、会話、ファイルにアシスタントを接続します。

ホストされたエンドポイント： https://mcp.edworking.com/mcp

公開 ID： Edworking MCP。Railway インフラストラクチャでは、コードネーム Bellsprout が引き続き使用されています。新しい接続には、上記のカスタムドメインを使用してください。以前の Railway URL で作成した接続は、OAuth リソースのオーディエンスが変更されたため、再接続が必要です。

リリース： このソースでは、22 個のツールを含む 0.2.0 を準備しています。MCP サーバーより先に、対応するスコープ付き API バックエンドをデプロイしてください。ドキュメントには、新しい docs:read / docs:write トークン権限と OAuth の同意が必要です。既存の許可範囲は自動的には拡張されません。

公開済みのベースライン： 0.1.4 は npm、Official MCP Registry、Smithery、Glama のホスト型コネクターで利用できます。OpenAI の審査は 2026 年 10 月 13 日に提出され、現在保留中です。OpenAI ではまだ公開されていません。各ディレクトリの状況については、公開チェックリストをご覧ください。

接続

Streamable HTTP と OAuth に対応した MCP クライアントにエンドポイントを追加します。ブラウザーで開く認証画面に従ってください。Edworking → Profile → API tokens で専用のスコープ付きトークンを作成し、Edworking MCP の同意ページで入力して、クライアントと権限を承認します。アシスタントとの会話にトークンを貼り付けないでください。

接続では、デフォルトで読み取り権限が要求されます。書き込みには、対応する OAuth スコープと上流トークンの権限が必要です。クライアントが追加の権限を要求できない場合は、明示的なスコープを指定して再接続してください。Edworking で専用トークンを取り消すと、そのトークンを使用するすべての許可が解除されます。許可の有効期限は 30 日以内、または Edworking トークンの有効期限までのいずれか早い方です。アクセストークンの有効期間は最長 10 分で、リフレッシュトークンはローテーションされます。

codex mcp add edworking-mcp --url https://mcp.edworking.com/mcp
codex mcp login edworking-mcp

ChatGPT でテストするには、Plugins → Add custom MCP server を選択し、OAuth を選んでエンドポイントを入力します。利用できるかどうかは、プランとワークスペースのポリシーによって異なります。移植可能な OpenAI プラグインパッケージは plugin/ にあります。0.2.0 パッケージでは、ドキュメントを含む 6 つの読み取り用 OAuth スコープと 5 つの書き込み用 OAuth スコープを宣言しています。すでに提出済みの OpenAI 審査パッケージは、次のバージョンを提出するまで、別の 0.1.4 成果物のままです。実際の同意画面と get_connection の結果を確認してください。10 月 13 日時点で、提出ポータルのメタデータ許可では読み取り用スコープが 5 つ使用されていました。一方、別の ChatGPT デモ接続では 9 つすべてのスコープが付与され、タスクの作成とメッセージの送信に成功しました。既存の読み取り専用の許可は、再認証されるまで読み取り専用のままです。書き込み権限のあるトークンを使用しても、OAuth の許可が自動的にアップグレードされることはありません。

その他のクライアントでは、edworking-mcp という名前のリモート HTTP サーバーを設定し、組み込みの OAuth フローを使用してください。PKCE、動的登録、HTTPS Client ID Metadata Documents に対応したパブリッククライアントをサポートしています。/mcp が受け付けるのは、Edworking MCP のアクセストークンのみです。

クライアントのセットアップ手順：Edworking MCP ガイド。残る機能と公開の条件については、競合製品レビューと提供ロードマップをご覧ください。

Allow access または Cancel を選択すると、ブラウザーは自動的にアシスタントに戻ります。Returning to your assistant の画面から進まない場合は、戻るボタンを使用してください。同意リクエストは一度だけ使用でき、有効期限は 10 分です。invalid_grant または期限切れ・使用済みのリクエストが表示された場合は、古い同意リンクを再度開くのではなく、アシスタントから新しい接続を開始してください。承認フォームを再読み込みしたり、再送信したりしないでください。

ツール

ツール	スコープ	目的
get_connection	任意の接続	接続名、権限、有効期限
list_projects、list_project_statuses、list_project_members	projects:read	プロジェクト、有効なステータス、既存の担当者 ID
list_tasks、get_task	tasks:read	プロジェクト、ステータス、担当者、優先度、タイトル、期限でタスクを絞り込み、タスクの内容を読み取る
search、fetch	ソースごとの読み取りスコープ	インデックス化されたタスク、Docs、ファイル、プロジェクトメッセージ。型付きの結果取得
list_docs、get_doc	docs:read	Docs を検索し、Markdown コンテンツを読み取る
create_doc、update_doc、edit_doc_content	docs:write。本文の編集には docs:read も必要	Docs の作成、名前変更、編集
list_conversations	chats:read	既存のプライベートな会話
read_messages	messages:read	アクセス可能な会話メッセージ
list_files	files:read	ファイルのメタデータ
create_task、update_task、edit_task_content	tasks:write。本文の編集には tasks:read も必要	タスクを作成し、名前、ステータス、優先度、担当者、日付、説明を編集する
send_message	messages:write	ユーザーが指定したメッセージを送信する
create_project	projects:write	プロジェクトを作成する
upload_file	files:write	公開 HTTPS ファイルをインポートする

タスクにファイルを添付するには、files:write も必要です。リストはカーソルを使用し、1 ページあたり最大 100 件です。ページを移動する間は、並べ替えとフィルターを変更しないでください。検索ではワークスペースのインデックスを使用し、許可されたソースごとに関連度順で最大 20 件の結果を返します。スニペットを公開する前に、現在のアクセス権、削除状態、メッセージ履歴の上限を再確認します。インデックス化には遅延が発生する場合があります。利用できないソースは報告され、プライベートチャットとプロジェクトに属さない項目は除外されます。タスクを漏れなく見つけるには、フィルター付きリストを使用してください。ファイルの取得で返されるのはメタデータであり、ファイルの内容ではありません。

本文を編集する前に、タスクまたは Doc を読み取ってください。コンテンツの読み取りは 20,000 文字までで、ブロックハンドルが公開されます。対象を絞った編集では、コラボレーションサービスとバージョン履歴が再利用されます。大規模な削除には、明示的な allowRemoval が必要です。タスクの担当者リストを指定すると、現在のリストが置き換えられます。現在のリストを維持するには省略し、担当者を解除するには [] を使用してください。担当者は、すでにそのプロジェクトとワークスペースに所属している必要があります。削除、招待、タスクの移動、共有設定の変更は提供されていません。

書き込みには UUID の requestId が必要です。再試行時は、引数を変更せずに同じ ID を再利用してください。完了した結果は暗号化され、24 時間キャッシュされます。結果が不確かな場合、自動的に再実行されることはありません。次の操作を決める前に Edworking を確認してください。これは上流での厳密に 1 回だけのトランザクションではありません。重複排除の有効期限は 24 時間です。

開発

Node 24 LTS（最小要件は 22.19）を使用してください。OpenAI API キーは必要ありません。

npm ci
cp .env.example .env
# Generate a key and save it as TOKEN_ENCRYPTION_KEY in .env:
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
npm run build
node --env-file=.env dist/index.js

型チェック、セキュリティ／統合テスト、ビルドを実行するには、npm run check を実行してください。npm run dev は、シェルですでに変数が読み込まれている場合にウォッチャーを起動します。

ローカルの stdio では、クライアントが EDWORKING_API_TOKEN をプロセス環境に安全に設定して npx -y @edworking/[email protected] を実行するよう設定するか、ソースからビルドして node /absolute/path/to/edworking-mcp/dist/stdio.js を実行してください。npm パッケージは公開されています。stdio はそのトークンを Edworking に直接使用し、再起動時にリセットされるメモリ内の重複排除機能を備えています。

Railway のデプロイ

付属の Dockerfile を使用し、/data にボリュームをマウントして、次のように設定します。

変数	値
NODE_ENV	production
PORT	3000
PUBLIC_BASE_URL	安定した公開 HTTPS オリジン。/mcp は含めません
DATABASE_PATH	/data/bellsprout.sqlite
TOKEN_ENCRYPTION_KEY	64 桁の 16 進数でエンコードしたランダムな 32 バイトキー
EDWORKING_API_URL	https://gateway.edworking.com/
EDWORKING_APP_URL	https://app.edworking.com

レプリカは 1 つにし、スリープを無効にして、デプロイの重複を 0 に設定します。/healthz はプロセスを確認し、/readyz は SQLite を確認します。デプロイ後もキーを保持してください。任意の ALLOWED_ORIGINS で正確なブラウザーオリジンを追加でき、OPENAI_DOMAIN_CHALLENGE で OpenAI の検証値を配信でき、EDWORKING_CONNECT_URL でネイティブの Edworking 接続ページを有効にできます（そのページの公開後に限ります）。

運用、セキュリティ、公開をご覧ください。コントリビューションについてはCONTRIBUTING.mdをご覧ください。MITライセンスの下で提供されています。