1. Emlog 博客接入 MCP 的真实场景与痛点Emlog 是一套在国内站长圈里沉淀了很多年的轻量博客系统PHP 环境、MySQL 存储、后台简洁很多人拿它写技术笔记、做个人站点。但它的短板也很明显生态相对封闭官方 API 能力有限想让 AI 助手直接读写文章、管理分类、处理评论基本没有现成通道。Emlog MCP Server 就是冲着这个缺口来的——它把 Emlog 的博客能力包装成 Model Context Protocol 标准接口让 Claude、Cursor、Cline 这类支持 MCP 的客户端能通过统一协议调用博客资源。MCP 是什么你可以把它理解成「AI 工具世界的 USB-C 接口」。以前每接一个外部系统都要为不同 AI 客户端写一套适配有了 MCP服务端只要暴露标准化的 Resources 和 Tools任何支持该协议的客户端都能直接识别。Emlog MCP Server 暴露的能力包括文章列表、分类信息、评论、微语笔记、草稿、用户信息这些资源以及 create_article、update_article、search_articles、like_article、add_comment、create_note、upload_file、get_categories 等工具。换句话说你可以在对话框里说「帮我搜一下标签是 Docker 的文章」AI 就能通过 MCP 调 Emlog 的接口把结果拉回来。适合谁三类人最需要一是用 Emlog 做技术博客、想让 AI 帮忙批量整理旧文的站长二是把 Emlog 当内容中台、需要 AI 自动生成草稿再人工审核的运营三是折腾 MCP 生态、想拿真实业务练手的开发者。这篇内容聚焦本地安装和补充 API 配置重点解决两个高频卡点Emlog 自身的 API Key 怎么拿以及如何用 TaoToken 的统一 Key 把模型调用和 MCP 服务串起来。很多人卡在「服务起来了但 AI 客户端连不上」本质是 Base URL、Key、Model ID 三件套没对齐下面会一步步拆开。2. TaoToken 统一 Key 的前置准备与获取在配置 Emlog MCP Server 之前先把模型侧的凭证准备好。Emlog MCP Server 本身只负责和博客通信它不提供大模型能力真正让 AI 理解你指令、决定调用哪个工具的是背后的模型服务。TaoToken 在这里扮演的角色是统一入口一个 Key 覆盖多种主流模型Base URL 固定省去在多个平台之间来回切换的麻烦。先明确三个概念后面配置会反复用到Base URL模型请求的根地址TaoToken 的 API 入口是https://taotoken.net/api注意这个地址不带任何查询参数配置时原样填入即可。API Key身份凭证在控制台的 API Keys 页面生成格式通常是一串以sk-开头的字符串。生成后只显示一次务必当场复制保存。Model ID具体调用的模型标识比如claude-sonnet-4-5、gpt-4o这类。不同客户端对模型名的写法略有差异以文档页的模型列表为准。获取步骤很直接打开 TaoToken 控制台登录后进入 API Keys 管理页点新建给 Key 起个能认出来的名字比如emlog-mcp-dev生成后复制。如果你还没决定用哪个模型可以先在模型对话页面试几句确认响应正常再写进配置。这一步别省我见过太多人配置写完才发现 Key 复制时漏了尾字符排查半天。注意API Key 属于敏感凭证不要提交到 Git 仓库也不要写进前端代码。本地开发建议放在.env或客户端自己的配置文件里并加入.gitignore。对于长期做编码、Agent 类任务的同学可以关注 Coding Plan 这类套餐按调用量或周期计费比单次充值更适合高频场景。但如果你只是先跑通 Emlog MCP Server用按量付费的 Key 就够了没必要一上来就上套餐。文档页有完整的接入说明和示例遇到字段不确定时优先查文档比在群里问快得多。3. 可复制的 config.toml 与 settings.json 配置骨架这一节是全文的核心直接给可复制的配置。Emlog MCP Server 的配置分两层一层是服务自身的环境变量.env负责连 Emlog另一层是 AI 客户端的 MCP 配置config.toml或settings.json负责启动这个服务并注入模型凭证。两层都要对缺一个就连不上。先看 Emlog MCP Server 自己的.env。克隆项目后复制示例文件git clone https://github.com/eraincc/emlog-mcp.git cd emlog-mcp npm install cp .env.example .env然后编辑.env填入 Emlog 站点地址和 API Key# Emlog API 基础 URL必需 EMLOG_API_URLhttps://your-emlog-site.com # Emlog API 密钥必需 EMLOG_API_KEYyour_api_key_hereEmlog 的 API Key 在后台「设置」→「API 接口」里启用并生成。生成后复制到上面第二行。这一步是 Emlog 侧的凭证和 TaoToken 的 Key 是两回事别搞混。接着构建并确认服务能独立跑起来npm run build npm start看到服务监听端口的日志说明 Emlog 侧通了。接下来是 AI 客户端的 MCP 配置。以 Claude Code 或 Cline 这类支持 TOML 的客户端为例config.toml骨架如下[mcp_servers.emlog] command node args [/absolute/path/to/emlog-mcp/dist/index.js] [mcp_servers.emlog.env] EMLOG_API_URL https://your-emlog-site.com EMLOG_API_KEY your_emlog_api_key # TaoToken 统一模型入口 OPENAI_BASE_URL https://taotoken.net/api OPENAI_API_KEY sk-你的TaoToken密钥 OPENAI_MODEL claude-sonnet-4-5如果你的客户端用settings.json比如某些 VS Code 插件形态结构等价{ mcpServers: { emlog: { command: node, args: [/absolute/path/to/emlog-mcp/dist/index.js], env: { EMLOG_API_URL: https://your-emlog-site.com, EMLOG_API_KEY: your_emlog_api_key, OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: sk-你的TaoToken密钥, OPENAI_MODEL: claude-sonnet-4-5 } } } }三件套对照表配置时逐项核对配置项填写内容常见错误Base URLhttps://taotoken.net/api多写/v1或带查询参数API Keysk-开头的 TaoToken 密钥复制时漏字符、混入空格Model ID文档页列出的模型名用了客户端不认的别名路径args必须是绝对路径相对路径在客户端启动时工作目录不确定很容易报「找不到模块」。Windows 下路径用双反斜杠或正斜杠别直接粘C:\...单反斜杠。4. 启动服务并验证 MCP 连通性的具体命令配置写完怎么确认真的通了分三步验证从底层到上层。第一步单独验证 Emlog MCP Server 能启动。在项目目录执行node dist/index.js正常会输出类似「Emlog MCP Server running」的日志。如果报Cannot find module检查npm run build是否成功、dist目录是否存在。如果报连接 Emlog 失败回到.env核对EMLOG_API_URL是否带https://、站点是否可访问。第二步验证模型侧凭证。用 curl 直接打 TaoToken 的接口确认 Key 和 Base URL 没问题curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: ping}] }返回带choices字段的 JSON说明模型通道正常。如果返回 401就是 Key 错了返回 404多半是路径写错注意 Base URL 是https://taotoken.net/api具体端点路径以文档为准。第三步在 AI 客户端里验证 MCP 工具是否被识别。重启客户端后在对话里输入类似「列出 emlog 的所有分类」的指令。客户端应该会触发get_categories工具调用返回分类列表。如果客户端显示「未找到 MCP 服务器」检查config.toml的command和args是否正确、Node 是否在 PATH 里。实测下来最容易出问题的是第三步服务能跑、curl 也通但客户端就是不认。九成原因是配置文件位置放错了——不同客户端读取的配置路径不一样Claude Code 读项目级或用户级的config.tomlCline 读插件设置里的 JSON。确认你改的是客户端实际加载的那份文件改完必须完全重启客户端热重载有时不生效。5. 本篇常见报错排查401、local proxy failed 与 reading choices配置过程中会撞上几类典型报错逐个拆解。401 Unauthorized。这个最直接就是凭证不对。分两种情况如果是 curl 打 TaoToken 返回 401检查Authorization头里的 Key 是否完整、有没有多余空格如果是 Emlog MCP Server 调 Emlog 接口返回 401检查.env里的EMLOG_API_KEY是否是后台生成的那串、API 功能是否已启用。两个 Key 别互相填错位置。local proxy failed。这个报错通常出现在客户端启动 MCP 服务时意思是本地进程没能正常拉起。原因有三一是args里的路径不是绝对路径客户端在别的目录下执行找不到文件二是 Node 版本太低Emlog MCP Server 依赖较新的 Node 运行时建议 18 以上三是端口被占用如果服务里写死了端口换个端口或杀掉占用进程。排查方法是在终端手动执行node /absolute/path/to/dist/index.js看能否复现同样的错误能复现就是服务本身的问题不能复现就是客户端配置的问题。reading choices。这个报错来自模型响应解析阶段通常是返回体结构不符合预期。常见原因是 Base URL 写成了https://taotoken.net/api/v1而客户端又自动拼了一次/v1导致请求打到不存在的路径返回的不是标准 chat completion 结构。解决方法是把 Base URL 统一成https://taotoken.net/api让客户端自己处理版本路径。另一个原因是 Model ID 写错服务端返回错误对象而非正常响应解析choices时自然报错。对照文档页的模型名逐个核对。OAuth 相关报错。部分客户端在首次连接 MCP 服务时会尝试 OAuth 流程如果服务端没实现对应端点就会卡住或报错。Emlog MCP Server 走的是本地进程模式不需要 OAuth遇到这类提示检查客户端是否误开了远程 MCP 模式切回本地 stdio 模式即可。报错根因处理401Key 错误或缺失核对两处 Key确认无空格local proxy failed路径/Node 版本/端口绝对路径 Node 18reading choicesBase URL 或 Model ID 错统一https://taotoken.net/apiOAuth 卡住客户端误开远程模式切回本地 stdio排查时养成一个习惯先在终端手动跑服务再在客户端里跑。终端能复现的问题改配置终端不能复现的改客户端。这样能把问题范围缩小一半。6. 把 Emlog MCP 用起来的下一步服务通了之后真正的价值在于把工具用起来。Emlog MCP Server 提供的search_articles支持关键词、标签、分类筛选配合 AI 可以快速做内容盘点create_article和update_article适合批量整理旧文、补标签、改摘要get_draft_list和get_draft_detail能把草稿拉出来让 AI 润色后再回写。这些操作都通过标准 MCP 工具调用完成不需要你手写 Emlog 的 HTTP 请求。如果你打算长期跑这套组合建议把模型调用切到 Coding Plan 这类更适合高频 Agent 场景的方案避免按量计费在批量任务里成本失控。接入文档里有完整的字段说明和示例遇到配置细节不确定时优先查文档。模型对话页面可以快速验证某个 Model ID 是否可用省得在配置文件里反复试错。最后留一个实用技巧把 Emlog MCP Server 的dist目录部署到服务器后用node index.js后台运行配合进程管理工具保活。本地开发时用npm run dev热重载改完代码即时生效。配置文件和.env都加进.gitignoreKey 泄露的代价远比省事大。