Connect Claude

To connect Claude to md-doc, add a remote MCP server with the URL https://app.md-doc.com/api/mcp and your MCP-type API key. Claude can then search, read and write your notes, logs and issues, and what it does in one session is available in the next.

You need a key first: Getting started.

Claude Code

claude mcp add --transport http md-doc https://app.md-doc.com/api/mcp \
  --header "Authorization: Bearer mcp_YOUR_KEY"

Check that it appears with claude mcp list.

Claude (web and desktop)

In Settings → Connectors add a custom connector with the server URL. Since this flow does not allow headers, include the key in the URL:

https://app.md-doc.com/api/mcp?key=mcp_YOUR_KEY

See the note on keys in URLs in Connect your AI.

How to work with it

The MCP server already includes instructions for the model (notes versus logs, issue rules, secret handling), so you do not have to write them. Some useful requests:

• “Check md-doc for open issues and tell me which one to start with.”
• “Document in a note how what we just set up works, and record the change in the log.”
• “Pick up where we left off yesterday: read the latest lines of the project log.”

If Claude has a terminal, it can use your keys with the mddoc CLI without seeing them.