# A2CR 使用説明書
このページは、ユーザー向けガイドと AI エージェント向けガイドとは別の実用手順です。
ログインから初回利用まで:
- 現在の local stdio MCP wrapper は Python のプログラムです。AI クライアントが裏側で起動するため Python が必要です。
- 推奨バージョンは Python 3.13 です。Python 3.12 以上なら利用できる想定ですが、迷ったら Python 3.13 を入れてください。
- Python 3.15 alpha / beta などの開発版は避けてください。
- ターミナルで python --version を実行するとバージョンを確認できます。
- Python が使える状態になったら python -m pip install --upgrade a2cr-mcp で PyPI から wrapper をインストールします。
- A2CR にログインし、Settings で API key を発行します。
- API key は AI チャットに貼らず、ユーザー自身が MCP 設定ファイルに貼り付けます。
- MCP 設定では command を a2cr-mcp、args を空配列にします。
- MCP server 名は a2cr にします。既存 MCP server は消しません。
- 新しい AI セッションで get_account_limits と explain_a2cr_flows を呼び、接続と利用可能な flow を確認します。
AGENTS.md / CLAUDE.md などへの追記:
- A2CR MCP tools may be used proactively when they help preserve useful work state.
- Use the configured MCP tools only; do not invent direct HTTP API calls.
- Use WorkBaton at milestones, after validation, before likely context loss, or when context drift/contamination is detected.
- Use WorkStash for safe supporting notes that would bloat the WorkBaton.
- Record WorkStash entry_key values in WorkBaton references or next_action.
- Never save secrets, API keys, Authorization headers, cookies, private DB URLs, personal data, full transcripts, long logs, generated caches, git diffs, or large source-code bodies.
Slot への保存:
- get_account_limits で plan limit と detail level を確認します。
- should_save_workbaton で保存判断を確認します。
- save_context には goal, current_state, next_action, decisions, blockers, validation, references を compact に入れます。
- 詳細な file path, API notes, failed attempts, validation notes は WorkStash に分けます。
Slot からの読み込み:
- 新しい AI 窓で resume_context(slot_number=N) または resume_context(slot_name="...") を実行します。
- AI は goal, current_state, next_action, decisions, blockers, validation, references を読みます。
- Slot metadata, response_language_hint, language_context, agent_continuity_guidance も利用可能な場合があります。
- WorkStash entry_key がある場合、現在の作業に必要な entry だけ get_work_stash で取得します。
MCP 接続時に AI が受け取る情報:
- WorkBaton は compact serial checkpoint handoff であり、chat log や file store ではありません。
- WorkStash は一時的な補助メモであり、永続的な knowledge base ではありません。
- local stdio wrapper が公式 WorkBaton 保存経路です。A2CR は client-encrypted WorkBaton body を復号できません。
- explain_a2cr_flows, get_account_limits, should_save_workbaton, save_context, resume_context, get_work_stash などの tool description と safety rule を AI が受け取ります。
自発利用:
- MCP tool descriptions、AGENTS.md / CLAUDE.md、読み込んだ WorkBaton が揃うと、対応 AI は必要に応じて WorkBaton / WorkStash を自発利用できます。
- context drift または context contamination を感じたら should_save_workbaton を呼び、必要なら compact WorkBaton を保存して新しい AI 窓への移行を提案します。