> ## 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

> Parse documents with SoMark inside Claude Desktop, VS Code, Cursor, and any MCP-compatible client

[SoMark MCP Server](https://github.com/SoMarkAI/somark_mcp) is the right fit for Claude Desktop, VS Code, Cursor, and other MCP-capable clients that should call SoMark directly through the assistant. If you are still comparing integration paths, start with the [get started overview](/en/documentation/get-started-overview); if your environment is Skill-based instead, switch to [SoMark Skill](/en/documentation/skill).

<Steps>
  <Step title="Get your API key">
    Visit [somark.tech/workbench/apikey](https://somark.tech/workbench/apikey) to get your API key.
  </Step>

  <Step title="Configure your MCP client">
    Add the following to your MCP client's configuration file:

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

    <AccordionGroup>
      <Accordion title="Claude Desktop">
        Config file location:

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

      <Accordion title="VS Code">
        Find the MCP configuration in VS Code settings, or edit `.vscode/mcp.json`.
      </Accordion>

      <Accordion title="Cursor">
        Search for MCP in Cursor settings and add the configuration to the corresponding JSON file.
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Start parsing">
    Once configured, ask your AI assistant directly:

    > "Parse this PDF for me"
    > "Extract the key clauses from this contract"
    > "Convert this image to Markdown"
  </Step>

  <Step title="Check these items first when something fails">
    | Problem                  | Solution                                                                                          |
    | ------------------------ | ------------------------------------------------------------------------------------------------- |
    | "API key not configured" | Check `env.SOMARK_API_KEY` in your MCP config                                                     |
    | Connection issues        | Verify the API key and confirm [somark.tech](https://somark.tech) is reachable                    |
    | File too large           | The current synchronous uploader supports a single file up to 200 MB                              |
    | Unsupported format       | Supports PDF, image, Word, PPT, and Excel files. Confirm the file suffix is in the supported list |
  </Step>
</Steps>