Getting started

To get started with md-doc, create a free account, generate an MCP-type API key in Settings → API keys and paste it into the AI client you use. Your AI can then read and write your notes, logs and issues.

1. Create your account

Sign up at app.md-doc.com with your email and verify it. Every account includes 1 GB of storage at no cost.

2. Generate an API key

In Settings → API keys create a key. There are two types and they are not interchangeable:

Type	What it is for	What it can touch
MCP	Connecting AI clients to the MCP server	Notes, logs, issues and records
CLI (Environments)	Connecting the mddoc CLI	Environments only

So a leaked MCP key cannot be used to get secrets, and a CLI key cannot open your notes. The key is shown only once when you create it: save it.

3. Connect your AI

The MCP server address is:

https://app.md-doc.com/api/mcp

Pick your client:

• Claude
• ChatGPT
• Local models with Ollama and Goose

4. Try it

Ask your AI something like: “Search md-doc for my notes on deployment and summarize them.” If it answers with your notes, the connection works.

Next

• Learn when to use notes, logs and issues.
• To let an AI use keys without seeing them, set up Environments.