跳转到主要内容
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"
      }
    }
  }
}
配置文件路径：
  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json
在 VS Code 设置中找到 MCP 配置项，或编辑 .vscode/mcp.json。
在 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 文件，确认文件后缀在支持列表内