MCP

1. OAuth で接続する（推奨）

ヘッダーなしでエンドポイントだけを追加してください。クライアントが Alt の認可サーバーを検出して自己登録し、ブラウザの同意画面を開きます。

• Alt は Dynamic Client Registration と PKCE に対応しているため、互換クライアントが OAuth を自動設定します。
• アクセスを承認する前に、ブラウザで要求された読み取り専用スコープとワークスペースを確認してください。
• OAuth は現在 Alt 管理者のみ利用できます。このアップグレード後に古い Alt OAuth 接続で認証できない場合は、クライアントから削除して一度追加し直してください。

2. クライアントを接続する

OAuth には URL だけの設定を使用します。OAuth client ID や secret は不要です。クライアントが OAuth を完了できない場合のみ API キーを使用してください。

https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

Customize → Connectors → Add custom connector を開き、上のエンドポイントを入力します。OAuth client ID と secret は空欄のまま Connect を選択してください。

Claude Code

claude mcp add --transport http alt https://mcp.altalt.io/mcp

サーバーを追加したら Claude Code で /mcp を開き、Alt を選択してブラウザー認証を完了してください。

Codex CLI

codex mcp add alt --url https://mcp.altalt.io/mcp
codex mcp login alt

# ~/.codex/config.toml
[mcp_servers.alt]
url = "https://mcp.altalt.io/mcp"

通常、サーバーを追加するとブラウザー認証まで完了します。認証が開始されない場合のみ codex mcp login alt を実行してください。

Cursor

URL のみを登録するワンクリックインストールです。Cursor の MCP 設定で Connect または Needs authentication を選び、ブラウザの同意画面で承認してください。

その他のクライアントと API キーによる代替

まず URL だけの OAuth 設定を使用してください。クライアントが MCP OAuth に対応していない場合は、Bearer API キー設定を使用します。

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp",
      "headers": { "Authorization": "Bearer alt_live_..." }
    }
  }
}

自動化や古いクライアントでは API キーも引き続き利用できます。アカウントコンソールでキーを作成し、必要なスコープだけを付与し、共有設定には残さないでください。キー管理はセキュリティを参照してください。

3. ツール

REST API をそのまま反映した読み取り専用ツール 4 つで、同じスコープを検査します。

• list_notes — キーから見えるノートの一覧 — カーソルページネーションと updated_after フィルターに対応（notes:read）。
• get_note — ノート 1 件のメタデータ — タイトル、文字起こし・要約の準備状態、タイムスタンプ（notes:read）。
• get_note_transcript — タイムスタンプと話者ラベル付きセグメントで全文の文字起こしを取得（transcripts:read）。
• get_note_summary — AI 要約を Markdown で取得（summaries:read）。

ノートは録音の終了後、または要約の生成後に表示されます — メモだけのノートは公開されません。コンテンツの準備前は transcript_not_ready / summary_not_ready を返すため、エージェントは後で再試行できます。