aidocx

aidocx-mcp-server

AiDocX 的 MCP（模型上下文协议）服务 —— AI 驱动的文档管理平台。

通过 Claude Desktop、Claude Code 等 MCP 兼容客户端，直接创建、上传和管理业务文档及演示文稿。

**支持的文档类型：**合同、提案、报价单、简历、商业计划书、报告、公函、采购订单、手册／标准作业程序等。

**演示文稿：**使用 AI 将任意文本内容转换为专业设计的幻灯片。

快速开始

1. 获取 API 密钥

在 app.aidocx.ai 注册，然后前往 Settings > API Keys 生成凭据。

2. 配置 AI 客户端

Claude Desktop

添加到 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. 开始使用

向 AI 助手提出请求：

• "NDA 계약서 작성해줘"（起草一份 NDA 合同）
• "견적서 만들어줘"（创建一份报价单）
• "이력서 작성해줘"（创建一份简历）
• "제안서 만들어줘"（创建一份提案）
• "내 문서 목록 보여줘"（显示我的文档列表）
• "이 문서 AI로 분석해줘"（用 AI 分析这份文档）
• "이 기사로 IR 덱 만들어줘"（根据这篇文章创建一份 IR 演示文稿）
• "내 덱 목록 보여줘"（显示我的演示文稿列表）
• "이 덱 제목 바꿔줘"（重命名这份演示文稿）

可用工具

文档管理

工具	描述
create_document	创建新文档（合同、提案、报价单、简历、报告等）——自动生成 PDF
upload_document	上传 PDF 或 Office 文件（DOC、DOCX、HWP、XLS、XLSX、PPT、PPTX）
list_documents	列出文档，支持可选分页
get_document	获取文档详情和提取的文本
delete_document	删除文档
search_documents	使用文本查询、日期筛选和分页搜索文档
analyze_document	由 AI 驱动的文档分析，提供风险评分和洞察

文件夹管理

工具	描述
list_folders	列出文件夹
create_folder	创建新文件夹
delete_folder	删除文件夹（可选同时删除所有内容）

演示文稿

工具	描述
create_deck	使用 AI 根据文本内容创建演示文稿（深色／浅色主题、16:9 幻灯片）
list_decks	列出演示文稿，支持按文件夹筛选和分页
get_deck	获取演示文稿详情和完整的幻灯片设计 JSON
edit_deck	编辑演示文稿标题、文件夹或幻灯片设计组件
delete_deck	删除演示文稿及其所有幻灯片设计

文档类型

类型	示例
contract	服务协议、NDA、雇佣合同
proposal	项目提案、咨询提案
quotation	价格报价、成本估算
plan	项目计划、战略文件
business-plan	面向投资者的商业计划书
report	分析报告、审计报告
official-letter	公函、通知、请求函
resume	简历、履历、求职信
purchase-order	采购订单、送货单
manual	标准作业程序、用户手册、指南

工作流

文档

1. AI 生成文档 -> 调用 create_document -> 在 AiDocX 中创建 PDF
2. 打开工具返回的 URL 以查看、下载或分享
3. **对于合同：**打开签署工作区 URL，放置签名字段并发送给签署人

演示文稿

1. 提供文本内容（文章、笔记、数据）-> 调用 create_deck -> AI 生成多张幻灯片组成的演示文稿
2. 打开编辑器 URL 以预览、自定义幻灯片并调整设计
3. 分享演示文稿，或根据需要导出

安全

• API 凭据仅通过 HTTPS 经由 X-API-Key 和 X-API-Secret 请求头传输
• 绝不记录凭据——MCP 服务不会将 API 密钥写入标准输出、文件或任何持久化存储
• 服务端会实施按密钥限流（视套餐而定：30-600 req/min）
• 所有输入都经过校验，并采用严格的架构——ID 使用 UUID 格式，文本字段设有长度限制，分页范围受限
• 可随时在 Settings > API Keys 中轮换或撤销 API 密钥
• 每个密钥都可设置有效期（7d / 30d / 90d / never）——CI/CD 或共享环境请使用短期密钥
• 破坏性操作（删除文档/演示文稿/文件夹）需要 AI 助手明确确认

环境变量

变量	必填	说明
AIDOCX_API_KEY	是	API 密钥（以 ak_ 开头）
AIDOCX_API_SECRET	是	API 密钥（64 位十六进制）
AIDOCX_API_URL	否	API 基础 URL（默认：https://api.aidocx.ai）
AIDOCX_APP_URL	否	应用基础 URL（默认：https://app.aidocx.ai）

更新日志

v0.5.0

• 新增 5 个演示文稿工具：create_deck、list_decks、get_deck、edit_deck、delete_deck
• 为 API 客户端新增 PUT 方法支持
• 加强所有工具的输入校验（UUID 格式、长度限制、分页范围限制）

v0.4.1

• 工具重命名：contract 改为 document，以支持更多文档类型
• 改进错误消息，提供可执行的指导

v0.4.0

• 新增 search_documents 和 analyze_document 工具
• 新增文件夹管理工具

v0.1.0

• 首次发布，支持文档 CRUD 和上传

链接

• AiDocX 网站
• AiDocX 应用
• MCP 协议