Multiai Relay Mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Multiai Relay Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
日本語 | English
Claude Desktop と Codex Desktop が MCP を通じて状態を共有し、セッションをまたいで作業を引き継げる協調開発システムです。
AI_STATE.json に記録し、セッションをまたいで保持MULTIAI_LANG=en で全ツールの出力・HANDOFF.md を英語に切り替え（デフォルトは日本語）collab_status / collab_switch_project でブランチ名と最新コミットを自動表示collab_encoding_report() でUTF-8保存・表示コードページ・CLI入出力を切り分けcollab_status / collab_switch_project が詰まりにくいcli_config.json 保存を防止--skip-git-repo-check を含め、git管理外フォルダでも相談系ツールが動作設計上の制約: MCP サーバーは Desktop アプリごとに独立したプロセスとして起動されます。 1 プロセス = 1 セッションデフォルトプロジェクト です。collab_switch_project()でセッション既定を設定し、個別ツール呼び出しではproject_path=で別プロジェクトを一時指定できます。 直近のプロジェクトは~/.multiai_current_project.jsonにも保存され、Desktop再起動後に復元されることがあります。複数プロジェクトを扱う場合、書き込み前にcollab_switch_project()またはproject_path=で対象を明示してください。 詳細・復旧手順 → リポジトリ内docs/TROUBLESHOOTING.mdを参照 日本語文字化け対策 → リポジトリ内docs/ENCODING.mdを参照
%APPDATA%\Claude\claude_desktop_config.json の mcpServers に追加:
"multiai-relay-mcp": {
"command": "uvx",
"args": ["multiai-relay-mcp"]
}uvxのフルパスが必要な場合はwhere uvx（Windows）またはwhich uvx（Mac/Linux）で確認。 追加後は Claude Desktop を再起動。 特定バージョンで固定したい場合はargsを["--from", "multiai-relay-mcp==1.1.6", "multiai-relay-mcp"]のように指定できます。
~/.codex/config.toml の末尾に追加:
[mcp_servers.multiai-relay-mcp]
command = 'uvx'
args = ['multiai-relay-mcp']追加後は Codex Desktop を再起動。 特定バージョンで固定したい場合は args = ['--from', 'multiai-relay-mcp==1.1.6', 'multiai-relay-mcp'] のように指定できます。最新のプレビュー版は TestPyPI で配布しています。TestPyPI から取得する場合は args を次のようにします。TestPyPI を優先し、依存パッケージ解決用に本番 PyPI を --extra-index-url に指定します。
Claude Desktop:
"args": ["--index-url", "https://test.pypi.org/simple/", "--extra-index-url", "https://pypi.org/simple/", "multiai-relay-mcp"]Codex Desktop:
args = ['--index-url', 'https://test.pypi.org/simple/', '--extra-index-url', 'https://pypi.org/simple/', 'multiai-relay-mcp']uv cache clean multiai-relay-mcp --forcecollab_version() でバージョンを確認v1.1.6 は v1.1.5 の入力検証強化に加え、既定の Codex CLI 引数へ --skip-git-repo-check を追加しています。該当症状がある場合は、キャッシュクリア後に必ず Desktop アプリを再起動してください。
v1.1.6以降の既定設定では codex exec --skip-git-repo-check を使います。既に cli_config.json でCodex設定を上書きしているプロジェクトでは、必要に応じて次のように更新してください。
collab_setup_cli("codex", "codex", args_before=["exec", "--skip-git-repo-check"])環境変数 MULTIAI_LANG=en を設定すると、全ツールの返答・HANDOFF.md の見出しが英語になります。
Claude Desktop の場合 — 設定に env を追加:
"multiai-relay-mcp": {
"command": "uvx",
"args": ["multiai-relay-mcp"],
"env": { "MULTIAI_LANG": "en" }
}Codex Desktop の場合 — [mcp_servers.multiai-relay-mcp.env] セクションを追加:
[mcp_servers.multiai-relay-mcp.env]
MULTIAI_LANG = "en"collab_switch_project("D:\\path\\to\\your-project")
collab_status()collab_switch_project() は接続後に現在のタスク・問題件数・Git ブランチを自動表示します。
collab_add_note("気づいたことや進捗")
collab_record_decision("採用技術", "FastAPI を選択。非同期処理が必要なため")
collab_record_issue("ログイン後のリダイレクトが未実装")
collab_set_task("認証機能の実装")
collab_record_file("src/auth.py")メモの蓄積について: メモが 200 件を超えると整理を促すヒントが表示され、300 件を超えると警告が出ます。 collab_cleanup_history() で古いメモをアーカイブできます。project_path パラメータ）ほぼ全てのツールに project_path: str = '' パラメータが追加されています。 project_path を指定すると、セッションデフォルトを変えずに、そのツール呼び出しだけ別プロジェクトに作用します。
# セッションデフォルト: ProjectA
collab_switch_project("D:\\projects\\ProjectA")
# ProjectB の状態を確認（A は変わらない）
collab_status(project_path="D:\\projects\\ProjectB")
# ProjectB にメモを追加（A は汚れない）
collab_add_note("B専用メモ", project_path="D:\\projects\\ProjectB")
# 次のツール呼び出しは A に戻る
collab_status() # → ProjectA を表示collab_complete_task()collab_checkpoint("認証の実装完了。次はテストを書く必要あり", "codex")HANDOFF.md が生成されます。Codex Desktop の新しいセッションで「HANDOFF.md を読んで続きをお願いします」と伝えてください。
| ツール | 用途 |
|---|---|
collab_switch_project(path, project_name?) | プロジェクトを設定・新規作成（毎セッション必須） |
collab_current_project() | 現在のプロジェクトパスを表示 |
collab_list_projects() | 最近使用したプロジェクト一覧を表示 |
collab_status(calling_ai?) | 状態を詳細表示（Git ブランチ・担当AI不一致を警告） |
collab_summary() | 状態を4行でコンパクトに表示 |
| ツール | 用途 |
|---|---|
collab_set_task(title, description?) | 現在タスクを設定 |
collab_complete_task() | 現在のタスクを完了済みにする |
collab_add_note(message) | メモを追加（200件・300件でソフトキャップ警告） |
collab_record_decision(title, content) | 決定事項を記録 |
collab_record_file(path) | 変更ファイルを記録 |
collab_change_mode(mode) | モード変更（plan / implement / review / debug） |
collab_add_pending_task(title, description?) | 保留タスクを追加 |
collab_close_pending_task(task_id) | 保留タスクを完了扱いに |
| ツール | 用途 |
|---|---|
collab_record_issue(message, severity?, category?, tags?, related_files?) | 問題を記録（深刻度P0〜P3、issue-NNN ID 付き） |
collab_update_issue(issue_id, ...) | 既存 issue のメタデータを更新（タグ増減も可） |
collab_resolve_issue(issue_id, note?) | 問題を解決済みにする |
collab_list_resolved() | 解決済み問題の一覧を表示 |
| ツール | 用途 |
|---|---|
collab_search(query) | キーワードで全データを横断検索 |
collab_timeline(limit?, since?, actor?, event_type?) | プロジェクトの更新イベントを時系列で表示 |
| ツール | 用途 |
|---|---|
collab_generate_handoff(to_ai, dry_run?) | 引き継ぎ文書を生成して担当AIを切り替え（dry_run でプレビューのみ） |
collab_checkpoint(message, to_ai?, dry_run?) | メモ追加と引き継ぎを一度に実行 |
collab_set_handoff_template(preset) | HANDOFF.md テンプレートを切り替え（full / minimal / review / debug） |
| ツール | 用途 |
|---|---|
collab_consult(ai, question) | 相手AIのCLIに相談 |
collab_consult_async(ai, question) | 相談をバックグラウンドジョブとして投入 |
collab_discuss(ai, topic) | 相手AIと複数ラウンド議論 |
collab_discuss_async(ai, topic) | 議論をバックグラウンドジョブとして投入 |
collab_request_review(ai, focus?, scope?) | 相手AIにコードレビューを依頼 |
collab_request_review_async(ai, focus?, scope?) | レビュー依頼をバックグラウンドジョブとして投入 |
collab_ai_job_status(job_id) | 非同期AIジョブの状態と結果を確認 |
collab_ai_job_list() | 非同期AIジョブの一覧を表示 |
collab_ai_job_cancel(job_id) | キュー中の非同期AIジョブをキャンセル |
collab_setup_cli(ai, command, ...) | CLIパス・引数設定をカスタマイズ |
| ツール | 用途 |
|---|---|
collab_version() | バージョン情報を表示 |
collab_doctor() | 環境の健全性を診断（OK/WARN/ERR） |
collab_cleanup_sessions(keep_per_ai?) | 古いセッションログを削除 |
collab_cleanup_history(keep_notes?, keep_completed_tasks?, archive?, dry_run?) | 古いメモ・完了タスクをアーカイブ |
collab_export_state(output_path) | 状態を SHA-256 チェックサム付き JSON でエクスポート |
collab_import_state(input_path, mode?) | エクスポート JSON から状態をインポート（validate/merge/replace） |
| ファイル | 用途 |
|---|---|
AI_STATE.json | 共有状態（タスク・メモ・決定事項など） |
AI_STATE.archive.json | アーカイブ済みの古いメモ・完了タスク（collab_cleanup_history で生成） |
HANDOFF.md | 引き継ぎ文書 |
ai_sessions/ | セッションログ |
AI_STATE.lock | 一時ロックファイル（処理後即削除） |
cli_config.json | CLI設定（collab_setup_cli() 呼び出し時のみ生成） |
状態本体はプロジェクトフォルダ内に保存されます。Desktop MCPサーバー再起動後の復元用に、直近プロジェクト情報だけホーム配下へ小さく保存します。
MIT License
<a name="english"></a>
日本語 | English
A collaborative development system that lets Claude Desktop and Codex Desktop share state via MCP and hand off work across sessions.
AI_STATE.json and survive across sessionsMULTIAI_LANG=en to switch all tool output and HANDOFF.md to English (default: Japanese)collab_status / collab_switch_project automatically show branch name and latest commitcollab_status / collab_switch_project stalls on Windowscollab_encoding_report() helps diagnose UTF-8 file, console code page, and CLI I/O issuescli_config.json--skip-git-repo-check so consultation tools work outside Git repositoriesDesign constraint: The MCP server runs as a separate process per Desktop app. 1 process = 1 session-default project. Usecollab_switch_project()to set the session default. For individual calls targeting a different project, passproject_path=to any tool — the session default stays unchanged. The last selected project is also saved in~/.multiai_current_project.jsonand may be restored after Desktop respawns the MCP server. When working across several projects, explicitly callcollab_switch_project()or passproject_path=before write operations.
Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) under mcpServers:
"multiai-relay-mcp": {
"command": "uvx",
"args": ["multiai-relay-mcp"]
}Usewhere uvx(Windows) orwhich uvx(Mac/Linux) to find the full path if needed. Restart Claude Desktop after editing. To pin a specific release, use["--from", "multiai-relay-mcp==1.1.6", "multiai-relay-mcp"]forargs.
Add to ~/.codex/config.toml:
[mcp_servers.multiai-relay-mcp]
command = 'uvx'
args = ['multiai-relay-mcp']Restart Codex Desktop after editing. To pin a specific release, use args = ['--from', 'multiai-relay-mcp==1.1.6', 'multiai-relay-mcp'].Preview builds are published on TestPyPI. To install from TestPyPI, set args as follows. TestPyPI is preferred, and production PyPI is added via --extra-index-url for dependency resolution:
Claude Desktop:
"args": ["--index-url", "https://test.pypi.org/simple/", "--extra-index-url", "https://pypi.org/simple/", "multiai-relay-mcp"]Codex Desktop:
args = ['--index-url', 'https://test.pypi.org/simple/', '--extra-index-url', 'https://pypi.org/simple/', 'multiai-relay-mcp']uv cache clean multiai-relay-mcp --forcecollab_version()v1.1.6 includes the v1.1.5 input validation hardening and adds --skip-git-repo-check to the default Codex CLI arguments. If you saw those symptoms, clear the uv cache and restart the Desktop app so the new server process is launched.
Since v1.1.6, the default configuration calls codex exec --skip-git-repo-check. If a project already overrides Codex in cli_config.json, update it when needed:
collab_setup_cli("codex", "codex", args_before=["exec", "--skip-git-repo-check"])Set MULTIAI_LANG=en to switch all tool responses and HANDOFF.md headings to English.
Claude Desktop — add env to your config:
"multiai-relay-mcp": {
"command": "uvx",
"args": ["multiai-relay-mcp"],
"env": { "MULTIAI_LANG": "en" }
}Codex Desktop — add an env section:
[mcp_servers.multiai-relay-mcp.env]
MULTIAI_LANG = "en"collab_switch_project("/path/to/your-project")
collab_status()collab_switch_project() automatically displays current task, issue count, and Git branch after connecting.
collab_add_note("Finished auth module, moving to tests")
collab_record_decision("Framework", "Using FastAPI — async support required")
collab_record_issue("Redirect after login not yet implemented")
collab_set_task("Write auth tests")
collab_record_file("src/auth.py")Note accumulation: A tip appears when notes exceed 200, and a warning at 300. Use collab_cleanup_history() to archive old notes.project_path parameter)Almost all tools accept an optional project_path: str = '' parameter. When provided, that single call operates on the specified project without changing the session default.
# Session default: ProjectA
collab_switch_project("/projects/ProjectA")
# Check ProjectB status (A is unchanged)
collab_status(project_path="/projects/ProjectB")
# Add a note to ProjectB (A is not affected)
collab_add_note("B-specific note", project_path="/projects/ProjectB")
# Next call goes back to A
collab_status() # → shows ProjectAcollab_complete_task()collab_checkpoint("Auth done. Next: write tests", "codex")A HANDOFF.md is generated. In a new Codex Desktop session, say: "Please read HANDOFF.md and continue."
| Tool | Description |
|---|---|
collab_switch_project(path, project_name?) | Set or create a project (required every session) |
collab_current_project() | Show current project path |
collab_list_projects() | List recently used projects |
collab_status(calling_ai?) | Show full status (Git branch, AI mismatch warning) |
collab_summary() | Show compact 4-line status |
| Tool | Description |
|---|---|
collab_set_task(title, description?) | Set current task |
collab_complete_task() | Mark current task as done |
collab_add_note(message) | Add a note (soft-cap warning at 200/300 notes) |
collab_record_decision(title, content) | Record a decision |
collab_record_file(path) | Record a modified file |
collab_change_mode(mode) | Switch mode (plan / implement / review / debug) |
collab_add_pending_task(title, description?) | Add a pending task |
collab_close_pending_task(task_id) | Mark pending task as done |
| Tool | Description |
|---|---|
collab_record_issue(message, severity?, category?, tags?, related_files?) | Record an issue (P0–P3 severity, issue-NNN ID) |
collab_update_issue(issue_id, ...) | Update issue metadata (incremental tag edits supported) |
collab_resolve_issue(issue_id, note?) | Mark issue as resolved |
collab_list_resolved() | List resolved issues |
| Tool | Description |
|---|---|
collab_search(query) | Cross-search all data by keyword |
collab_timeline(limit?, since?, actor?, event_type?) | Show project events in chronological order |
| Tool | Description |
|---|---|
collab_generate_handoff(to_ai, dry_run?) | Generate handoff doc and switch AI (dry_run for preview) |
collab_checkpoint(message, to_ai?, dry_run?) | Add note + generate handoff in one call |
collab_set_handoff_template(preset) | Switch HANDOFF.md template (full / minimal / review / debug) |
| Tool | Description |
|---|---|
collab_consult(ai, question) | Consult the other AI's CLI |
collab_consult_async(ai, question) | Queue a consultation as a background job |
collab_discuss(ai, topic) | Multi-round discussion with the other AI's CLI |
collab_discuss_async(ai, topic) | Queue a discussion as a background job |
collab_request_review(ai, focus?, scope?) | Request a code review from the other AI |
collab_request_review_async(ai, focus?, scope?) | Queue a review request as a background job |
collab_ai_job_status(job_id) | Check async AI job status and result |
collab_ai_job_list() | List async AI jobs |
collab_ai_job_cancel(job_id) | Cancel a queued async AI job |
collab_setup_cli(ai, command, ...) | Customize CLI path and arguments |
| Tool | Description |
|---|---|
collab_version() | Show version info |
collab_doctor() | Diagnose environment health (OK/WARN/ERR) |
collab_cleanup_sessions(keep_per_ai?) | Delete old session logs |
collab_cleanup_history(keep_notes?, keep_completed_tasks?, archive?, dry_run?) | Archive old notes and completed tasks |
collab_export_state(output_path) | Export state as SHA-256-checksummed JSON |
collab_import_state(input_path, mode?) | Import exported state (validate/merge/replace) |
| File | Purpose |
|---|---|
AI_STATE.json | Shared state (tasks, notes, decisions, etc.) |
AI_STATE.archive.json | Archived old notes/tasks (created by collab_cleanup_history()) |
HANDOFF.md | Handoff document |
ai_sessions/ | Session logs |
AI_STATE.lock | Temporary lock file (auto-deleted after use) |
cli_config.json | CLI config (created only when collab_setup_cli() is called) |
Project state is written inside your project folder. A small last-project marker is stored under your home directory so respawned Desktop MCP servers can reconnect.
Run collab_doctor() first if something seems wrong:
collab_doctor()For common errors and recovery steps, see docs/TROUBLESHOOTING.md in the repository. For Japanese encoding issues, run collab_encoding_report() and see docs/ENCODING.md.
MIT License
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.