Althea MCP

Althea MCP

コーディングエージェントとあなたのAltheaを直接つなぎます。
共有研究メモリーと、同意を重視する、認証済みML研究者のネットワークです。

Codex、Claude Code、その他のコーディングエージェントを、あなた専用の Altheaに直接つなぎます。エージェントは、作業中のリポジトリから質問、コード、 コンテキストを彼女に渡せます。Altheaは共有研究メモリーを活用し、必要に応じて、同意を重視する認証済みML研究者のネットワークに助けを求めます。

• エージェント同士が会話できます。 質問、コード、実験結果、リポジトリのコンテキストを、コーディングエージェントとAltheaの間で共有できます。
• あなたのコンテキストを持つ、あなたのAlthea。 MCPは既存のアカウント、プロフィール、長期的な研究メモリーを使用します。
• 研究者ネットワークへの窓口。 Altheaは認証済みML研究者に助けを求められます。非公開のコンテキストを共有する前に、同意を確認します。
• クライアントごとの会話。 異なるスレッドキーを設定すると、CodexとClaudeの会話は分かれますが、Altheaは共有コンテキストを保持します。
• 非同期で作業できます。 返信を待つ、長時間かかる作業のメッセージを残す、後からスレッドを読む、といった使い方ができます。

セットアップ · クライアントの接続 · 最初の会話 · ツール · セキュリティとプライバシー · 開発

セットアップ

Altheaへのアクセス権とuvが必要です。 Althea MCPをPyPIからインストールし、メールで届く確認コードを使ってサインインします。

uv tool install althea-mcp
althea-mcp setup

インストールに成功してもコマンドが見つからない場合は、uv tool update-shell を実行して、新しいターミナルを開いてください。

対話型ターミナルで、自分でセットアップを実行してください。メールアドレスと確認コードは、AIチャットではなく、そのターミナルに入力してください。

Connect your personal Althea
-----------------------------
Email: [email protected]
A verification code was sent to [email protected].
Verification code:

Althea MCP is ready.
Credentials saved to ~/.config/althea-mcp/credentials.json

セットアップでは、AltheaのWebアプリと同じアカウント登録手順に従います。

• 既存のアカウントには、確認コードがメールで届きます。
• 新規登録の対象となる場合は、名前の入力を求められた後、確認コードが届きます。
• まだアクセス権が必要なアカウントは、Altheaの申請ページに案内されます。申請を完了してから、セットアップを再度実行してください。

インストールしたサーバーは、起動のたびにコードを取得することなく起動します。ツールの利用には、引き続きAltheaへのネットワーク接続が必要です。後からパッケージをアップグレードするには、次を実行します。

uv tool upgrade althea-mcp

MCP クライアントの接続

セットアップを一度完了したら、ローカルのstdioサーバーを追加します。クライアントごとに異なるスレッドキーを設定してください。

注意

このサーバーは、非公開のAltheaの履歴を読み取り、実際のメッセージを送信できます。 信頼できるクライアントとプロジェクトにのみ登録してください。

Codex

codex mcp add althea \
  --env ALTHEA_THREAD_KEY=codex \
  -- althea-mcp
codex mcp list

codex mcp addは、ユーザー設定に書き込みます。同等の設定を~/.codex/config.tomlに記述する場合は、次のとおりです。

[mcp_servers.althea]
command = "althea-mcp"

[mcp_servers.althea.env]
ALTHEA_THREAD_KEY = "codex"

Claude Code

claude mcp add althea \
  -e ALTHEA_THREAD_KEY=claude-code \
  -- althea-mcp
claude mcp list

このコマンドでは、Claude Code のプロジェクトローカルスコープが使用されます。開くすべてのプロジェクトでサーバーを利用できるようにする場合に限り、althea の直前に --scope user を追加してください。

トップレベルの mcpServers オブジェクト内にある、ユーザー全体に適用される手動設定を ~/.claude.json に記述すると、次のようになります。

{
  "mcpServers": {
    "althea": {
      "type": "stdio",
      "command": "althea-mcp",
      "env": {
        "ALTHEA_THREAD_KEY": "claude-code"
      }
    }
  }
}

Claude Desktop およびその他のローカルクライアント

インストールされているコマンドを確認します。

command -v althea-mcp

Windows PowerShell の場合：

(Get-Command althea-mcp).Source

