# TinyFish

TinyFish 為相容 MCP 的 AI 助手提供網頁自動化、網路搜尋、內容擷取以及遠端瀏覽器會話工具。代管的 MCP 伺服器使用 OAuth 2.1，而可選的本地 @tiny-fish/mcp 代理支援 API 金鑰驗證，適用於僅限本地、CI 及無頭設定。

Canonical URL: https://a2a-mcp.org/entry/tinyfish-zh-TW

Language: zh-TW

Category: MCP Servers

Updated: 2026-08-18

## 關於

TinyFish 是針對 TinyFish Web Agent 的 MCP 整合方案。其託管端點能讓相容 MCP 的輔助工具存取網頁自動化、搜尋、內容擷取、執行管理與遠端瀏覽器工作階段功能。TinyFish 亦發佈一款 MIT 授權的 TypeScript 套件 `@tiny-fish/mcp`，此套件僅作為託管 MCP 服務的本地反向代理，而非定義自身工具或架構。

## 主要特色

- 透過 `run_web_automation` 與 `run_web_automation_async` 進行基於目標的瀏覽器自動化，並可透過 `get_run`、`list_runs` 與 `cancel_run` 檢視與取消執行。
- 透過 `search` 進行網頁搜尋，並可經由 `get_search_usage` 檢視搜尋用量。
- 透過 `fetch_content` 擷取瀏覽器渲染的內容，並可透過 `list_fetch_usage` 取得用量中繼資料。
- 透過 `create_browser_session`、`list_browser_sessions` 與 `close_browser_session` 建立遠端 Chrome 工作階段，以便直接使用 Playwright、Puppeteer 或 Selenium 進行控制。
- 批次狀態與取消工具，適用於多個自動化執行。
- 可感知設定檔的自動化功能，能重複使用已儲存的瀏覽器環境，並可選擇性使用 TinyFish Vault 憑證，以處理重複性的已驗證工作流程。

## 使用案例

TinyFish 適用於需要根據自然語言目標瀏覽網站、擷取即時網頁內容、搜尋最新資訊、操作表單與已驗證應用程式，或將遠端瀏覽器工作階段交給自動化框架的輔助工具。非同步執行與執行管理工具特別適合較長的工作流程，此時呼叫的輔助工具可先啟動工作，之後再輪詢完成狀態。

## 相容性

主要服務採用 Streamable HTTP 的託管 MCP 端點。目前的 TinyFish 文件針對 Codex、Grok、Claude Code、OpenCode、Claude Desktop、ChatGPT、Cursor 及 Windsurf 提供用戶端專屬設定，並說明該服務亦可由其他相容 MCP 的輔助工具使用。選用的本地代理會暴露一個回送 HTTP MCP 端點，且儲存庫中記錄了 Claude Code、Claude Desktop、Cursor、VS Code 及一般 URL 型 MCP 用戶端的設定方式。

## 限制

- 託管 MCP 流程需要 TinyFish 帳戶及 OAuth 2.1 授權；TinyFish 文件指出該帳戶必須擁有有效的訂閱或點數。
- 在當前計價模式下，搜尋與內容擷取工具為免費使用，而代理自動化與遠端瀏覽器工作階段則會消耗 TinyFish 點數。
- 本地 `@tiny-fish/mcp` 套件僅為託管服務的代理，因此無法提供 TinyFish 工具的獨立離線實作。
- 本地代理需要 Node.js 22 或更新版本，以及 `TINYFISH_API_KEY`。它僅綁定於回送介面，但任何能連接到其監聽埠的受信任本地程序，皆可使用伺服器持有的金鑰來呼叫自動化功能。
- 根據本地代理文件，託管服務不支援 JSON-RPC 批次陣列。

## 來源

- 官方 MCP 文件：https://docs.tinyfish.ai/mcp-integration
- 驗證機制：https://docs.tinyfish.ai/authentication
- 定價方案：https://www.tinyfish.ai/pricing
- GitHub：https://github.com/tinyfish-io/tinyfish-mcp-server
- npm：https://www.npmjs.com/package/@tiny-fish/mcp

## MCP 設定

### 先決條件

- 擁有 TinyFish 帳戶，且具備啟用中的訂閱方案或點數以使用代管的 MCP 服務
- 一個能連線至遠端 HTTP MCP 伺服器的 MCP 客戶端（建議使用代管設定）
- 僅在使用選用的 @tiny-fish/mcp 本機代理時，需安裝 Node.js >= 22
- 僅在使用選用的 @tiny-fish/mcp 本機代理時，需具備 TinyFish API 金鑰

### 存取需求

- 代管 MCP 驗證使用瀏覽器中的 OAuth 2.1
- 選用的本機代理需在啟動時設定 TINYFISH_API_KEY，並以 X-API-Key 形式向上游傳送
- 在目前 TinyFish 定價模型中，搜尋及擷取功能免費；代理自動化及瀏覽器工作階段則會消耗點數

### 輔助應用程式或外掛

名稱：@tiny-fish/mcp 本機代理
安裝網址：https://www.npmjs.com/package/@tiny-fish/mcp

- 使用指令 npm install -g @tiny-fish/mcp 進行全域安裝
- 或者使用 npx @tiny-fish/mcp 執行，無需安裝
- 在環境變數中設定 TINYFISH_API_KEY
- 啟動 tinyfish-mcp，並將 MCP 客戶端指向 http://127.0.0.1:3711/mcp

