English Français العربية

CanvasKeep

السجل الرسمي الإنتاجية

Create and edit Excalidraw diagrams in your CanvasKeep workspace, with auto-layout and folders.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package canvaskeep-mcp
Claude Code 
claude mcp add canvaskeep -e 'CANVASKEEP_API_KEY=<your canvaskeep_api_key>' -e 'CANVASKEEP_MASTER_KEY=<your canvaskeep_master_key>' -e 'CANVASKEEP_API_URL=https://canvaskeep.com' -- npx -y canvaskeep-mcp@0.6.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "canvaskeep": {
            "command": "npx",
            "args": [
                "-y",
                "canvaskeep-mcp@0.6.2"
            ],
            "env": {
                "CANVASKEEP_API_KEY": "<your canvaskeep_api_key>",
                "CANVASKEEP_MASTER_KEY": "<your canvaskeep_master_key>",
                "CANVASKEEP_API_URL": "https://canvaskeep.com"
            }
        }
    }
}

متغيرات البيئة

  • CANVASKEEP_API_KEY إلزامي سري API key from your CanvasKeep dashboard (profile menu, API Keys)
  • CANVASKEEP_MASTER_KEY سري Needed to read or edit encrypted diagrams. Copy it from canvaskeep.com/dashboard/encryption
  • CANVASKEEP_API_URL API base URL, override for local development

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. CanvasKeep MCP Server
  2. Setup
  3. Available tools
  4. Encryption
  5. Example usage
  6. Development
  7. License

CanvasKeep MCP Server

An MCP (Model Context Protocol) server that lets AI tools like Claude Code and Codex generate Excalidraw diagrams and save them directly into your CanvasKeep workspace.

Setup

1. Get an API key
  1. Log in to CanvasKeep
  2. Click your profile menu (top right) and select API Keys
  3. Generate a new key and copy it immediately (you won't see it again)
2. Install and register

Claude Code:

claude mcp add canvaskeep \
  -e CANVASKEEP_API_KEY=ck_your_key_here \
  -- npx canvaskeep-mcp

Codex / other MCP clients:

{
  "mcpServers": {
    "canvaskeep": {
      "command": "npx",
      "args": ["canvaskeep-mcp"],
      "env": {
        "CANVASKEEP_API_KEY": "ck_your_key_here"
      }
    }
  }
}
3. Environment variables
VariableRequiredDefaultDescription
CANVASKEEP_API_KEYYes-Your API key from the CanvasKeep dashboard
CANVASKEEP_MASTER_KEYNo-Needed to read or edit encrypted diagrams. Copy it from canvaskeep.com/dashboard/encryption (Key for the MCP server)
CANVASKEEP_API_URLNohttps://canvaskeep.comAPI base URL (override for local dev)

Available tools

ToolDescription
list_workspacesList all your workspaces
create_workspaceCreate a new workspace
list_foldersList folders in a workspace
create_folderCreate a new folder, optionally nested
list_diagramsList diagrams in a workspace
create_diagramCreate a diagram, optionally inside a folder
update_diagramRename a diagram
delete_diagramPermanently delete a diagram
get_diagram_summaryGet diagram metadata and element count
get_diagram_sceneRead the full Excalidraw scene of a diagram
save_diagram_sceneWrite a full Excalidraw scene back to a diagram
generate_diagramGenerate a diagram from nodes and edges with auto-layout

Encryption

Diagrams you encrypt in CanvasKeep stay encrypted when an AI tool works with them. When get_diagram_scene or save_diagram_scene touches an encrypted diagram, this server decrypts and re-encrypts it locally (AES-GCM, see src/encryption.ts) using CANVASKEEP_MASTER_KEY. The master key never leaves your machine.

generate_diagram sends the nodes and edges you give it to CanvasKeep, which lays them out on the server, so diagrams generated this way are stored unencrypted.

Example usage

Ask Claude Code something like:

"Draw an architecture diagram of a web app with a React frontend, Node API, PostgreSQL database, and Redis cache"

Claude will use the MCP tools to create a diagram in your CanvasKeep workspace with properly laid-out boxes and labeled arrows.

Development

git clone https://github.com/CanvasKeep/canvaskeep-mcp.git
cd canvaskeep-mcp
npm install
npm run build
CANVASKEEP_API_KEY=ck_... CANVASKEEP_API_URL=http://localhost:3000 node dist/index.js

To run your local build from Claude Code:

claude mcp add canvaskeep \
  -e CANVASKEEP_API_KEY=ck_your_key_here \
  -- node /path/to/canvaskeep-mcp/dist/index.js

License

MIT

الأسئلة الشائعة

ما هو CanvasKeep؟

Create and edit Excalidraw diagrams in your CanvasKeep workspace, with auto-layout and folders.

كيف أثبّت CanvasKeep؟

يعمل على جهازك. في Claude Code: claude mcp add canvaskeep -e 'CANVASKEEP_API_KEY=<your canvaskeep_api_key>' -e 'CANVASKEEP_MASTER_KEY=<your canvaskeep_master_key>' -e 'CANVASKEEP_API_URL=https://canvaskeep.com' -- npx -y canvaskeep-mcp@0.6.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج CanvasKeep إلى مفتاح API؟

نعم. يتطلب CANVASKEEP_API_KEY, CANVASKEEP_MASTER_KEY، وتضبطها في إعداداته.

هل CanvasKeep مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون CanvasKeep؟

ينشره CanvasKeep. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.