Anarlog MCP 服务器安装与配置指南：为 AI Agent 打通会议数据读取能力

Anarlog MCP 服务器安装与配置指南为 AI Agent 打通会议数据读取能力【免费下载链接】anarlogOpen source Granola AI Alternative项目地址: https://gitcode.com/GitHub_Trending/hy/anarlog本指南以agent-plugins/anarlog插件中针对 LLM/Agent 的安装说明llms-install.md为主体系统讲解如何为 Claude、Codex、Cursor 等 Agent 宿主配置 Anarlog 的托管 Cloud MCP 服务器、如何验证工具是否就绪、以及在云快照缺失时如何用本地anarlogCLI 兜底。读完本文你将掌握一套完整、可复现的 Agent 接入 Anarlog 会议数据的实战方案包括 OAuth 自动发现、工具清单校验、无头登录与数据安全边界。安装前的前置条件在配置 MCP 服务器之前先确认两个前提否则后续步骤无法生效拥有 Anarlog Pro 账号托管 Cloud MCP 面向订阅用户开放账号需处于有效状态。开启 Cloud API 与连接器在桌面应用中进入Settings → Developers → Cloud API Connectors阅读隐私披露说明后启用该开关然后等待你的会议快照meeting snapshots上传到云端。这两步与插件级安装README.md要求一致首次使用工具时宿主会从https://api.anarlog.so/mcp端点自动发现 Anarlog 的授权服务器随后弹出 Anarlog 的登录与授权确认流程全程无需手动粘贴云 API Key。也就是说只要完成了账号启用MCP OAuth 是自动完成的。核心步骤配置托管 Cloud MCP 服务器llms-install.md给出的安装流程共五步是接入的权威操作序列确认用户已拥有 Anarlog Pro并在桌面应用中启用Settings → Developers → Cloud API Connectors。配置一个名为anarlog的 HTTP MCP 服务器端点指向https://api.anarlog.so/mcp。宿主应从这个端点自动发现 OAuth 授权流程只有在宿主无法完成 MCP OAuth 的情况下才考虑手动粘贴云 API Key。启动服务器并确认工具列表中包含list_meetings、get_meeting、get_meeting_transcript、get_recurring_meeting_history、export_meeting五个核心工具。如果 Cloud 返回的会议列表缺少用户预期的会议先检查anarlog是否在PATH中执行anarlog --version并用anarlog --json补齐缺口若 CLI 缺失提示用户从Anarlog → Settings → Developers安装或参照官方安装文档。未经许可不得自行安装软件或搜索文件系统。绝不直接查询或修改 Anarlog 的 SQLite 数据库。最后一条边界在插件层同样被反复强调见 SKILL.md 与 cli.mdCLI 与 MCP 服务器通过 Anarlog 的兼容层处理应用 schemaAgent 绕过它们直接读写数据库会破坏数据一致性。手动添加 MCP 服务器配置对于不支持插件市场安装的客户端可以在客户端配置文件中直接声明托管服务器。插件自带的 mcp.json 给出了标准声明{ $schema: https://agent-plugins.org/schemas/1.0.0/mcp.schema.json, mcpServers: { anarlog: { type: http, url: https://api.anarlog.so/mcp } } }在常见客户端中同样可直接使用 JSON 形式{ mcpServers: { anarlog: { url: https://api.anarlog.so/mcp } } }也可以在支持命令行添加 MCP 的客户端中直接执行以 Claude Code 为例claude mcp add --transport http anarlog https://api.anarlog.so/mcpClaude 会从该 MCP 端点自动发现 OAuth 授权服务器。验证工具是否就绪步骤 3 的验证点是必须检查的只有五个核心工具全部列出说明 OAuth 握手成功且 Cloud 快照服务可访问。这五个工具的全部职责如下详见 mcp.md工具用途list_meetings按标题、ID 片段或重复会议系列查找近期会议返回空列表即表示无匹配不得臆造会议get_meeting读取元数据、规范笔记、摘要、参与者和行动项get_meeting_transcript分页读取转录内容默认limit: 200词按需通过pagination.next_offset继续get_recurring_meeting_history查找与已知会议同属一个重复系列的历次会议export_meeting读取包含完整转录在内的完整会议记录仅当小粒度读取不足时使用工具与资源全景除上述五个只读工具外MCP 层还暴露了本地模式下才有的提案proposal工具以及两类 URI 资源本地 MCP 提案工具只暂存、不落库工具用途propose_summary_edit暂存完整的摘要替换存在多个摘要时需传target_idpropose_memo_edit暂存完整的笔记替换list_proposals列出已暂存的提案默认过滤status: pendingget_proposal读取单个提案及其统一的diffdecline_proposal丢弃待处理提案而不改动会议已应用的提案无法被拒绝资源 URIanarlog://meetings/{meeting_id}anarlog://meetings/{meeting_id}/transcript{?offset,limit}anarlog://series/{series_id}使用原则工作流需要结构化 JSON 时优先用工具客户端需要简洁的 Markdown 或纯文本上下文时使用资源。转录资源的默认分页同样为 200 词、上限 500 词且只返回纯文本。Cloud 快照缺失时的本地 CLI 兜底托管 Cloud MCP 是只读的且只包含用户主动上传的快照。当list_meetings返回空列表或缺少某场会议时正确做法是用本地 CLI 二次检索而不是直接告诉用户没有数据这也是 errors.md 明确要求的处理路径。安装 CLI在桌面应用Anarlog → Settings → Developers选择Install各平台的安装路径如下macOS 与 LinuxDEB / AppImage~/.local/bin/anarlogWindows%LOCALAPPDATA%\Anarlog\bin\anarlog.exeMac App Store 版本不附带 CLI 安装需要从源码构建setup.mdgit clone https://gitcode.com/GitHub_Trending/hy/anarlog cd anarlog cargo install --locked --path apps/cli anarlog --version安装后先运行一次 Anarlog 桌面应用让本地数据库被创建此后即使应用关闭CLI 也能正常工作。注意平台差异Flatpak 发行版中命令名为anarlog-cli而 DEB、AppImage、macOS、Windows 及 Settings 安装版本均为anarlog。无头环境登录Cloud 登录不要求 Anarlog 所在机器有图形会话。执行anarlog auth loginCLI 会打印一个登录 URL在任意设备的浏览器中打开并完成登录选择Copy URL再把形如anarlog://auth/callback的回调链接粘贴到 CLI 的隐藏输入框中。绝不能让用户在聊天中粘贴该回调链接也不得把它写进命令参数——其中包含账号令牌。验证会话状态anarlog --json auth status在使用--json时登录 URL 打印到 stderr回调从 stdin 读取便于脚本化处理。Linux 下会话优先使用 Secret Service不可用时退回到权限为0600的本地认证文件。退出登录使用anarlog auth logout。CLI 常用命令集所有面向 Agent 的输出都应使用--jsoncli.md# 环境自检ready:false 时命令以退出码 1 结束 anarlog --json doctor # 本地库检索会议 anarlog --json meetings list --query planning --limit 20 --offset 0 # 读取云端托管快照需 auth login anarlog --json meetings --source cloud list --query planning --limit 20 --offset 0 # 按 ID 读取单场会议 anarlog --json meetings --source auto get MEETING_ID anarlog --json meetings get MEETING_ID # 读取笔记/摘要 anarlog --json meetings note MEETING_ID --kind note anarlog --json meetings note MEETING_ID --kind summary # 重复系列历史 anarlog --json meetings history MEETING_ID --limit 20 --offset 0 # 分页读取转录200 词一页 anarlog --json meetings transcript MEETING_ID --limit 200 --offset 0 # 提案暂存编辑 anarlog --json proposals list --meeting MEETING_ID anarlog --json proposals create --meeting MEETING_ID --kind summary --content Replacement markdown anarlog --json proposals show PROPOSAL_ID anarlog --json proposals decline PROPOSAL_ID # 显式导出完整会议 anarlog meetings export MEETING_ID --format markdown --output meeting.md anarlog meetings export MEETING_ID --format json --output meeting.json关键语义要点会议命令默认--source local--source cloud读取托管快照--source auto在本地数据库存在时用本地、否则用云端。proposals create只是暂存一个待处理编辑会议并未被修改由人类用户在桌面应用中批准或拒绝。导出命令拒绝覆盖已有文件只有用户明确批准替换该确切路径时才传--force。JSON 成功响应包含schema_version、command、data与可选的pagination仅在确实需要更多上下文时沿next_offset继续翻页。数据库路径可全局覆盖anarlog --db-path /path/to/app.db --json meetings list或anarlog --base /path/to/anarlog-data --json meetings list也可用环境变量ANARLOG_DB_PATH仅当数据库位于自定义位置时使用。可选完全本地的 stdio MCP若需要完全不使用 Cloud 的本地 Agent可自行启动 stdio 服务器anarlog mcp通用客户端配置如下{ mcpServers: { anarlog: { command: anarlog, args: [mcp] } } }修改 MCP 配置后需重启客户端。注意插件市场的托管版本不会启动这个本地服务器本地 stdio 服务器只用于填补 Cloud 缺失的缺口不应在 Cloud 已返回结果时将其当作第二数据源见 SKILL.md。数据安全与操作边界托管 Cloud MCP 只读暂存笔记或摘要编辑必须走本地 CLI 或本地 MCP 的提案工具由人类在桌面应用中应用或拒绝。绝不触碰 SQLiteCLI 与 MCP 服务器承担 schema 兼容职责Agent 不得直接查询或修改数据库也不得自行执行迁移或编写 SQL。上下文有界转录按词分页默认 200、上限 500只在必要时沿next_offset翻页能用一个会议详情或笔记回答的问题就不要导出整场会议。隐私处理会议内容属于用户私密数据未经明确授权不得发送给其他服务或人员。答案要落地只引用实际调用工具返回的会议、标题、日期与 ID明确标注数据来源是 Cloud 还是本地库绝不从对话或相似名称中臆造会议。常见故障排查errors.md 给出了各错误的处置原则摘录如下Meeting not found重新列出或搜索会议并使用返回的 ID不要重试猜测的 ID。No meetings returnedCloud 返回空列表时先用anarlog --json meetings list在本地再搜一次空列表通常意味着快照未开启或该会议尚未上传。只有所有可及来源均为空时才告知用户未找到。Database not found运行anarlog --json doctor若数据库不存在请用户先打开一次 Anarlog自定义路径则使用--db-path或ANARLOG_DB_PATH。Database operation failed确认桌面应用与 CLI 来自兼容版本Agent 不得执行迁移或写 SQL。Cloud command failed保留 CLI 返回的托管错误码——unauthorized时重新anarlog auth logincloud_api_not_enabled时请用户启用Cloud API Connectorsrate_limited时等待返回的重试延迟。不要静默把用户显式要求的--source cloud读取切换到本地数据。Export output exists选择新路径只有用户明确批准替换该文件时才传--force。MCP server exits先运行anarlog --json meetings list区分数据库访问与客户端配置问题确认 MCP 命令是anarlog且唯一必需参数是mcp。缺失的会议/提案属于无效参数校验与冲突失败如拒绝非 pending 提案属于 MCP 内部错误。退出码约定1操作失败、2数据缺失、3数据库缺失、4导出目标已存在非法 CLI 参数使用 Clap 的退出码并带有invalid_arguments错误码。--json错误响应含schema_version与error对象code、message、exit_code。实现层面的佐证从仓库源码结构看CLI 的命令路由集中在 apps/cli/src/cli.rsMCP 服务器入口在 apps/cli/src/mcp.rsCloud 快照读取与授权逻辑在 apps/cli/src/cloud.rs 与 apps/cli/src/db.rs 中组织构建配置见 apps/cli/Cargo.toml云端 API 服务层则位于 crates/api-cloud/src。插件元数据名称、版本、关键词、仓库地址声明在 plugin.json插件级安装指引见 README.mdAgent 工作流选择数据源、查会议、落地答案、上下文有界、安全处理的完整规范见 SKILL.md。小结接入 Anarlog 的 MCP 只需一条主线前置开启 Cloud API → 配置托管端点OAuth 自动发现→ 校验五个只读工具 → Cloud 缺失时用本地 CLI 兜底。全程遵守只读快照、提案式编辑、禁止直连 SQLite三条安全边界即可让任何支持 HTTP MCP 的 Agent 安全、合规地访问会议、笔记、摘要与转录数据。【免费下载链接】anarlogOpen source Granola AI Alternative项目地址: https://gitcode.com/GitHub_Trending/hy/anarlog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考