MCP

使用 Claude 连接器连接

Alt 已收录在 Claude 连接器目录中，多数情况下无需接触下方端点。在 Claude 中打开 Customize → Connectors，搜索 Alt 并选择 Connect。

• 在 Alt 的授权页面批准访问，并选择连接器可读取的一个工作区——个人笔记，或某一个频道。
• 无需粘贴地址，也无需创建 API 密钥。Claude 会通过 OAuth 自行注册。
• 需要付费方案的 Alt 账户。免费账户可以打开授权页面，但批准时会收到 plan_required 错误。
• 设计上只读：仅列出笔记并读取转写与摘要，不会写入。可随时在 账户控制台 解除授权。

1. 使用 OAuth 连接（推荐）

只添加端点，不添加 header。客户端会发现 Alt 授权服务器、自动注册，并打开浏览器同意页面。

• Alt 支持 Dynamic Client Registration 和 PKCE，因此兼容客户端会自动配置 OAuth。
• 批准访问前，请在浏览器中检查请求的只读 scope 和 workspace。
• 连接需要付费方案的 Alt 账户。免费账户可以打开授权页面，但批准时会收到 plan_required 错误。

2. 连接客户端

OAuth 请使用仅包含 URL 的配置。无需 OAuth client ID 或 secret；只有客户端无法完成 OAuth 时才使用 API 密钥。

https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

仅在连接其他 Alt 环境时才使用自定义连接器：打开 Customize → Connectors → Add custom connector，输入上方端点，并将 OAuth client ID 和 secret 留空。

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 密钥。请在账户控制台创建密钥，只授予所需 scope，不要写入共享配置，并参阅安全了解密钥管理。

3. 工具

四个只读工具,与 REST API 一一对应,并检查相同的 scope。

• list_notes — 列出密钥可见的笔记 — 支持游标分页和 updated_after 过滤(notes:read)。
• get_note — 获取单条笔记的元数据: 标题、转写/摘要就绪状态、时间戳(notes:read)。
• get_note_transcript — 以带时间戳和说话人标签的分段获取完整转写(transcripts:read)。
• get_note_summary — 以 Markdown 获取 AI 摘要(summaries:read)。

笔记会在录音结束或摘要生成后出现 — 仅有备忘的笔记不会导出。内容就绪前工具会返回 transcript_not_ready / summary_not_ready,代理可以稍后重试。