TinyFish

關於

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

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

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

驗證：

• 首次使用時，在瀏覽器中完成 TinyFish OAuth 2.1 流程

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

Claude Desktop

傳輸協定：http

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

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

驗證：

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

TinyFish 建議直接使用代管 URL。

Cursor

傳輸協定：http

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

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

驗證：

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

使用代管端點。

Codex

傳輸協定：http

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

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

驗證：

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

使用代管端點。

Windsurf

傳輸方式：http

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

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

驗證：

• 當提示時，在瀏覽器中完成 TinyFish OAuth 2.1 授權。

託管端點。

VS Code

傳輸方式：http

{
  "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