MCP Client Tool doesn’t work with gemini models

问题场景

用户在 n8n 中搭建 AI Agent 工作流，将 MCP Client Tool 连接到自托管 MCP 服务器（例如 google_workspace_mcp、crawl4ai），底层聊天模型选择 Gemini 系列（palm / Vertex / Gemini 2.5 Pro / Gemini 2.5 Flash）。执行工作流时，模型节点调用失败，工作流在 Model 环节报错；把模型换成 GPT-4o 或 Claude 3.5 后同一条工作流可正常完成，包括 MCP 工具调用。

报错原文

MCP Client Tool doesn't work with gemini models

Invalid JSON payload received. Unknown name "type" at 'tools[0].function_declarations[0].parameters.properties[2].value': Proto field is not repeating, cannot start list.

Vertex 侧还出现如下子节点报错：

Error in sub-node 'Google Vertex Chat Model'
Invalid JSON payload received. Unknown name "type" at 'tools[0].function_declarations[0].parameters.properties[2].value': Proto field is not repeating, cannot start list.

原因分析

可能原因：MCP 服务器通过 MCP Client Tool 暴露的工具参数 schema 中，存在 Gemini 接口不接受的结构（报错指向 parameters.properties[*].value 中的 type 字段，提示该 Proto 字段不可重复、不能以列表形式传入）。也就是说，问题更可能出在“Gemini 如何解释 MCP 工具 schema”这一层，而不是 MCP Client Tool 本身完全不可用——因为同一 MCP 服务器搭配 GPT-4o / Claude 3.5 正常。Issue 中维护者推测 MCP 服务器可能返回了不符合预期格式的内容，但缺少可复现样例确认。另有用户反馈 Gemini 2.5 Pro 同样报错，说明并非单一 Gemini 版本问题。

环境排查

• 确认 n8n 版本：Issue 中 1.91.3、1.94.0 均有问题；1.100 被维护者称为修复版本，但 1.100.1 用户复测仍失败。
• 确认底层模型：是 Gemini Chat Model、Vertex Chat Model 还是其他 Gemini 路由；Issue 中 Gemini 2.5 Pro、Gemini 2.5 Flash 均复现。
• 确认 MCP 服务器：Issue 中 google_workspace_mcp 与自托管 crawl4ai 均复现，建议核对各自返回的 tools schema。
• 确认是否使用 litellm 代理层：报错文本中出现 litellm.BadRequestError: VertexAIException，需留意代理层对 schema 的转换。
• 对比验证：同一工作流换成 GPT-4o 或 Claude 3.5 是否正常，用于判断问题是否限定在 Gemini 解析侧。
• Issue 未提供操作系统、Python、PyTorch、CUDA、显卡信息，无需据此排查。

解决步骤

1. 先保留一条原工作流作为对照，将其中的 Gemini 模型替换为 GPT-4o 或 Claude 3.5，确认 MCP 服务器和工具连通性正常（Issue 中报告者已验证该对比成立）。
2. 检查出问题的 MCP 服务器返回的工具定义，重点看 tools[].function_declarations[].parameters.properties 里各字段的 type 写法，报错定位的正是 properties[N].value 中的 type 被当作列表/重复结构发送。
3. 把 n8n 升级到 1.100 或更高版本（可优先尝试）：维护者称该问题应已在 1.100 修复；升级后按下方验证方法复测。
4. 若仍失败，按 Issue 中维护者的请求准备可复现材料：导出工作流 JSON（Issue 中报告者提供了 Personal_AI_Assistant_Test.json）并注明所使用的 MCP 服务器，以便定位是哪一段 schema 触发 Gemini 400。
5. 在根因确认前，生产流程可临时切换到 GPT-4o 或 Claude 3.5 继续运行，避免 Gemini 节点持续报错。

验证方法

用同一个工作流、同一个 MCP 服务器，将 Gemini 节点重新执行一次：若不再出现 Invalid JSON payload received. Unknown name "type" 且 MCP 工具能被正常调用，说明问题已解决。若仍报错，记录 n8n 版本与模型版本，并对照 Issue 中已有反馈（1.100.1 复测失败），说明该组合下修复尚未覆盖，需要继续上报复现信息。

参考来源

n8n-io/n8n #15553

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。