String AI Web Access MCP Server 是 String AI Web Access API 的官方 Model Context Protocol（MCP）服务器，用于让 LLM 通过 MCP 协议访问网页内容。
用途 该服务器为 MCP 兼容客户端提供网页访问能力：搜索网页、抓取任意 URL 或向其发送请求、映射站点 URL，返回结果均为适合 LLM 使用的干净 Markdown。需要网页内容时，LLM 可调用 web_access_fetch、web_access_search 或 web_access_sitemap。
主要工具
- web_access_fetch、web_access_search、web_access_product_help 为只读操作。
- web_access_request 为写入操作；web_access_sitemap 会创建计费的爬取任务。
- 托管服务器 https://mcp.usestring.ai/v1/mcp 提供六种工具。npm 包提供其中五种：包含产品帮助和失败报告，但不含 web_access_request，写入操作通过 web_access_fetch 的 method 和 body 参数进行。
- web_access_sitemap：站点地图爬取任务，异步两阶段流程——报价、批准、轮询、读取；在明确批准报价前不会爬取或计费。
- web_access_report：失败诊断，可选且尽力而为。应先继续有用的恢复操作；若报告仍有价值且被允许，每个任务对每种不同失败最多发送一次报告，而非每次重试都发送。报告异常、超时、工具错误或不可用输出；排除可用的源状态、有效否定结果、空 204 响应、运行中的站点地图任务和取消操作。每次报告尝试有 2 秒截止时间。调用前需移除 Authorization 头、API 密钥、Cookie、会话令牌、个人数据及无关对话内容；服务器会再次对常见凭据形式进行脱敏。切勿报告 web_access_report 失败，也不要仅为收集报告上下文而重复失败调用。报告使用配置的 API 密钥进行认证，但不消耗 Web Access 信用。如果报告不可用、未授权、被限流或失败，请停止该任务的报告。
使用方式 安装：支持全局安装或从源码构建。配置环境变量，然后在客户端中配置。
- VS Code：按 Ctrl+Shift+P → Preferences: Open User Settings (JSON) 并添加配置；或添加 .vscode/mcp.json 文件与团队共享配置。
- Windsurf：打开 Settings → Features → MCP Servers → + Add new global MCP server 并粘贴配置；或添加到 ~/.codeium/windsurf/model_config.json。
- Claude Desktop：添加到 claude_desktop_config.json。 测试：使用 MCP Inspector 可在浏览器中交互测试服务器——打开 http://127.0.0.1:6274，通过 stdio 连接，在 UI 中调用各工具。IDE 会将该服务器作为子进程启动，并通过 stdio 通信。
工作原理 LLM 决定需要网页内容时，调用 web_access_fetch、web_access_search 或 web_access_sitemap。每次失败调用会通过 web_access_report 准确报告一次，即使后续恢复成功。服务器使用环境中的 API 密钥将请求转发至 String AI 的 Web Access API，并将结果返回给 LLM。
适用场景与限制 适用于任何兼容 MCP 的客户端（VS Code、Cursor、Windsurf、Claude Desktop 等），为 LLM 提供网页搜索、抓取、站点映射及内容 Markdown 化能力。限制包括：web_access_sitemap 会创建计费任务，需先批准报价；web_access_report 有次数与时间限制；npm 包与托管服务器的工具集不同；报告失败后应停止报告。API 密钥需在 usestring.ai 获取。安全漏洞请按 SECURITY.md 私下报告。
