Picoli Mcp

picoli-mcp

picoli.site 用の MCP サーバーです。AI エージェント向けに、URL 短縮とクリック分析を提供します。

AI アシスタントから直接 URL を短縮し、クリックを追跡して、リンクのパフォーマンスを分析できます。

セットアップ

1. API キーを取得する

picoli.site でアカウントを作成し、ダッシュボードから API キーを取得します。

2. MCP クライアントを設定する

Claude Desktop / Claude Code

MCP の設定に追加します。

{
  "mcpServers": {
    "picoli": {
      "command": "npx",
      "args": ["-y", "picoli-mcp"],
      "env": {
        "PICOLI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "picoli": {
      "command": "npx",
      "args": ["-y", "picoli-mcp"],
      "env": {
        "PICOLI_API_KEY": "your-api-key-here"
      }
    }
  }
}

ツール

shorten_url

オプションでカスタムスラッグを指定して、短縮 URL を作成します。

プロンプトの例：

• 「https://example.com/very-long-article-url を短縮して」
• 「スラッグを 'launch' にして https://my-site.com の短縮リンクを作成して」

shorten_urls

複数の短縮 URL を一度に作成します（最大 500 件）。

プロンプトの例：

• 「次の 3 つの URL を短縮して：...」

get_link_stats

特定のリンクのクリック統計を取得します（ボットのトラフィックは除外されます）。

プロンプトの例：

• 「'launch' リンクのクリック数はいくつ？」
• 「次のスラッグの統計を表示して：launch、demo、blog-post」

list_links

クリック数とページネーションを含む、すべての短縮 URL を一覧表示します。

プロンプトの例：

• 「すべての短縮リンクを表示して」
• 「クリック数順にリンクを一覧表示して」

get_analytics

分析の概要を取得します。上位 10 件のリンク、日ごとのクリック傾向、合計が含まれます。

プロンプトの例：

• 「今週のリンク分析を表示して」
• 「最もパフォーマンスの高いリンクは？」
• 「2026-01-01 から 2026-01-31 までのクリック統計を教えて」

環境変数

変数	必須	デフォルト	説明
PICOLI_API_KEY	はい	—	picoli.site の API キー
PICOLI_BASE_URL	いいえ	https://picoli.site	API のベース URL（セルフホストインスタンス用）

開発

git clone https://github.com/yun/picoli-mcp.git
cd picoli-mcp
npm install
npm run build

ローカルでテストします。

PICOLI_API_KEY=your-key npx tsx src/index.ts

ライセンス

MIT