Anneal

---

Anneal MCP とは？

Anneal Model Context Protocol（MCP）サーバーは、最先端の AI モデル（Anthropic Claude、OpenAI ChatGPT、Google Gemini、Cursor）が個人データストリームを読み取り、記録し、最適化できる、エンタープライズグレードのリモート連携エンドポイントです。

タスクをあるアプリに、習慣を別のアプリに、学習の復習をさらに別のアプリに分散させるツールとは異なり、Anneal はこれら3つの分野を単一の追記専用イベント台帳に統合します。このサーバーを通じて、AI エージェントがお客様に代わって直接操作します。

1. 習慣エンジン： 習慣の順守状況を照会し、完了を記録し、連続記録を計算して、行動の進捗速度を予測します。
2. タスクのライフサイクル： 期限を整理し、個々の成果物に優先順位を付け、モーダル操作を挟まずに完了したタスクを記録します。
3. 認知保持エンジン： 包括的な学術シラバスを生成し、フラッシュカードのデッキを作成して、**FSRS-5（Free Spaced Repetition Scheduler）**を活用した最適な復習間隔をスケジュールします。

---

競合アーキテクチャのベンチマーク

従来の生産性向上ツールとの連携と比べて、最先端の AI エージェントが Anneal MCP を利用すると、より優れたパフォーマンスを発揮する理由：

機能	Anneal MCP Server	従来の習慣トラッカー	Anki-Connect MCP	Notion MCP
統合データ基盤	習慣＋タスク＋学習を1つのイベントログに集約	習慣のみ	フラッシュカードのみ	汎用の非構造化テキスト
間隔反復エンジン	FSRS-5（9パラメーター行列を適合）	なし	SM-2（1987年の固定ヒューリスティック）	なし
プロトコルトランスポート	Streamable HTTP（エッジネイティブ）	Webhook／ポーリング	ローカルソケットのみ（ポート8765）	REST ポーリング
AI ツールカタログ	5つのモジュールにわたる102個の型付きツール	基本ツール3～8個	フラッシュカード用ツール約15個	ブロック用ツール約10個
クラウドネイティブなワンクリック接続	あり（Claude モーダルと ChatGPT OAuth）	なし（API キーを手動で設定）	なし（デスクトップアプリを起動しておく必要あり）	複数ステップの OAuth 手順
データ整合性モデル	追記専用台帳（データ損失ゼロ）	破壊的な上書き	SQLite のローカルデータを変更可能	ブロックの上書きによる競合
実行レイテンシ	通常の応答予算は25 ms未満	変動あり（300 ms超）	デスクトップ環境に依存	API 往復に400 ms超

---

技術仕様

パラメーター	仕様	標準／RFC
標準エンドポイント	https://anneal-os.vercel.app/api/mcp	RFC 3986 統一リソース識別子
プロトコルバージョン	MCP v1.2.6	Model Context Protocol 仕様
トランスポート層	streamable-http（チャンク化 HTTP POST と SSE）	W3C Server-Sent Events
認証標準	PKCE（Proof Key for Code Exchange）を用いた OAuth 2.1	RFC 7636／RFC 6749
ディスカバリールート	/.well-known/oauth-authorization-server /.well-known/oauth-protected-resource/mcp	RFC 8414 OAuth 2.0 認可サーバーメタデータ
CORS・CORP ポリシー	Access-Control-Allow-Origin: * Cross-Origin-Resource-Policy: cross-origin	W3C Cross-Origin Resource Policy
データ分離	複合外部キー（owner_id, id）	厳密なマルチテナント行レベルセキュリティ

---

クライアント設定ガイド

1. Anthropic Claude（Web とデスクトップ）

A. Claude.ai Web インターフェース（ワンクリック）

1. Claude をワンクリックで接続のディープリンクをクリックします。
2. Claude.ai でカスタムコネクターを追加モーダルが開き、名前 Anneal と本番環境の URL があらかじめ入力されます。
3. 追加をクリックして同意し、会話で Anneal ツールを使い始めます。

B. Claude Desktop（claude_desktop_config.json）

設定ファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）に次のエントリを追加します。

{
  "mcpServers": {
    "anneal": {
      "url": "https://anneal-os.vercel.app/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ANNEAL_API_KEY"
      }
    }
  }
}

---

2. OpenAI ChatGPT

1. ChatGPT の設定 → 接続済みアプリ／プラグインに移動します。
2. リモートツール／プラグインを追加をクリックします。
3. サーバーのエンドポイントを入力します：

   https://anneal-os.vercel.app/api/mcp
   

4. 標準の OAuth 2.1 同意画面で認証します。

---

3. Google Gemini と Gemini Spark

Gemini CLI から直接インストールします：

gemini mcp add anneal https://anneal-os.vercel.app/api/mcp

