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

# MCP

> 把 Claude、Codex 或其他 MCP 客戶端連上 Blon。

Blon 提供遠端 MCP server。連接一次後，就能在 AI 客戶端的對話中查詢素材、選擇音色，並生成圖片、影片與聲音。登入走 OAuth，不需要 API 金鑰；生成會使用你 Blon 帳號的點數。

## 連線網址

```text theme={null}
https://blon.ai/api/mcp
```

## 連接客戶端

> [tab] Claude
>
> 1. 開啟 [Settings → Connectors](https://claude.ai/settings/connectors)，新增自訂連接器。
> 2. 貼上連線網址。
> 3. 登入 Blon 並完成授權，回到對話啟用連接器。

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http blon https://blon.ai/api/mcp
> ```
>
> 接著在 Claude Code 輸入 `/mcp`，選擇 `blon` 並依提示登入 Blon。

> [tab] Codex
>
> ```bash theme={null}
> codex mcp add blon --url https://blon.ai/api/mcp
> codex mcp login blon
> ```
>
> 依瀏覽器提示登入 Blon。

> [tab] 其他客戶端
>
> 新增遠端 MCP server，選擇 Streamable HTTP 並貼上連線網址。客戶端須支援遠端 MCP 與 OAuth；依提示登入 Blon。

## 權限與計費

OAuth 連接提供查詢與生成權限。生成使用你登入的 Blon 帳號點數，費用依模型與參數而定；瀏覽、複製提示詞或選擇音色不會啟動生成。

生成工具會回傳 task id，客戶端接著查詢該 task 直到結束；task 執行中不應重複啟動同一個生成。

支援 MCP Apps 的客戶端可在對話中顯示素材畫廊與音色選擇元件；其他客戶端會收到同樣資料的文字版本。


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