MCP 安装、验证与故障排查

先验证连接，再验证具体任务

MCP（Model Context Protocol）让 Tokeny 调用服务提供的工具。能初始化并列出工具，只说明连接成立；它不能证明登录、业务操作或每个平台都可用。

安装步骤

1. 从MCP 市场查看来源、连接方式、命令与所需运行环境。优先阅读上游说明。
2. 在 Tokeny 的 MCP 管理中添加服务。stdio 服务需要填写可执行命令和参数；远程服务需要提供方公开的连接地址与授权配置。
3. 检查运行环境中能找到命令。Windows 上终端可用而应用不可用时，检查应用进程的 PATH，必要时使用可执行文件的绝对路径。
4. 启动服务，确认工具列表。先运行只读、无账号的合成样例，再处理正式资料。

已验证的命令与边界

2026-11-05 在 Windows x64 主机上使用 Node.js MCP SDK 验证程序进行初始化和工具发现检查（不是 Tokeny 桌面端整套任务测试），六项服务均通过。以下版本是当次服务自报版本，不能当作所有平台的兼容保证。MarkItDown 还完成了一次本地合成 HTML 转 Markdown；未测试小红书登录后发布、点赞、评论或其他账号操作。

MarkItDown 命令：

uvx --prerelease=allow --from markitdown-mcp==0.0.1a8 markitdown-mcp

Serena 命令：

uvx --from serena-agent==2.1.0 serena start-mcp-server --context ide --agent-interface tools --open-web-dashboard false --enable-web-dashboard false --enable-gui-log-window false

如果界面把命令与参数分开，命令填写 uvx，后面的每个参数独立填写。不要将整行放入“可执行文件路径”。

用最小输入做验收

创建一个 HTML 文件，包含一个标题和一段普通文字。通过 MarkItDown 的 convert_to_markdown 工具转换它，检查标题和正文均保留，再逐步测试表格、链接或更大文件。需要复核当次范围时可下载验证记录；该记录只包含公开服务版本和验证范围。

同日补做了 Tokeny 1.7.6 桌面端实测：gpt-6-sol 在线模型实际调用 MarkItDown MCP，再将结果写入工作空间。上图展示工具返回和文件预览；可下载HTML 输入与实际转换结果。已对照确认标题、两段正文、日期和审批状态保留。其他五项服务的验证范围仍以上表为准。

失败时先查这些地方

了解Skill 与 MCP 如何组合，并在真实资料接入前检查数据去向。