GUI アプリケーションでは、ターミナルよりも PATH が短い場合があります。althea-mcp が見つからない場合は、上で返された絶対パスを使用してください。

{
  "mcpServers": {
    "althea": {
      "command": "/absolute/path/to/althea-mcp",
      "env": {
        "ALTHEA_THREAD_KEY": "claude-desktop"
      }
    }
  }
}

MCP の設定を変更した後は、クライアントを再起動してください。

会話を始める

MCP クライアントで、次のプロンプトのいずれかを試してください。

Ask my Althea whether anyone in the researcher network has worked on this
failure mode. Share only the sanitized summary below:
[summary]

Send this context to my Althea without waiting for a reply:
The latest experiment rules out the data-loader hypothesis. The remaining
failure starts after gradient accumulation.

Check whether my Althea has replied in the MCP thread.

メッセージは、設定されたスレッドで続きます。これらはあなた個人の Althea に送信される実際のメッセージであり、Althea が作業を開始するきっかけになる場合があります。

ツール

ツール	機能
ask_althea(message)	メッセージを送信し、最初の返信を待つためのデフォルト120秒のポーリング時間を使用します。時間が経過しても、作業は続いている場合があります。
send_message_to_althea(message)	メッセージをすぐに送信し、待機せずに受領確認を返します。コンテキスト、メモ、長めの依頼に使用してください。
get_althea_messages(sender=None, limit=10)	新しい順に並べられた、最近のメッセージを1〜100件返します。user、assistant、system で絞り込むこともできます。
search_althea_conversations(query=None, limit=10)	ユーザーの Althea アカウント内の会話を、タイトルまたはトピックで検索します。クエリを指定しない場合は、最近の会話を返します。
get_althea_conversation_log(conversation_id, limit=100)	所有する任意の会話から、直近のメッセージを新しい順に1〜100件、会話のメッセージ総数とともに返します。

2つの送信ツールは、状態を変更するツールとしてマークされています。会話の検索とメッセージの取得は読み取り専用です。現在のツールで扱えるのはテキストのみです。添付ファイルやその他の Althea の成果物には対応していません。

仕組み

Codex / Claude Code / another coding agent
                    │ local stdio
                    ▼
               Althea MCP
                    │ HTTPS
                    ▼
              your Althea
                    │
                    ├── your profile and long-term research memory
                    ├── a persisted conversation for this thread key
                    └── a consent-first network of verified ML researchers

Althea MCP は、小規模な公開アダプターです。フロントエンドはユーザーを認証し、正規の Althea を特定して、メッセージを送信し、結果の会話を保存します。呼び出し側が返信を待つ場合、パッケージは保存されたメッセージをポーリングします。コーディングエージェントが Althea と会話し、依頼に外部の専門知識が役立つ場合は、Althea が研究者ネットワークと連携します。

サインインとセッション

セットアップにより、通常の Althea 利用セッションが作成されます。

• アクセスセッションの有効期間は7日間です。
• ローテーションされるリフレッシュトークンのファミリーは、サインインから14日間有効です。
• アクセストークンは有効期限が切れる前に自動更新されます。
• プロセス間ロックにより、複数のローカル MCP クライアントがリフレッシュトークンのローテーションで競合することなく、認証情報ファイルを共有できます。
• セッションの有効期限が切れた場合、またはセッションが取り消された場合は、別のターミナルで althea-mcp setup を再度実行してください。実行中の MCP プロセスは、新しい認証情報を読み込みます。
• 再度サインインすると、認証情報のみがローテーションされます。Althea アカウントと ALTHEA_THREAD_KEY が同じであれば、会話履歴は置き換えられません。

認証情報は、~/.config/althea-mcp/credentials.json にプレーンテキストの JSON として保存されます。Unix のファイルモードに対応したオペレーティングシステムでは、認証情報ファイルのモードは 0600 に設定されます。Althea MCP が作成する親ディレクトリには 0700 が要求されます。既存のカスタムディレクトリを使用する場合は、自分でアクセス権を確認してください。

セキュリティとプライバシー

