- The endpoint prop should auto-detect or be documented prominently
// This doesn't sync to MCP — but nothing tells you that
// This works — but we had to dig through node_modules to find it
The component should either:
- Default endpoint to http://localhost:4747 when no prop is given (since that's the default server port)
- Or print a console warning like: "Agentation: no endpoint configured — annotations won't sync to agents. Add endpoint='http://localhost:4747'"
- The agentation-mcp init wizard needs a "server" arg in the config it generates
We had to manually fix the Claude Code MCP config from:
{ "command": "npx", "args": ["-y", "agentation-mcp"] }
to:
{ "command": "npx", "args": ["-y", "agentation-mcp", "server"] }
Without "server", the command just prints help text and Claude Code reports "Failed to reconnect."
- The setup skill should add the endpoint prop automatically
The /agentation skill adds without the endpoint prop, so even after a perfect MCP setup, nothing syncs.
TL;DR: Two missing defaults made it take 30 minutes to debug: the endpoint prop on the component, and the server subcommand in the MCP config.
// This doesn't sync to MCP — but nothing tells you that
// This works — but we had to dig through node_modules to find it
The component should either:
We had to manually fix the Claude Code MCP config from:
{ "command": "npx", "args": ["-y", "agentation-mcp"] }
to:
{ "command": "npx", "args": ["-y", "agentation-mcp", "server"] }
Without "server", the command just prints help text and Claude Code reports "Failed to reconnect."
The /agentation skill adds without the endpoint prop, so even after a perfect MCP setup, nothing syncs.
TL;DR: Two missing defaults made it take 30 minutes to debug: the endpoint prop on the component, and the server subcommand in the MCP config.