此為選用項目。若客戶端支援遠端 Streamable HTTP，儲存庫建議直接使用代管端點。僅在本機客戶端或 CI、無頭機器及腳本中需要使用 API 金鑰驗證時，才使用本機代理。

### 客戶端設定

#### Claude Code

傳輸協定：`http`

```bash
claude mcp add --transport http tinyfish https://agent.tinyfish.ai/mcp
```

- 執行上述 Claude Code 指令以新增代管的 TinyFish MCP 伺服器

驗證：
- 首次使用時，在瀏覽器中完成 TinyFish OAuth 2.1 流程

使用代管端點；無需啟動本機 TinyFish 程序。
#### Claude Desktop

傳輸協定：`http`

```json
{
  "mcpServers": {
    "tinyfish": {
      "url": "https://agent.tinyfish.ai/mcp"
    }
  }
}
```

- 使用 https://agent.tinyfish.ai/mcp 將 TinyFish 新增為自訂連線，或使用文件中基於 URL 的伺服器設定
- 編輯設定後重新啟動 Claude Desktop

驗證：
- 當 Claude Desktop 提示驗證時，在瀏覽器中完成 OAuth 流程

TinyFish 建議直接使用代管 URL。
#### Cursor

傳輸協定：`http`

```json
{
  "mcpServers": {
    "tinyfish": {
      "url": "https://agent.tinyfish.ai/mcp"
    }
  }
}
```

- 在 Cursor MCP 設定中新增上述 TinyFish 項目

驗證：
- 當提示時，在瀏覽器中完成 TinyFish OAuth 2.1 驗證

使用代管端點。
#### Codex

傳輸協定：`http`

```bash
codex mcp add tinyfish --url https://agent.tinyfish.ai/mcp
```

- 執行上述 Codex 指令以新增 TinyFish

驗證：
- 當客戶端要求授權時，完成 TinyFish OAuth 2.1 驗證

使用代管端點。

#### Windsurf

傳輸方式：`http`

```json
{
  "mcpServers": {
    "tinyfish": {
      "serverUrl": "https://agent.tinyfish.ai/mcp"
    }
  }
}
```

- 將文件中的 TinyFish 伺服器條目新增至 Windsurf MCP 設定中。

驗證：
- 當提示時，在瀏覽器中完成 TinyFish OAuth 2.1 授權。

託管端點。
#### VS Code

傳輸方式：`http`

```json
{
  "servers": {
    "tinyfish": {
      "type": "http",
      "url": "http://127.0.0.1:3711/mcp"
    }
  }
}
```

- 啟動選用的 @tiny-fish/mcp 本機代理。
- 使用儲存庫文件中所述的 .vscode/mcp.json 設定，指向 http://127.0.0.1:3711/mcp。

該儲存庫為 VS Code 記錄了這套本機代理設定。目前 TinyFish MCP 整合頁面上並未記錄 VS Code 專用的託管設定。
#### Lovable

Lovable 的精確公共 TinyFish MCP 設定方式尚未記錄。
#### 其他

傳輸方式：`http`

- 使用用戶端的遠端 Streamable HTTP 伺服器設定，配置託管 MCP 端點 https://agent.tinyfish.ai/mcp。

驗證：
- 若用戶端支援託管授權流程，則完成 TinyFish OAuth 2.1 授權。

TinyFish 文件將此端點描述為可從相容 MCP 的助手使用，並另外說明了 Grok、OpenCode 和 ChatGPT 的設定。確切的設定語法因用戶端而異。

### 授權流程

- 將 https://agent.tinyfish.ai/mcp 新增至支援的 MCP 用戶端。
- 首次使用時，用戶端會開啟瀏覽器進行 OAuth 2.1 授權。
- 使用 TinyFish 帳戶登入並授權連線。
- 授權資訊將被快取，以供後續工作階段使用。

### 環境變數

- `TINYFISH_API_KEY — 選用本機代理的必要項目`
- `PORT — 選用本機代理監聽埠；預設值為 3711`
- `TINYFISH_UPSTREAM_URL — 選用本機代理的上游覆寫設定；預設值為 https://agent.tinyfish.ai/mcp`

設定文件：https://docs.tinyfish.ai/mcp-integration

## Tags

- MCP
- 網頁自動化
- 瀏覽器自動化
- 網路搜尋
- 內容擷取
- Streamable HTTP
- OAuth
- TinyFish

## Also known as

- TinyFish MCP
- TinyFish MCP Server
- TinyFish Web Agent MCP
- TinyFish Automation MCP

## Alternatives

- Microsoft Playwright MCP
- Browserbase MCP Server
- Firecrawl MCP Server
- Apify MCP Server
- Bright Data MCP
- AgentQL MCP

## Sources

- [Project website](https://github.com/tinyfish-io/tinyfish-mcp-server)
- [TinyFish MCP Integration](https://docs.tinyfish.ai/mcp-integration)
- [TinyFish Authentication](https://docs.tinyfish.ai/authentication)
- [TinyFish Pricing](https://www.tinyfish.ai/pricing)
- [GitHub repository](https://github.com/tinyfish-io/tinyfish-mcp-server)
- [npm package](https://www.npmjs.com/package/@tiny-fish/mcp)

Last checked: 2026-08-17