AcornReplyHelp center
All articles

Connect an AI agent to your knowledge base (MCP & API)

AcornReply lets you manage your knowledge base programmatically — from an AI coding agent over MCP, or from your own code over a REST API. It's a fast way to stand up a full help center from existing docs, keep entries in sync with your product, or let an assistant draft and organize articles for you. Set it up under Settings → MCP & API and Settings → API keys (admins only).

Get an API key

Everything authenticates with a workspace API key:

  1. Go to Settings → API keys.
  2. Click Generate key, give it a name (like "Claude" or "Zapier"), and copy the key. It starts with ak_.
  3. Keep it server-side — treat it like a password. You can reveal, copy, or revoke keys any time, and every workspace starts with a default key.

Connect an AI agent over MCP

MCP (Model Context Protocol) lets AI assistants like Claude, Cursor, or Windsurf work with your knowledge base directly.

  • Endpoint: https://mcp.acornreply.com
  • Auth: an Authorization: Bearer ak_YOUR_KEY header

The MCP & API settings page gives you ready-made setup snippets — a one-line command for Claude Code, and a JSON config block for other clients. Once connected, the agent can:

  • search and list your FAQs, articles, and categories,
  • create new FAQs and articles (authored in markdown, converted and sanitized automatically),
  • update, publish/unpublish, and delete entries.

In other words, a connected assistant can read and edit your knowledge base — a genuinely useful way to build and maintain a help center with an AI's help. (This very article was written that way.)

Or use the REST API

Prefer to call it from your own code? The same operations are available over REST at https://acornreply.com/api/v1/…, using the same ak_ Bearer key — for example, GET /api/v1/kb/entries to list entries. Full documentation lives at acornreply.com/developers, with an OpenAPI spec at /api/v1/openapi.json.

What it's good for

  • Bulk-authoring a help center from your existing product docs.
  • Keeping the KB current by syncing entries from your source of truth in code.
  • Letting an assistant help draft, tidy, and categorize entries — you stay in control, since imports and edits are yours to review and publish.

Still need help?