TeamShared

teamshared（Cursor、Claude Code、Codex プラグイン）

teamshared MCP サーバーを登録します。Cursor プラグインには、想起を優先するメモリルールと、Agent Chat を TeamShared に記録する Cursor フック（sessionStart、beforeSubmitPrompt、afterAgentResponse、stop、sessionEnd）に加え、postToolUse（テスト／lint／シェルの失敗）、postToolUseFailure（読み取り専用の想起）、preCompact も含まれています。Cursor プラグインには、引き続きスキル、スラッシュコマンド、追加のエージェントはありません。

このリポジトリには、claude/ に Claude Code マーケットプレイスプラグインも含まれています（Claude Code のネイティブな /mcp OAuth によるリモート MCP、任意の記録フック用の TEAMSHARED_TOKEN、プロトコル 1.31.0、SessionStart による挿入、公式 Claude Code 記録フック）。

plugins/teamshared/ にあるネイティブ Codex パッケージは、サーバーの MCP OAuth 検出フローを使用し、Codex を第一級のクライアントとして扱います。プロトコル 1.31.0、SessionStart による挿入、公式 Codex 記録フックを備えています。手動での Codex TOML 設定も install/codex/ にあります（TEAMSHARED_TOKEN。混在させないでください）。

ホスト型のインストール先は teamshared.com/#connect です。 公開プラグイン／マーケットプレイスのソースはこのリポジトリです （teamshared-ai/teamshared-plugin）。 リモート MCP エンドポイントは https://teamshared.com/mcp です。

接続は 1 回、リポジトリごとに組織は 1 つです。 プラグインを一度インストールし、一度接続してください。 チャットから org_list／org_bind(slug=...) を呼び出します。CLI teamshared org bind <slug> は、.teamshared/org に書き込む任意の代替手段です。TeamShared サーバーを 2 つ目に追加しないでください。未バインドの /mcp も引き続き動作し、Connect 時に選択した組織を使い続けます。エージェント向けの説明文は AGENTS.md を参照してください。

コンポーネント	目的
mcp.json	https://teamshared.com/mcp を登録します（URL のみ。Cursor OAuth Connect）
rules/teamshared.mdc	軽量な常時実行の取得／保存ループ（alwaysApply）。ツールの詳細カタログは memory_tools_catalog にあります
hooks/	Cursor フック：Agent Chat の記録に加え、postToolUse（テスト／lint／シェルの失敗）、postToolUseFailure（読み取り専用の想起）、preCompact
claude/	Claude Code プラグイン（ネイティブな /mcp OAuth によるリモート MCP ＋ プロトコル 1.31.0 ＋ TEAMSHARED_TOKEN が必要な記録フック）
.claude-plugin/marketplace.json	Claude Code マーケットプレイスのカタログ（/plugin marketplace add teamshared-ai/teamshared-plugin）
.agents/plugins/marketplace.json	Codex マーケットプレイスのカタログ（codex plugin marketplace add teamshared-ai/teamshared-plugin）
plugins/teamshared/	ネイティブ Codex プラグイン（OAuth MCP ＋ プロトコル 1.31.0 ＋ 公式記録フック）
clients/	Cursor 以外のハーネス向けのコピー＆ペースト可能なプロトコルおよび MCP の例（Cursor では読み込まれません）

インストール

Git マーケットプレイスから（推奨）

1. Settings → Plugins → Add marketplace → https://github.com/teamshared-ai/teamshared-plugin を貼り付けます
2. /add-plugin teamshared を実行するか、Settings → Plugins で teamshared を有効にします
3. Settings → Tools & MCP → teamshared → Connect（コンソールと同じメールアドレス＋ワンタイムコード）

Cloud および Grok Bot エージェントは、このアカウントレベルの Connect を継承します。プラグインをインストールすると https://teamshared.com/mcp が登録されるため、Connect をクリックするだけです。 プラグインの mcp.json に URL やトークンを貼り付けないでください。その後、リポジトリをバインドします（teamshared org bind <slug>）。TeamShared サーバーを 2 つ目に追加しないでください。

公式マーケットプレイスへの公開チェックリストは MARKETPLACE.md を参照してください。

Claude Code（マーケットプレイス）

/plugin marketplace add teamshared-ai/teamshared-plugin
/plugin install teamshared@teamshared
/reload-plugins
/mcp