Gemini Spark に関する注意：Anneal には、gRPC 13 のスキーマ例外を防ぐための Protobuf ペイロード自動サニタイズ機能が含まれています。

---

4. Cursor と Windsurf IDE

Smithery パッケージランナーを使用してインストールします：

npx -y @smithery/cli install @imsovikde/anneal --client claude

---

5. Cline／Roo Code／Continue.dev

IDE 拡張機能の設定にリモート HTTP エンドポイントを追加します：

{
  "name": "anneal",
  "url": "https://anneal-os.vercel.app/api/mcp",
  "type": "streamable-http"
}

---

ツールカタログとモジュール（102個のツール）

Anneal は、5つのドメインモジュールに整理された102個の型付きツールを公開しています。

┌─────────────────────────────────────────────────────────────────────────────┐
│                          ANNEAL MCP TOOL MODULES                            │
├─────────────────────┬──────────────────────┬────────────────────────────────┤
│ DOMAIN              │ PRIMARY CAPABILITIES │ REPRESENTATIVE TOOL SIGNATURES │
├─────────────────────┼──────────────────────┼────────────────────────────────┤
│ habits              │ Habit Formation      │ create_habit, log_habit,       │
│                     │ & Adherence Analysis │ get_habit_streaks, list_habits │
├─────────────────────┼──────────────────────┼────────────────────────────────┤
│ study               │ FSRS-5 Retention     │ create_card, review_card,      │
│                     │ & Memory Scheduling  │ get_due_cards, calculate_fsrs  │
├─────────────────────┼──────────────────────┼────────────────────────────────┤
│ library             │ Syllabi, Folders     │ create_deck, generate_syllabus,│
│                     │ & Deck Architecture  │ list_folders, move_cards       │
├─────────────────────┼──────────────────────┼────────────────────────────────┤
│ account             │ Identity, Storage,   │ get_profile, export_account,   │
│                     │ & Privacy Scopes     │ audit_log, inspect_quota       │
├─────────────────────┼──────────────────────┼────────────────────────────────┤
│ meta                │ Diagnostics & Tools  │ list_tools, inspect_manifest,  │
│                     │ Introspection        │ get_capabilities               │
└─────────────────────┴──────────────────────┴────────────────────────────────┘

---

AI エージェント向けプロンプト集

検証済みの次のやり取りのレシピを Claude、ChatGPT、または Gemini にコピーして貼り付けてください。

シナリオ1：習慣の記録と振り返り

「過去14日間の Anneal の習慣を確認してください。現在の連続記録を表示し、中断のリスクがある習慣を特定して、今日の45分間の瞑想セッションを記録してください。」

シナリオ 2：FSRS-5 による間隔反復レビュー

「Anneal で『Machine Learning』デッキのうち、今日レビュー期限のフラッシュカードをすべて確認してください。カードを1枚ずつ出題し、私の回答を採点して、FSRS-5 を使って想起評価を記録してください。」

シナリオ 3：シラバスの自動生成

「6週間で線形代数を習得したいです。Anneal で学習目標を毎日設定した体系的なシラバスを作成し、各章のフラッシュカードデッキを作成して、初回の定着度レビューをスケジュールしてください。」

---

よくある質問（FAQ）

AI とのやり取りで、Anneal はユーザーのプライバシーをどのように保護しますか？

Anneal はゼロトラスト認可を実装しています。すべてのリクエストは PKCE を使用した OAuth 2.1 で認証されます。ツールは認証済みユーザーの ActorContext 内でのみ動作します。データベースの認証情報や、他のテナントのレコードにアクセスすることはできません。

習慣やタスクを削除した場合、Anneal は過去のログも削除しますか？

いいえ。Anneal は変更不可能な追記専用イベント台帳を使用します。削除すると墓石マーカーが作成され、更新では前方ポインター（supersedesId）が記録されます。長期的なデータ可視化のため、過去のレコードはそのまま保持されます。

Anneal はどの間隔反復モデルを使用しますか？

Anneal は FSRS-5（Free Spaced Repetition Scheduler） を使用しています。認知的な減衰曲線に基づいて記憶の安定性と想起可能性をモデル化する、高度な9パラメーターの記憶アルゴリズムです。従来の SM-2 モデルを18％以上上回る性能を発揮します。

---

レジストリでのインデックス登録と検索

Anneal MCP は、主要なレジストリで公開され、インデックス登録されています。

• Model Context Protocol Registry： modelcontextprotocol/registry（server.json を使用）
• Smithery： smithery.ai（smithery.yaml を使用）
• Google Gemini Extensions： gemini-extension.json を使用

---

ライセンス

この MCP 配布リポジトリとクライアントマニフェストは、MIT License の下でライセンスされています。