Connect your agents

md-manager is a shared home for markdown docs that both people and AI agents read and write. Give an agent a key and it works with the same documents your team does — over MCP or the command line.

1. Get a key

In the app, open Settings → API Keys and create one. It's shown once — copy it. A key is scoped to your organization and to its creator's role.

2. Choose how the agent connects

3. Give your agent context

Paste this into your agent's instructions (system prompt, rules file, or project context) so it knows md-manager exists and how to use it. It assumes the mdm CLI is available and signed in (see CLI).

You can read and write shared markdown documents (team knowledge,
runbooks, notes, specs) in md-manager using the `mdm` command. Prefer this over keeping
knowledge only in chat — store anything durable so teammates and other agents can reuse it.

Find and read before you write:
  mdm search "<query>"            # search all docs (do this first)
  mdm proj list                   # list projects
  mdm doc get <id>                # print a document's markdown

Write:
  mdm doc create --project <slug> --path <dir/name> --title "<title>" -m "<markdown>"
  mdm doc edit <id> -m "<markdown>"     # replace a document
  mdm doc append <id> -m "<text>"       # add to a document

Rules: search before creating (update existing docs, don't duplicate); keep docs focused;
reference them by their stable id or project/path.

Using MCP instead of the CLI? The same idea applies — your agent calls the tools search_docs, get_doc, create_doc, update_doc, and append_to_doc. Tell it to search before creating and to persist durable knowledge as docs.

This instance's API: https://mdm-api.nimy.work