/mcpでteamsharedを選択し、認証を選びます。これはClaude Code独自のネイティブOAuthフローで、Webコンソールと同じメールアドレス／OTPログインを使用し、トークンはシステムのキーチェーンに保存されます。/mcpにツールがplugin:teamshared:teamsharedとして接続済みで表示されることを確認してください。

チャットキャプチャフックは別のサブプロセスであり、キーチェーンにはアクセスできません。そのため、チャットも自動的にキャプチャしたい場合は、tsk_組織キーを発行してエクスポートしてください。絶対にコミットしないでください。

export TEAMSHARED_TOKEN=tsk_...   # mint under https://teamshared.com/app/keys

キーがなくても、フックは何もしないだけです。MCP接続とターンごとのワークフローはどちらの場合も問題なく動作します。チャットからorg_bind(slug=...)を呼び出し（CLIのteamshared org bind <slug>は任意）、キャプチャが組織に紐付くようにしてください。プロジェクトの.mcp.jsonにTeamSharedサーバーを追加しないでください。 組織に紐付いていない/mcpも引き続き動作します。SessionStartはプロトコル1.31.0を挿入します。/teamshared:statusでヘルス状態とバージョンを確認できます。詳細： claude/README.md。

Codex（ネイティブプラグインマーケットプレイス）

ネイティブCodexパッケージはTeamSharedのMCP OAuthディスカバリーフローを使用するため、TEAMSHARED_TOKENは不要で、認証ヘッダーも保存しません。ブラウザーを最初に開くのはCodexホストです（システムのデフォルトブラウザー）。TeamSharedが提供するのは/oauth/authorizeとリダイレクトのみです。OTP入力後の完了ページでは、単一のハンドオフを使用します。ChatGPTアプリ内の@BrowserはComputer Useであり、MCPの認証ではありません。そこでは接続を強制するAPIはありません。ブラウザーを使わない場合は、このプラグインの代わりにinstall/codex/とTEAMSHARED_TOKENを使用してください。詳細： #46および plugins/teamshared/README.md。

codex plugin marketplace add teamshared-ai/teamshared-plugin
codex plugin add teamshared@teamshared

Codexアプリを再起動し、新しいタスクを開始して、プロンプトが表示されたらTeamSharedに接続します。 次に、/hooksでプラグインフックを確認して信頼し、キャプチャ書き込みを実行できるようにします。 チャットからorg_bind(slug=...)を呼び出します（CLIのteamshared org bind <slug>は任意）。プラグインの隣に2つ目の[mcp_servers.teamshared]を追加しないでください。組織に紐付いていない/mcpも引き続き動作します。 SessionStartはプロトコル1.31.0を挿入します。$statusでヘルス状態とバージョンを確認できます。 パッケージはplugins/teamshared/にあり、.agents/plugins/marketplace.jsonに登録されています。 詳細：plugins/teamshared/README.md。

cursor.directoryへの掲載

こちらからこのリポジトリを送信してください：

https://github.com/teamshared-ai/teamshared-plugin

古いxhad/teamshared-cursorのリダイレクトは送信しないでください。ルートのplugin.jsonと.mcp.jsonは、Open Plugins／ディスカバリー用ディレクトリのファイルです。Cursorのインストールでは、引き続き.cursor-plugin/とmcp.jsonを使用します。

そのまま貼り付けられる掲載用の説明：

TeamShared is hosted MCP plus the recall-first memory rule and Cursor
hooks that capture Agent Chat (plus failed test/lint/shell + preCompact).
No skills, slash commands, or extra agents.

Install in Cursor:
1. Settings → Plugins → Add marketplace
2. Paste https://github.com/teamshared-ai/teamshared-plugin
3. /add-plugin teamshared
4. Settings → Tools & MCP → teamshared → Connect (email + one-time code)

Cloud and Grok Bot agents inherit that Connect.
Bind each repo with teamshared org bind; do not add a second server.

このリポジトリから（フォルダーまたはシンボリックリンク）

フォルダーからプラグインを追加するには、選択したディレクトリにマーケットプレイスカタログが必要です。このリポジトリのルートを選択してください（"source": "./"を含む.cursor-plugin/marketplace.jsonが同梱されています）。

次に、プラグインを有効にして、ウィンドウを再読み込みし、接続します。

