使用说明
aidocx mcp服务器
MCP(模型上下文协议)服务器 AiDocX --人工智能驱动的文档管理平台。
直接从Claude Desktop、Claude Code和其他MCP兼容客户端等AI助手创建、上传和管理业务文档和演示文稿。
支持的文档类型: 合同、建议书、报价单、简历、商业计划、报告、公函、采购订单、手册/SOP等。
演示甲板: 使用AI将任何文本内容转换为专业设计的幻灯片。
快速开始
1.获取API密钥
注册地址: 应用程序.aidocx.ai 并前往 设置>API密钥 生成您的凭据。
2.配置您的AI客户端
克劳德桌面
添加到您的 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 mcp add aidocx \
-e AIDOCX_API_KEY=ak_xxxxxxxx \
-e AIDOCX_API_SECRET=your_secret_here \
-- npx aidocx-mcp-server
3.开始使用
问你的AI助手:
- “请签订NDA合同”(Draft an NDA contract)
- “制作报价单”(Create a quotion)
- “请填写简历”(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)
可用工具
文档管理
| 工具 | 说明 |
|---|---|
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 |
服务协议、保密协议、雇佣合同 |
proposal |
项目建议书、咨询建议书 |
quotation |
报价、成本估算 |
plan |
项目计划、战略文件 |
business-plan |
投资者推介商业计划 |
report |
分析报告、审计报告 |
official-letter |
正式信函、通知、请求 |
resume |
简历、简历、求职信 |
purchase-order |
采购订单、交货单 |
manual |
SOP、用户手册、指南 |
工作流程
文件
- AI生成文档 ->电话
create_document->PDF是在AiDocX中创建的 - 打开URL 工具返回以查看、下载或共享
- 对于合同: 打开签名工作区URL以放置签名字段并发送给签名者
演示甲板
- 提供文本内容 (文章、笔记、数据)->通话
create_deck->AI生成多幻灯片 - 打开编辑器URL 预览、自定义幻灯片和调整设计
- 分享 带观众的甲板或根据需要导出
安全
- API证书 通过以下方式传输
X-API-Key和X-API-Secret仅限HTTPS上的标头 - 从未记录凭据 -MCP服务器不将API密钥写入stdout、文件或任何持久存储
- 按密钥速率限制 在服务器端强制执行(取决于计划:30-600需求/分钟)
- 所有输入均已验证 具有严格的模式——ID的UUID格式、文本字段的长度限制、有界分页
- API密钥可以旋转或撤销 随时从“设置”>“API密钥”
- 每个密钥都有一个可选的过期时间 (7d/30d/90d/never)--对CI/CD或共享环境使用短期密钥
- 破坏性行动 (删除文档/文件组/文件夹)需要人工智能助理的明确确认
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
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 - 添加
PUT对API客户端的方法支持 - 加强所有工具的输入验证(UUID格式、长度限制、有界分页)
v0.4.1
- 工具重命名:合约->文档,以获得更广泛的文档类型支持
- 通过可操作的指导改进了错误消息
v0.4.0
- 添加
search_documents和analyze_document工具 - 添加文件夹管理工具
v0.1.0
- 首次发布,包含文档CRUD和上传