Agent guide

Add Comments with Cursor

Use Cursor to wire the package, the session, and the token route. Read AGENTS.md before inventing tools. Call list_comment_capabilities first.

Connect MCP

1. Open Comments → Keys and use Add to Cursor (OAuth).
2. Sign in and allow workspace access. Scope is comments:mcp.
3. The server id is bootstrapware-comments and the URL is https://comments.bootstrapware.co/mcp.

{
  "mcpServers": {
    "bootstrapware-comments": {
      "type": "http",
      "url": "https://comments.bootstrapware.co/mcp"
    }
  }
}

That JSON is what the keys page installs. The marketplace plugin repository does not list bootstrapware-comments yet. Do not look for Comments tools on the Importer, Feedback, Chat, or Onboard servers. A test secret in Authorization is a fallback. Live and secret keys stay on the dashboard.

Tool order

1. list_comment_capabilities
2. create_comment_app with a name. nextSteps say to update the draft, publish, ensure the test key, then fetch the snippet.
3. update_comment_draft with allowedOrigins for localhost and production. name is optional. Do not send a comment body.
4. publish_comment_app. Its nextSteps name ensure_comment_test_publishable and get_comment_install_snippet.
5. ensure_comment_test_publishable. Paste envLine into .env.local.
6. get_comment_install_snippet. The appId is real. The component uses user, not viewerId.

Then add the server token route from the Next.js guide and pass the real session user. Do not invent user_ada in production. That id is the example persona in examples/comments-nextjs.

Related: AGENTS.md · API overview · API keys