フォルダーピッカーを使わずにローカルで反復作業を行う場合：

ln -sf "$(pwd)" ~/.cursor/plugins/local/teamshared

セットアップ

1. メール／OTP で接続 — 設定 → ツールと MCP → teamshared → 接続。 Cursor がブラウザーを開きます。Web コンソール（/app）と同じメールアドレスとワンタイムコードでサインインしてください。プラグインにはサーバー URL がすでに含まれているため、プラグインの mcp.json にヘッダーや tsk_* トークンを追加しないでください。
2. リポジトリを紐付ける — teamshared org bind <slug> を実行すると、.teamshared/org（{"v":1,"slug"}）が書き込まれます。このファイルをコミットしてください。Capture はこの設定に従います。Cursor の .cursor/mcp.json、プロジェクトの .mcp.json、または Codex の config.toml に 2 つ目の TeamShared サーバーを追加しないでください。
3. Cursor Cloud／Grok Bot — アカウントレベルの Cursor Connect を引き継ぎます。Connect を 1 回行えば、そのユーザーのすべてのクラウドエージェントが TeamShared を利用できます。紐付け情報は引き続きチェックアウト内（.teamshared/org）にあります。Cloud はリポジトリの設定から 2 つ目の MCP URL を取得しません。紐付けがなくても /mcp は引き続き動作します（Connect 時の組織が使用されます）。
4. Developer: Reload Window — 設定 → MCP に teamshared が有効と表示されることを確認してください。

以前に https://teamshared.com/mcp を手動で追加した場合は、teamshared サーバーが 2 つにならないよう、その手動エントリーを削除してください。

1 つの組織に固定する必要があるボットでは、シートキーを使用します。対象の組織を指定して teamshared token mint を実行するか、/app/keys でキーを発行し、MCP ヘッダーに設定します（Authorization: Bearer tsk_…）。プラグインの mcp.json には設定しないでください。対話型 Connect では、紐付けがなくても /mcp を引き続き使用できます。

利用できる機能

• MCP ツール：memory_recall、memory_remember、memory_session_* など（プラグインのインストール時に mcp.json に登録されます）。
• ルール：すべてのエージェントのターンに、リコールを最初に行うプロトコルを注入し、チームメイトには人間が操作する Web コンソール（/app）を案内します。
• Cursor フック：エージェントが memory_session_ensure／context_commit を呼び出すのを待たずに、Agent Chat のターンをほぼリアルタイムで TeamShared に追加します。sessionStart は conversation_id を作業セッションに対応付け、auto_recall=true での ensure が成功すると、上限付きの Cursor additional_context ブロック（リンクされた soul、存在する場合は短いプレイブックのヘッダー、簡潔な auto_recall の箇条書き。メモリ本文やトランスクリプト全体は含みません）を注入します。キーワードを使った作業では、明示的な memory_recall の使用を推奨します。MCP／認証エラー時も処理を継続します。beforeSubmitPrompt と afterAgentResponse は、サニタイズ済みのユーザー／アシスタントのテキストを追加します。sessionEnd はセッションを終了し、要約・整理します。stop は中断／エラーループを記録するだけです（各ターンの後に実行されるため、要約・整理は行いません）。Shell のテスト／lint／コマンドが失敗した場合、postToolUse は引き続き短いエピソード形式の事実を追加します（コマンドとエラーの末尾。シークレットは除去されます）。Cursor の postToolUseFailure と、失敗した場合の postToolUse では、フックはさらに、絞り込んだクエリ（ツール名と切り詰めたエラー、k=3、verbose=false）でリモートの memory_recall を呼び出し、簡潔なヒットを additional_context として注入します。これは SessionStart の auto_recall と同じパターンです。リコール結果が空の場合、または MCP にトークンがない場合はスキップします。このリコール処理では書き込み（context_commit）は行いません。MCP に接続できない場合も処理を継続します。preCompact は短いセッション要約を書き込みます。いずれも既存の Connect セッションを再利用し、mcp.json に tsk_ を設定しません。Cloud エージェントでは sessionStart／sessionEnd がスキップされる場合がありますが、プロンプト／応答フックは引き続きターンを記録します。エージェントは引き続き最初にリコールを行い、厳選した事実をコミットできます。フックはトランスクリプトを保存します。

リポジトリを組織に紐付ける

TeamShared サーバーは https://teamshared.com/mcp のままです。リポジトリのファイルで組織を選択し、キャプチャもそれに従います。TeamShared サーバーを追加でもう 1 つ登録しないでください。

teamshared org bind sapien --token "$TEAMSHARED_TOKEN"
teamshared org status
teamshared org unbind

bind はメンバーシップを確認してから、.teamshared/org のみを書き込みます。

{"v":1,"slug":"sapien"}

派生 URL の https://teamshared.com/o/{slug}/mcp は保存されません。ファイルをコミットして、チェックアウト内のすべてのハーネスで同じ組織が使われるようにしてください。status と unbind はオフラインで動作します。ファイルがない、または無効な場合は、未バインドの /mcp（接続時の組織）になります。これはサポートされています。バインドは必須ではありません。

ハーネス	一度だけ接続	バインド	しないこと
Cursor	設定 → ツールと MCP → teamshared → 接続	.teamshared/org。フックは同じ接続トークンで組織 URL に POST します	.cursor/mcp.json ／プロジェクト用の MCP 設定
Cursor Cloud	アカウントの接続設定を継承	同じチェックアウトファイル。フックはその設定に従います	Cloud のバインド先としてリポジトリの MCP URL を指定すること
Claude Code	/mcp → 認証	同じファイル。フックは組織スコープの TEAMSHARED_TOKEN を使います	プロジェクトの .mcp.json に TeamShared サーバーを追加すること
Codex	プラグインの OAuth（または手動の tsk_。両方は使わないでください）	同じファイル	プラグインの隣に [mcp_servers.teamshared] を追加すること

ボットを 1 つの組織に固定するには、teamshared token mint <agent>（組織スコープのシートキー）または /app/keys を使います。サーバーは引き続き 1 つです。

Cursor プラグインには、引き続きスキル、スラッシュコマンド、追加のエージェントはありません。 Claude Code パッケージには、プロトコル 1.31.0（teamshared-memory）、/teamshared:status、および公式の Claude Code キャプチャフックが含まれます。Codex パッケージには、同じ 1.31.0 のループに加えて、公式の Codex フック（SessionStart、UserPromptSubmit、Stop、Interrupt、SessionEnd、失敗した Bash に対する PostToolUse、PreCompact）が含まれます。SessionEnd は 1 回の上限付きコミットで終了し、Interrupt は Cursor の中断との同等性を確保します。Codex には StopFailure と PostToolUseFailure はありません。

その他のクライアント

Hermes、Claude Desktop、プロトコルの Markdown については、clients/ を参照してください。手動のクライアント設定をデバッグする場合を除き、Claude Code と Codex では上記のマーケットプレイスプラグインを使用してください。

Codex（手動 TOML の代替方法）

ネイティブプラグインを使わずに MCP を手動登録する場合、Codex では Cursor の JSON mcp.json ではなく TOML を使用します。teamshared.com/app/keys で tsk_ キーを発行してエクスポートし、ホスト型 MCP を登録します（Codex は Authorization: Bearer tsk_… を送信します）。

export TEAMSHARED_TOKEN=tsk_...   # from /app/keys — never commit this
codex mcp add teamshared \
  --url https://teamshared.com/mcp \
  --bearer-token-env-var TEAMSHARED_TOKEN

または、install/codex/mcp.toml をプロジェクトローカルの .codex/config.toml に統合し、信頼されたリポジトリのルートから Codex を実行します。詳しい手順については、install/codex/README.md を参照してください。

ネイティブのマーケットプレイスプラグインと手動の TOML エントリは、どちらか一方だけを使用してください。手動の方法は、1 つの組織に固定する必要があるボット向けのシートキー方式（その組織にスコープされた teamshared token mint）であり、OAuth ブラウザーをスキップする確実な方法です。プラグインの隣に TeamShared サーバーを追加でもう 1 つ登録しないでください。いずれの場合も、teamshared org bind <slug> でチェックアウトをバインドしてください。未バインドの /mcp も引き続き動作します。

Cursor デスクトップ、Cursor Cloud、Grok Bot では、引き続き 接続 を使用します。この tsk_ ブロックをプラグインの mcp.json に追加しないでください。

ライセンス

MIT — LICENSE を参照してください。