WebFetch 无法使用

[ericheroster]

proma_webfetch_issue.md

[ericheroster]

更新

WebFetch 工具无法使用 - 配置路径问题 + 解决方案

问题描述

在 Proma 平台中，WebFetch 和 WebSearch 工具无法正常工作。

错误信息

WebFetch: "Unable to verify if domain github.com is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai."
WebSearch: "API Error: 400 {"type":"error","message":"invalid params, function name or parameters is empty (2013)"}"

---

✅ 已解决：WebFetch 配置方法

解决方案

在 工作区级别 的 settings.json 中添加 skipWebFetchPreflight: true：

配置文件路径：

C:\Users\Lenovo\.proma\agent-workspaces\workspace-1774420654262\95571cf2-1c73-4c09-9a81-69baad5132dd\.claude\settings.json

修改内容：

{
  "plansDirectory": ".context",
  "skipWebFetchPreflight": true
}

测试结果

URL	状态	返回内容
github.com	✅ 成功	GitHub · Change is constant...
httpbin.org/get	✅ 成功	{"args": {}, "headers": {...}, "origin": "..."}

---

根因分析

WebFetch 问题

Proma 平台使用工作区级别的 Claude 配置，WebFetch 的安全验证 Preflight 检查需要在该级别配置才能生效。全局配置不被读取。

Proma 全局配置 (C:\Users\Lenovo\.proma\settings.json)
    ↓ 不被 Proma 的 WebFetch 逻辑读取
    ↓
工作区配置 (工作区.claude\settings.json)

↓ 被 Proma 的 WebFetch 逻辑读取 ✅

↓

skipWebFetchPreflight: true 生效

WebSearch 问题

WebSearch 返回 invalid params, function name or parameters is empty (2013) 错误，这是一个独立的 API 参数问题，与 WebFetch 的安全验证逻辑不同，可能需要单独排查。

---

环境信息

• 平台：Proma Desktop（Windows 11）
• MCP 配置：MiniMax MCP 已启用
• 网络环境：中国大陆，企业安全策略/防火墙限制
• 涉及配置：C:\Users\Lenovo\.proma\settings.json（全局） vs 工作区 \.claude\settings.json（有效）

---

复现步骤

1. 在 Proma Chat 模式或 Agent 模式下调用 WebFetch 工具
2. 尝试访问任意 URL（如 github.com）
3. 观察返回的安全验证错误

修复步骤

1. 在工作区 \.claude\settings.json 中添加 "skipWebFetchPreflight": true
2. 重新调用 WebFetch 工具
3. 验证是否正常返回内容

---

建议

1. 文档改进：建议 Proma 官方在文档中明确说明 skipWebFetchPreflight 需要配置在工作区级别，而非全局设置
2. 统一配置路径：考虑让全局配置也能生效，减少用户困惑
3. WebSearch 问题：需要单独排查 API 参数错误的原因

---

验证成功的配置文件内容

{
  "plansDirectory": ".context",
  "skipWebFetchPreflight": true
}