mcp-server

aidocx-mcp-server

MCP (Model Context Protocol) server for AiDocX — AI-powered document management platform.

Create, upload, and manage business documents and presentation decks directly from AI assistants like Claude Desktop, Claude Code, and other MCP-compatible clients.

Supported document types: Contracts, Proposals, Quotations, Resumes, Business Plans, Reports, Official Letters, Purchase Orders, Manuals/SOPs, and more.

Presentation decks: Convert any text content into professionally designed slide decks using AI.

Quick Start

1. Get API Keys

Sign up at app.aidocx.ai and go to Settings > API Keys to generate your credentials.

2. Configure Your AI Client

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "aidocx": {
      "command": "npx",
      "args": ["aidocx-mcp-server"],
      "env": {
        "AIDOCX_API_KEY": "ak_xxxxxxxx",
        "AIDOCX_API_SECRET": "your_secret_here"
      }
    }
  }
}

Claude Code

claude mcp add aidocx \
  -e AIDOCX_API_KEY=ak_xxxxxxxx \
  -e AIDOCX_API_SECRET=your_secret_here \
  -- npx aidocx-mcp-server

3. Start Using

Ask your AI assistant:

• "NDA 계약서 작성해줘" (Draft an NDA contract)
• "견적서 만들어줘" (Create a quotation)
• "이력서 작성해줘" (Create a resume)
• "제안서 만들어줘" (Create a proposal)
• "내 문서 목록 보여줘" (Show my documents)
• "이 문서 AI로 분석해줘" (Analyze this document with AI)
• "이 기사로 IR 덱 만들어줘" (Create an IR deck from this article)
• "내 덱 목록 보여줘" (Show my decks)
• "이 덱 제목 바꿔줘" (Rename this deck)

Available Tools

Document Management

| Tool | Description | |------|-------------| | create_document | Create a new document (contract, proposal, quotation, resume, report, etc.) — auto-generates PDF | | upload_document | Upload a PDF or Office file (DOC, DOCX, HWP, XLS, XLSX, PPT, PPTX) | | list_documents | List documents with optional pagination | | get_document | Get document details and extracted text | | delete_document | Delete a document | | search_documents | Search documents with text query, date filters, and pagination | | analyze_document | AI-powered document analysis with risk score and insights |

Folder Management

| Tool | Description | |------|-------------| | list_folders | List folders | | create_folder | Create a new folder | | delete_folder | Delete a folder (optionally with all contents) |

Presentation Decks

| Tool | Description | |------|-------------| | create_deck | Create a presentation deck from text content using AI (dark/light themes, 16:9 slides) | | list_decks | List presentation decks with folder filtering and pagination | | get_deck | Get deck details and full slide design JSON | | edit_deck | Edit deck title, folder, or slide design components | | delete_deck | Delete a deck and all its slide designs |

Document Types

| Type | Examples | |------|----------| | contract | Service agreements, NDAs, employment contracts | | proposal | Project proposals, consulting proposals | | quotation | Price quotes, cost estimates | | plan | Project plans, strategy documents | | business-plan | Investor pitch business plans | | report | Analysis reports, audit reports | | official-letter | Official letters, notices, requests | | resume | Resumes, CVs, cover letters | | purchase-order | Purchase orders, delivery notes | | manual | SOPs, user manuals, guides |

Workflow

Documents

1. AI generates a document -> calls create_document -> PDF is created in AiDocX
2. Open the URL returned by the tool to view, download, or share
3. For contracts: open the signing workspace URL to place signature fields and send to signers

Presentation Decks

1. Provide text content (article, notes, data) -> calls create_deck -> AI generates multi-slide deck
2. Open the editor URL to preview, customize slides, and adjust design
3. Share the deck with viewers or export as needed

Security

• API credentials are transmitted via X-API-Key and X-API-Secret headers over HTTPS only
• Credentials are never logged — the MCP server does not write API keys to stdout, files, or any persistent storage
• Per-key rate limiting is enforced server-side (plan-dependent: 30-600 req/min)
• All inputs are validated with strict schemas — UUID format for IDs, length limits on text fields, bounded pagination
• API keys can be rotated or revoked at any time from Settings > API Keys
• Each key has an optional expiry (7d / 30d / 90d / never) — use short-lived keys for CI/CD or shared environments
• Destructive operations (delete document/deck/folder) require explicit confirmation by the AI assistant

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AIDOCX_API_KEY | Yes | API key (starts with ak_) | | AIDOCX_API_SECRET | Yes | API secret (64-char hex) | | AIDOCX_API_URL | No | API base URL (default: https://api.aidocx.ai) | | AIDOCX_APP_URL | No | App base URL (default: https://app.aidocx.ai) |

Changelog

v0.5.0

• Added 5 presentation deck tools: create_deck, list_decks, get_deck, edit_deck, delete_deck
• Added PUT method support to API client
• Strengthened input validation across all tools (UUID format, length limits, bounded pagination)

v0.4.1

• Tool rename: contract -> document for broader document type support
• Improved error messages with actionable guidance

v0.4.0

• Added search_documents and analyze_document tools
• Added folder management tools

v0.1.0

• Initial release with document CRUD and upload

Links

• AiDocX Website
• AiDocX App
• MCP Protocol