@latellu/atlas-mcp 1.0.6 → 1.0.7

package/README.md

@@ -5,6 +5,8 @@
 
 MCP (Model Context Protocol) server for Atlas CMS — enables AI agents to manage content.
 
+**Docs & dashboard:** concepts and API reference live at **[docs.atlas.latellu.com](https://docs.atlas.latellu.com)**; the app where you create workspaces, content, and API keys is **[cms.atlas.latellu.com](https://cms.atlas.latellu.com)**.
+
 ## Overview
 
 This MCP server exposes Atlas CMS content management operations as tools for AI agents (Claude, Cursor, etc.). It enables AI agents to:
@@ -14,6 +16,19 @@ This MCP server exposes Atlas CMS content management operations as tools for AI
 - Create, update, publish, and delete content
 - Upload media files from local filesystem
 
+Building a custom app instead of wiring up an AI agent? Use the [`@latellu/atlas-sdk`](https://www.npmjs.com/package/@latellu/atlas-sdk) TypeScript SDK — this server only exposes tools for MCP clients (Claude Desktop, Cursor, etc.), it isn't a general-purpose HTTP client.
+
+## Core Concepts
+
+New to Atlas? A **workspace** is your tenant — it owns all content types, entries, pages, media, and API keys, isolated from other workspaces. Within a workspace:
+
+- **[Content type](https://docs.atlas.latellu.com/docs/content-types)** — a schema (e.g. "Article") defining the fields an entry can have.
+- **[Entry](https://docs.atlas.latellu.com/docs/entries)** — a record of a content type, with a **draft → published → archived** lifecycle.
+- **[Page](https://docs.atlas.latellu.com/docs/pages)** — like an entry, but composed of ordered **blocks** and carries its own SEO metadata.
+- **[Locale](https://docs.atlas.latellu.com/docs/localization)** — a language variant; localized fields fall back to the workspace's default locale when untranslated.
+
+See the [Getting Started guide](https://docs.atlas.latellu.com/docs/getting-started) for the full picture.
+
 ## Features
 
 ### Schema & Discovery
@@ -63,10 +78,9 @@ atlas-mcp
 
 ### Getting an API Key
 
-1. Open the Atlas dashboard: **https://cms.atlas.latellu.com**
-2. Go to **Settings → API Keys**
-3. Click **Create API Key**, give it a name, and save
-4. Copy the key — it is only shown once
+1. Open **[cms.atlas.latellu.com/dashboard/api-keys](https://cms.atlas.latellu.com/dashboard/api-keys)** (sidebar: **Developer → API Keys**)
+2. Click **Create API Key**, give it a name, pick its scopes, and save
+3. Copy the key — it is only shown once
 
 **Key types:**
 - `atlas_live_*` — Delivery API key. Required for every **read** tool (`get_workspace_schema`, `list_*`, `get_*`).
@@ -74,6 +88,8 @@ atlas-mcp
 
 The backend enforces one key type per route group — a management key cannot read `/api/v1/public/*`, and a delivery key cannot write to `/api/v1/manage/*`. **For the full tool set (read + write), configure both keys.** A single key only unlocks the half of the tools matching its type; calling a tool that needs the other key type returns a clear error naming the missing env var.
 
+See [docs.atlas.latellu.com/docs/authentication](https://docs.atlas.latellu.com/docs/authentication) for how scopes work and the full authentication reference.
+
 ### Environment Variables
 
 | Variable | Required | Description |
@@ -183,7 +199,7 @@ AI: → Calls upload_media with file_path='/Users/you/Pictures/tokyo.png'
 
 ### Best Practices
 
-1. **Scope API keys**: For management keys, grant only the scopes each tool needs — `content:write` for create/update/delete/reorder, `content:publish` for publish/unpublish/archive/schedule, `media:write` for uploads/deletes. Leave unused scopes off.
+1. **Scope API keys**: For management keys, grant only the scopes each tool needs — `content:write` for create/update/delete/reorder, `content:publish` for publish/unpublish/archive/schedule, `media:write` for uploads/deletes. Leave unused scopes off. Scopes are picked when you create the key at [Developer → API Keys](https://cms.atlas.latellu.com/dashboard/api-keys); see the [scope reference](https://docs.atlas.latellu.com/docs/authentication) for the full list.
 2. **Restrict upload paths**: Only allow necessary directories
 3. **Rotate keys**: Regularly rotate API keys
 4. **Monitor usage**: Review MCP tool calls for suspicious activity

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@latellu/atlas-mcp",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "publishConfig": {
     "access": "public"
   },