Skip to content

Took me 30m to on board, two issues resolved in runtime #173

@tzvister

Description

@tzvister
  1. 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'"
  1. 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."

  1. 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions