A failed coding-agent experiment exposed problems in our MCP design

说明与用途

编码代理实验暴露了 FuncHole MCP 接口问题：工具描述不清晰、缺少 shell 命令防护、函数结构示例不足，以及静态/前端函数难以处理。

问题

Designing an interface for coding agents to build, deploy, test, and iterate applications via FuncHole was insufficient, leading to agent failures.

结果

The experiment highlighted that exposing tools to an agent is not enough; the interface must provide clear contracts, examples, constraints, guardrails, and actionable errors to support successful agent operation.

工作流

• 1. Provide an end‑user requirement to the agent via FuncHole.
• 2. Agent attempts to use FuncHole’s MCP tools to build, deploy, test, and iterate the application.
• 3. Agent encounters unclear tool descriptions and falls back to shell commands without guardrails.
• 4. Agent struggles with missing examples of function structure and static/frontend functions.
• 5. Agent eventually deploys a working application, exposing interface shortcomings.

证据

The agent struggled with several parts of our MCP interface: Some tool descriptions weren't clear enough. It tried falling back to shell commands where we lacked proper guardrails. We hadn't provided good examples of the expected Function structure. Static/frontend Functions were particularly difficult to reason about.

来源