> ## Documentation Index
> Fetch the complete documentation index at: https://docs.somark.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# SoMark MCP

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

[SoMark MCP Server](https://github.com/SoMarkAI/somark_mcp) 适合 Claude Desktop、VS Code、Cursor 这类支持 MCP 的客户端，让 AI 助手直接调用 SoMark 的文档解析能力。如果你还在比较接入方式，先看 [入门总览](/documentation/get-started-overview)；如果你实际用的是 Skill 平台，可以改看 [SoMark Skill](/documentation/skill)。

<Steps>
  <Step title="获取 API Key">
    前往 [somark.tech/workbench/apikey](https://somark.tech/workbench/apikey) 获取你的 API Key。
  </Step>

  <Step title="配置 MCP 客户端">
    将以下配置添加到你的 MCP 客户端配置文件中：

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

    <AccordionGroup>
      <Accordion title="Claude Desktop">
        配置文件路径：

        * macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`
        * Windows：`%APPDATA%\Claude\claude_desktop_config.json`
      </Accordion>

      <Accordion title="VS Code">
        在 VS Code 设置中找到 MCP 配置项，或编辑 `.vscode/mcp.json`。
      </Accordion>

      <Accordion title="Cursor">
        在 Cursor 设置中搜索 MCP，将配置添加至对应的 JSON 配置文件。
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="开始使用">
    配置完成后，直接向 AI 助手发送指令：

    > "帮我解析这个 PDF"
    > "提取合同中的关键条款"
    > "把这张图片里的内容转成 Markdown"
  </Step>

  <Step title="遇到问题先检查这几项">
    | 问题                       | 解决方案                                                     |
    | ------------------------ | -------------------------------------------------------- |
    | "API key not configured" | 检查 MCP 配置中的 `env.SOMARK_API_KEY`                         |
    | 连接失败                     | 确认 API Key 有效，且 [somark.tech](https://somark.tech) 可正常访问 |
    | 文件过大                     | 当前同步上传仅支持不超过 200 MB 的单个文件                                |
    | 不支持的文件格式                 | 支持 PDF、图片、Word、PPT 和 Excel 文件，确认文件后缀在支持列表内               |
  </Step>
</Steps>