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

# 其他設定方式

> 透過 CLI、Direct Connect、Claude Desktop 或 Cursor 設定 DataGen

<Note>
  **使用 Claude Code 嗎？** 最快的方式是使用 [DataGen Plugin](/zh/developers/plugin-quickstart) -- 它會自動處理身分驗證、MCP 設定，以及 CLI 與 SDK 的安裝。
</Note>

## 方法 1：Direct Connect（Claude Pro/Max）

直接從 Claude 網頁介面連接，不需安裝任何東西。

<Steps>
  <Step title="開啟 Claude 設定">
    * 前往 [claude.ai](https://claude.ai) 並登入
    * 點選你的個人頭像，再點 **Settings**
    * 在側邊欄中前往 **Connectors**
  </Step>

  <Step title="新增 DataGen Connector">
    * 捲動到最下方，點選 **"Add custom connector"**
    * 輸入 MCP 名稱：`DataGen`
    * 輸入 MCP server URL：`https://mcp.datagen.dev/mcp`
    * 點選 **"Add"** 完成連接
  </Step>

  <Step title="開始使用">
    DataGen 工具已可在 Claude 網頁版、行動版與桌面版中使用。
  </Step>
</Steps>

<Note>
  適用於 Pro、Max、Team 與 Enterprise 訂閱者的 Claude 網頁介面、行動 App 與 Claude Desktop。
</Note>

***

## 方法 2：DataGen CLI

適用於 Claude Code、Claude Desktop 與其他 MCP 用戶端。

<Steps>
  <Step title="安裝 CLI">
    ```bash theme={null}
    curl -fsSL https://cli.datagen.dev/install.sh | sh
    ```
  </Step>

  <Step title="登入">
    ```bash theme={null}
    datagen login
    ```

    這會開啟瀏覽器進行 OAuth，並將你的 API key 存入 shell 設定檔。
  </Step>

  <Step title="設定 MCP">
    ```bash theme={null}
    datagen mcp
    ```

    依照提示設定 Claude Code、Claude Desktop 或其他用戶端。
  </Step>
</Steps>

<Note>
  還沒有 API key？請 [在 datagen.dev 註冊](https://datagen.dev) 取得。
</Note>

***

## 方法 3：手動設定（Claude Desktop）

<Steps>
  <Step title="開啟 Claude Desktop 設定">
    * 安裝並啟動 [Claude Desktop](https://claude.ai/download)
    * 點選設定圖示 -> **Developer** -> **Edit Config**
  </Step>

  <Step title="加入設定">
    將以下內容複製貼上到 Claude Desktop 的設定檔中：

    ```json theme={null}
    {
      "mcpServers": {
        "datagen": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://mcp.datagen.dev/mcp"
          ]
        }
      }
    }
    ```
  </Step>

  <Step title="重新啟動">
    關閉並重新開啟 Claude Desktop，以載入新的 MCP 連線。
  </Step>
</Steps>

<Note>
  系統需已安裝 Node.js/npm，才能使用 `npx` 指令。
</Note>

***

## 方法 4：Claude Code CLI

```bash theme={null}
claude mcp add --transport http datagen https://mcp.datagen.dev/mcp
claude mcp list
```

## 方法 5：Cursor IDE

<img src="https://mintcdn.com/datagen/XiQh5_6Ylsll-cnZ/images/claude_mcp.png?fit=max&auto=format&n=XiQh5_6Ylsll-cnZ&q=85&s=a4db8fe2bb0b43343a706eebe68c03a3" alt="Cursor MCP 設定" width="1960" height="1414" data-path="images/claude_mcp.png" />

1. 開啟 Cursor 並前往 MCP 設定
2. **Type** 選擇「Command」
3. 在 **Command** 欄位輸入：
   ```
   npx mcp-remote https://mcp.datagen.dev/mcp
   ```

***

## 驗證連線

在任一 Claude 介面中測試連線：

<Card title="測試連線" icon="play">
  詢問 Claude：**「List all available DataGen tools」**

  你應該會看到 `executeCode`、`searchTools`、`addRemoteMcpServer` 與 `createCustomTool` 等工具。
</Card>

***

## 疑難排解

<AccordionGroup>
  <Accordion icon="exclamation-triangle" title="看不到 DataGen 工具">
    1. 確認你的 JSON 設定格式正確（可用 JSON 驗證工具檢查）
    2. 確認加入設定後已重新啟動 Claude Desktop
    3. 確認終端機中可以使用 `npx`
    4. 再次執行 `datagen mcp` 重新設定
  </Accordion>

  <Accordion icon="wifi-off" title="連線逾時錯誤">
    1. 檢查網路連線
    2. 確認 URL 為：`https://mcp.datagen.dev/mcp`
    3. 若位於企業防火牆後方，請洽詢 IT 團隊開放 MCP 存取
  </Accordion>

  <Accordion icon="key" title="身分驗證問題">
    1. 確認 API key 正確：`datagen login`
    2. 部分工具需要 OAuth 驗證 -- 請使用 `addRemoteMcpServer` 連接外部服務
  </Accordion>

  <Accordion icon="terminal" title="CLI 安裝失敗">
    1. 確認已安裝 curl：`which curl`
    2. 嘗試以 sudo 執行：`sudo sh -c "$(curl -fsSL https://cli.datagen.dev/install.sh)"`
    3. 手動安裝：從 [GitHub releases](https://github.com/datagendev/datagen-cli/releases) 下載
  </Accordion>
</AccordionGroup>

***

## 支援

* **社群**：[Discord](https://discord.gg/6nfr4hh38r)
* **Email**：[support@datagen.dev](mailto:support@datagen.dev)
* **1 對 1 導入協助**：[預約時段](https://cal.com/yusheng/datagen-on-board-1-1)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.