{
  "markdown": "# aidocx-mcp-server\n\nMCP (Model Context Protocol) server for [AiDocX](https://aidocx.ai) — AI-powered document management platform.\n\nCreate, upload, and manage business documents and presentation decks directly from AI assistants like Claude Desktop, Claude Code, and other MCP-compatible clients.\n\n**Supported document types:** Contracts, Proposals, Quotations, Resumes, Business Plans, Reports, Official Letters, Purchase Orders, Manuals/SOPs, and more.\n\n**Presentation decks:** Convert any text content into professionally designed slide decks using AI.\n\n## Quick Start\n\n### 1. Get API Keys\n\nSign up at [app.aidocx.ai](https://app.aidocx.ai) and go to **Settings > API Keys** to generate your credentials.\n\n### 2. Configure Your AI Client\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"aidocx\": {\n      \"command\": \"npx\",\n      \"args\": [\"aidocx-mcp-server\"],\n      \"env\": {\n        \"AIDOCX_API_KEY\": \"ak_xxxxxxxx\",\n        \"AIDOCX_API_SECRET\": \"your_secret_here\"\n      }\n    }\n  }\n}\n```\n\n#### Claude Code\n\n```bash\nclaude mcp add aidocx \\\n  -e AIDOCX_API_KEY=ak_xxxxxxxx \\\n  -e AIDOCX_API_SECRET=your_secret_here \\\n  -- npx aidocx-mcp-server\n```\n\n### 3. Start Using\n\nAsk your AI assistant:\n\n- \"NDA 계약서 작성해줘\" (Draft an NDA contract)\n- \"견적서 만들어줘\" (Create a quotation)\n- \"이력서 작성해줘\" (Create a resume)\n- \"제안서 만들어줘\" (Create a proposal)\n- \"내 문서 목록 보여줘\" (Show my documents)\n- \"이 문서 AI로 분석해줘\" (Analyze this document with AI)\n- \"이 기사로 IR 덱 만들어줘\" (Create an IR deck from this article)\n- \"내 덱 목록 보여줘\" (Show my decks)\n- \"이 덱 제목 바꿔줘\" (Rename this deck)\n\n## Available Tools\n\n### Document Management\n\n| Tool | Description |\n|------|-------------|\n| `create_document` | Create a new document (contract, proposal, quotation, resume, report, etc.) — auto-generates PDF |\n| `upload_document` | Upload a PDF or Office file (DOC, DOCX, HWP, XLS, XLSX, PPT, PPTX) |\n| `list_documents` | List documents with optional pagination |\n| `get_document` | Get document details and extracted text |\n| `delete_document` | Delete a document |\n| `search_documents` | Search documents with text query, date filters, and pagination |\n| `analyze_document` | AI-powered document analysis with risk score and insights |\n\n### Folder Management\n\n| Tool | Description |\n|------|-------------|\n| `list_folders` | List folders |\n| `create_folder` | Create a new folder |\n| `delete_folder` | Delete a folder (optionally with all contents) |\n\n### Presentation Decks\n\n| Tool | Description |\n|------|-------------|\n| `create_deck` | Create a presentation deck from text content using AI (dark/light themes, 16:9 slides) |\n| `list_decks` | List presentation decks with folder filtering and pagination |\n| `get_deck` | Get deck details and full slide design JSON |\n| `edit_deck` | Edit deck title, folder, or slide design components |\n| `delete_deck` | Delete a deck and all its slide designs |\n\n## Document Types\n\n| Type | Examples |\n|------|----------|\n| `contract` | Service agreements, NDAs, employment contracts |\n| `proposal` | Project proposals, consulting proposals |\n| `quotation` | Price quotes, cost estimates |\n| `plan` | Project plans, strategy documents |\n| `business-plan` | Investor pitch business plans |\n| `report` | Analysis reports, audit reports |\n| `official-letter` | Official letters, notices, requests |\n| `resume` | Resumes, CVs, cover letters |\n| `purchase-order` | Purchase orders, delivery notes |\n| `manual` | SOPs, user manuals, guides |\n\n## Workflow\n\n### Documents\n1. **AI generates a document** -> calls `create_document` -> PDF is created in AiDocX\n2. **Open the URL** returned by the tool to view, download, or share\n3. **For contracts:** open the signing workspace URL to place signature fields and send to signers\n\n### Presentation Decks\n1. **Provide text content** (article, notes, data) -> calls `create_deck` -> AI generates multi-slide deck\n2. **Open the editor URL** to preview, customize slides, and adjust design\n3. **Share** the deck with viewers or export as needed\n\n## Security\n\n- **API credentials** are transmitted via `X-API-Key` and `X-API-Secret` headers over HTTPS only\n- **Credentials are never logged** — the MCP server does not write API keys to stdout, files, or any persistent storage\n- **Per-key rate limiting** is enforced server-side (plan-dependent: 30-600 req/min)\n- **All inputs are validated** with strict schemas — UUID format for IDs, length limits on text fields, bounded pagination\n- **API keys can be rotated or revoked** at any time from Settings > API Keys\n- **Each key has an optional expiry** (7d / 30d / 90d / never) — use short-lived keys for CI/CD or shared environments\n- **Destructive operations** (delete document/deck/folder) require explicit confirmation by the AI assistant\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `AIDOCX_API_KEY` | Yes | API key (starts with `ak_`) |\n| `AIDOCX_API_SECRET` | Yes | API secret (64-char hex) |\n| `AIDOCX_API_URL` | No | API base URL (default: `https://api.aidocx.ai`) |\n| `AIDOCX_APP_URL` | No | App base URL (default: `https://app.aidocx.ai`) |\n\n## Changelog\n\n### v0.5.0\n- Added 5 presentation deck tools: `create_deck`, `list_decks`, `get_deck`, `edit_deck`, `delete_deck`\n- Added `PUT` method support to API client\n- Strengthened input validation across all tools (UUID format, length limits, bounded pagination)\n\n### v0.4.1\n- Tool rename: contract -> document for broader document type support\n- Improved error messages with actionable guidance\n\n### v0.4.0\n- Added `search_documents` and `analyze_document` tools\n- Added folder management tools\n\n### v0.1.0\n- Initial release with document CRUD and upload\n\n## Links\n\n- [AiDocX Website](https://aidocx.ai)\n- [AiDocX App](https://app.aidocx.ai)\n- [MCP Protocol](https://modelcontextprotocol.io)\n",
  "bytes": 5827,
  "sha": "a5f59f3e0d4f2c54054fab5abbc1e0f54543f7e2feeca63660fadbc1e77b8330",
  "repo_slug": "aidocx/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_aidocx_mcp_server_4d0df17f/readme"
}