SoMark MCP

在 Claude Desktop、VS Code、Cursor 等支持 MCP 的客户端中，使用 SoMark MCP Server 解析文档

SoMark MCP Server 适合 Claude Desktop、VS Code、Cursor 这类支持 MCP 的客户端，让 AI 助手直接调用 SoMark 的文档解析能力。如果你还在比较接入方式，先看 入门总览；如果你实际用的是 Skill 平台，可以改看 SoMark Skill。

1. 获取 API Key

   前往 somark.tech/workbench/apikey 获取你的 API Key。

2. 配置 MCP 客户端

   将以下配置添加到你的 MCP 客户端配置文件中：

   {
     "mcpServers": {
       "somark": {
         "command": "npx",
         "args": ["-y", "somark-mcp"],
         "env": {
           "SOMARK_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

   Claude Desktop

   配置文件路径：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

   VS Code

   在 VS Code 设置中找到 MCP 配置项，或编辑 .vscode/mcp.json。

   Cursor

   在 Cursor 设置中搜索 MCP，将配置添加至对应的 JSON 配置文件。

3. 开始使用

   配置完成后，直接向 AI 助手发送指令：

   “帮我解析这个 PDF” “提取合同中的关键条款” “把这张图片里的内容转成 Markdown”

4. 遇到问题先检查这几项

   问题	解决方案
   ”API key not configured”	检查 MCP 配置中的 env.SOMARK_API_KEY
   连接失败	确认 API Key 有效，且 somark.tech 可正常访问
   文件过大	当前同步上传仅支持不超过 200 MB 的单个文件
   不支持的文件格式	支持 PDF、图片、Word、PPT 和 Excel 文件，确认文件后缀在支持列表内