TinyFish

概要

TinyFishは、TinyFish Webエージェント用のMCP統合です。そのホスト型エンドポイントにより、MCP互換のアシスタントがWeb自動化、検索、コンテンツ抽出、実行管理、リモートブラウザセッション機能にアクセスできるようになります。TinyFishはまた、MITライセンスのTypeScriptパッケージ@tiny-fish/mcpを公開しており、これは独自のツールやスキーマを定義するのではなく、ホスト型MCPサービスへのローカルリバースプロキシとして機能します。

主な機能

• run_web_automation および run_web_automation_async による目標ベースのブラウザ自動化、get_run、list_runs、cancel_run による実行の検査とキャンセル。
• search によるWeb検索、および get_search_usage による検索使用量の検査。
• fetch_content によるブラウザレンダリングされたコンテンツの抽出、list_fetch_usage による使用量メタデータの取得。
• create_browser_session、list_browser_sessions、close_browser_session によるリモートChromeセッション。Playwright、Puppeteer、またはSeleniumを使用した直接制御が可能。
• 複数の自動化実行のためのバッチステータスおよびキャンセルツール。
• プロファイル認識型自動化により、保存されたブラウザコンテキストを再利用可能。また、必要に応じてTinyFish Vaultの認証情報を使用して繰り返し認証されるワークフローを実行可能。

ユースケース

TinyFishは、自然言語の目標からウェブサイトをナビゲートしたり、ライブWebコンテンツを抽出したり、最新情報を検索したり、フォームや認証が必要なアプリケーションとやり取りしたり、リモートブラウザセッションを自動化フレームワークに引き渡したりする必要があるエージェントに適しています。非同期実行と実行管理ツールは、呼び出し元のエージェントが処理を開始し、後で完了をポーリングする必要がある長時間のワークフローに便利です。

互換性

主要なサービスは、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セットアップ

前提条件

• アクティブなサブスクリプションまたはホステッドMCPサービス用のクレジットがあるTinyFishアカウント
• 推奨されるホステッドセットアップを使用する場合、リモート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 ローカルプロキシ インストールURL: 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"
    }
  }
}

• ドキュメント化されているTinyFishエントリをCursor MCP設定に追加。

認証:

• プロンプトが表示されたら、ブラウザで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向けにこのローカルプロキシ設定をドキュメント化しています。現在のVS Code固有のホスト型設定は、TinyFish MCP統合ページにはドキュメント化されていません。

Lovable

Lovable向けの正確なパブリックTinyFish MCP設定はドキュメント化されていません。

その他

トランスポート: http

• クライアントのリモートStreamable HTTPサーバー設定を使用して、ホスト型MCPエンドポイントhttps://agent.tinyfish.ai/mcpを設定します 。

認証:

• クライアントがホスト型認証フローをサポートしている場合、TinyFish OAuth 2.1を完了します。

TinyFishのドキュメントでは、このエンドポイントがMCP互換アシスタントから使用可能であること、またGrok、OpenCode、ChatGPTについて個別にドキュメント化されていることが説明されています。正確な設定構文はクライアントによって異なります。

認証フロー

• サポートされているMCPクライアントにhttps://agent.tinyfish.ai/mcpを追加します 。
• 初回使用時に、クライアントはOAuth 2.1認証のためにブラウザを開きます。
• TinyFishアカウントでサインインし、接続を承認します。
• 認証は以降のセッションのためにキャッシュされます。

環境変数

• TINYFISH_API_KEY — オプションのローカルプロキシに必須
• PORT — オプションのローカルプロキシ待受ポート。デフォルトは3711
• TINYFISH_UPSTREAM_URL — オプションのローカルプロキシアップストリーム上書き。デフォルトはhttps://agent.tinyfish.ai/mcp

設定ドキュメント: https://docs.tinyfish.ai/mcp-integration