filoo-mcp

@filooapp/mcp-server

filoo.app の公式 MCP サーバーです。クリック追跡機能を備えた、AI エージェント向けの URL 短縮サービスです。Claude Desktop、Cursor、その他の Model Context Protocol クライアントに接続すれば、エージェントは 8 つの主要なツールを使って URL の短縮、リンクの管理、スキャン分析の確認を行えます。

「MCP サーバーの URL 短縮サービス」や「Claude の URL 短縮ツール」、「Cursor のリンク短縮ツール」、あるいは AI エージェントに独自の短縮リンク用名前空間を与える方法をお探しなら、これがそのサービスです。

filoo とは

filoo は、人とエージェントの両方に向けた API ファーストの URL 短縮サービスです。各リンクはユーザー名（filoo.app/{username}/{slug}）の配下に作成され、QR コードが付き、国、デバイス、リファラー、流入元ごとのクリック数を追跡します。agents ティアでは、アクティブリンク 50,000 件、1 日あたりの新規リンク 5,000 件、無制限のユーザー名、毎分 1,000 リクエストの API レート制限を利用できます。多数のエージェントがスロットリングを受けずに API を大量に利用できるよう設計されています。

ドキュメントと料金プラン：https://filoo.app/api

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "filoo": {
      "command": "npx",
      "args": ["-y", "@filooapp/mcp-server"],
      "env": {
        "FILOO_API_KEY": "flo_live_xxxxxxxxxxxx"
      }
    }
  }
}

Claude Desktop を再起動します。これでエージェントが filoo の 8 つのツールを利用できるようになります。

Cursor

Cursor の設定 → MCP で、新しいサーバーを追加します。

{
  "filoo": {
    "command": "npx",
    "args": ["-y", "@filooapp/mcp-server"],
    "env": { "FILOO_API_KEY": "flo_live_xxxxxxxxxxxx" }
  }
}

汎用 MCP クライアント（stdio）

FILOO_API_KEY=flo_live_xxxxxxxxxxxx npx -y @filooapp/mcp-server

このプロセスは、MCP 仕様に従って stdio 経由で JSON-RPC を通信します。

ローカルインストール

npm install -g @filooapp/mcp-server
FILOO_API_KEY=flo_live_xxxxxxxxxxxx mcp-server-filoo

設定

環境変数	必須	説明
FILOO_API_KEY	はい	filoo API キーです。flo_live_ で始まります。https://filoo.app/dashboard/api から取得できます（pro、agents、または lifetime ティア）。
FILOO_API_BASE	いいえ	API のベース URL を上書きします。デフォルトは https://filoo.app/api/v1 です。

8 つのツール

各ツールは filoo の REST エンドポイントに 1 対 1 で対応します。以下の説明は、LLM が呼び出すツールを判断する際に読み取る内容です。

filoo_me

認証済みユーザーのアカウント情報（ティア、ユーザー名、ブーストクレジット、上限）を取得します。

プロンプトの例：「自分の filoo のプランと、あと何件リンクを作成できるか教えてください。」

filoo_usage

今日の使用状況と上限を確認します。今日作成したリンク数、今日の API 呼び出し数、アクティブリンク数と上限が含まれます。

プロンプトの例：「filoo の 1 日あたりの上限にどのくらい近づいていますか？」

filoo_list_usernames

所有しているすべてのユーザー名と、プライマリに設定されているものを一覧表示します。

プロンプトの例：「自分の filoo のユーザー名をすべて一覧表示してください。」

filoo_create_link

新しい短縮リンクを作成します。引数：destination（必須）、slug?、username?、label?。

プロンプトの例：「https://example.com/very-long-launch-page を、'agency' ユーザー名の配下に slug 'q4-launch' で短縮してください。」

filoo_list_links

リンクを新しい順に、カーソルページネーションで一覧表示します。引数：limit?（最大 100）、cursor?。

プロンプトの例：「filoo の最近のリンクを 20 件表示してください。」

filoo_get_link

コードで指定したリンクを 1 件取得します。引数：code（形式は username:slug）。

プロンプトの例：「filoo のリンク agency:q4-launch はどこに転送されますか？」

filoo_update_link

短縮 URL を変更せずに、リンクの転送先を変更するか、名前を変更します。引数：code、destination?、label?、active?。

プロンプトの例：「filoo のリンク agency:q4-launch の転送先を、新しいランディングページ https://example.com/launched に変更してください。」

filoo_delete_link

短縮リンクを完全に削除します。引数：code。

プロンプトの例：「filoo のリンク agency:old-promo を削除してください。」

filoo_link_stats

リンクのクリック総数、ユニーク数、ボット数、上位の国と流入元を確認します。引数：code。

プロンプトの例：「filoo のリンク agency:q4-launch のパフォーマンスを教えてください。上位の国と流入元も表示してください。」

API キーの取得

1. https://filoo.app でサインアップします
2. agents ティア（リンク 50,000 件、1 日あたり 5,000 件、1 分あたり 1,000 リクエスト）にアップグレードします。AI エージェントのワークロード向けに特化して設計されています。pro ティアと lifetime ティアでも API を利用できます。
3. https://filoo.app/dashboard/api にアクセスして、キーを作成します。キーは flo_live_ で始まります。
4. FILOO_API_KEY の下にある MCP クライアントの設定に貼り付けます。

API の完全なリファレンス：https://filoo.app/api

開発

git clone https://github.com/filooapp/mcp-server
cd mcp-server
npm install
npm run build
FILOO_API_KEY=flo_live_xxx node dist/index.js

ライセンス

MIT © 2026 filoo