• これらのツールを通じて送信されたメッセージは、Althea の他のチャネルからのメッセージと同様に、Althea アカウントに保存されます。
• ローカルの stdio プロセスは、HTTPS 経由で Althea にメッセージと認証情報を送信します。ローカル転送であっても、会話データはお使いのマシンの外部に送信されます。
• 接続先の MCP ホストとモデルは、ツールの引数と応答を確認できます。それらは独自のプライバシーおよびデータ保持ポリシーに従って、データを保持する場合があります。
• Althea が研究者ネットワークに支援を求める際、プライベートな会話から得た情報を共有する前に、彼女は同意を求めます。
• このパッケージは、発行先の Althea オリジンにのみアクセス認証情報を送信します。ALTHEA_APP_URL を変更する場合は、新たにセットアップする必要があります。
• リフレッシュトークンは、セッションローテーションエンドポイントにのみ送信されます。
• メール確認コードと認証情報ファイルは秘密情報です。AI チャット、ターミナルの記録、issue、プルリクエストに貼り付けないでください。
• ローカルセッションを削除するには、MCP クライアントを終了して認証情報ファイルを削除します。これにより、そのマシン上のセッションが忘れられます。コピーされたセッションも失効させる必要がある場合は、Tiptree にお問い合わせください。

脆弱性は セキュリティポリシーに従って報告してください。

設定

ほとんどのユーザーは althea-mcp setup と、クライアントごとのスレッドキーだけが必要です。

環境変数	デフォルト	用途
ALTHEA_APP_URL	https://althea.tiptreesystems.com	Althea API のオリジンです。保存された認証情報はこのオリジンに紐付けられます。HTTP はループバック開発の場合にのみ使用できます。
ALTHEA_PUBLIC_SITE_URL	https://tiptreesystems.com	利用規約、プライバシー、アクセス申請のベース URL です。開発版 Althea では https://dev.tiptreesystems.com が自動的に選択されます。
ALTHEA_THREAD_KEY	mcp	安定した会話識別子です。先頭は英字または数字とし、英字、数字、ピリオド、アンダースコア、コロン、ハイフンを 1～128 文字使用してください。
ALTHEA_MCP_CREDENTIALS_FILE	~/.config/althea-mcp/credentials.json	ローカルの認証情報パスを上書きします。
ALTHEA_MCP_HTTP_TIMEOUT	60	HTTP タイムアウト（秒）です。
ALTHEA_MCP_POLL_INTERVAL	2	応答をポーリングする間隔（秒）です。
ALTHEA_MCP_POLL_TIMEOUT	120	ask_althea の最大待機時間（秒）です。
ALTHEA_MCP_LOG_LEVEL	WARNING	Python のログレベルです。

セットアップでは、認証情報パスを上書きする --credentials-file と、ブラウザーを開かずにアクセス申請 URL を表示する --no-browser も指定できます。

トラブルシューティング

Althea MCP is not configured

ターミナルで althea-mcp setup を実行し、その後 MCP クライアントを再起動してください。

Your Althea MCP sign-in has expired or was revoked

もう一度セットアップしてください。リフレッシュトークンのファミリーの有効期間は最長 14 日間です。

保存された認証情報が別の URL に紐付けられている

MCP クライアントが使用するものと同じオリジンを指定してセットアップしてください。

althea-mcp setup --app-url https://althea.example

その後、クライアント設定で対応する ALTHEA_APP_URL を設定してください。

ask_althea がタイムアウトした

Althea はまだ処理中の可能性があります。少し待ってから get_althea_messages を呼び出してください。

クライアントが althea-mcp を見つけられない

ターミナルで command -v althea-mcp を実行し、表示された絶対パスをクライアント設定で使用してください。

2 つのクライアントが会話を共有している

各クライアントに異なる ALTHEA_THREAD_KEY を割り当て、クライアントを再起動してください。

ローカル開発

git clone https://github.com/tiptreesystems/althea-mcp.git
cd althea-mcp
uv sync --locked --extra dev
uv run pytest -q
uv run ruff check althea_mcp tests
uv run ruff format --check .
uv build
uvx twine check dist/*

ローカルフロントエンドに対してセットアップを実行します。

uv run althea-mcp setup --app-url http://localhost:8080

サブコマンドを指定せずに althea-mcp を実行すると、stdio サーバーが起動します。明示的に指定する場合は althea-mcp serve とします。

コントリビューション

バグ報告と、対象を絞ったプルリクエストを歓迎します。投稿する前に コントリビューションガイドをお読みください。ログやフィクスチャから、すべてのメールアドレス、メッセージ、OTP、認証情報を削除してください。

ライセンス

MIT © Tiptree Advanced Systems Corporation.