clypt

Clypt MCP Server

AI アシスタントを Clypt — AI を活用したリンクインテリジェンスプラットフォームに接続する MCP（Model Context Protocol） サーバーです。Claude、ChatGPT、Cursor、または MCP 互換のクライアントから、リンクの短縮、分析データの表示、タグやフォルダーの管理を行えます。

クイックスタート

npx clypt-mcp

Clypt API キーが必要です。clypt.io/dashboard/settings で取得してください。

インストール

Claude Desktop

Claude Desktop の設定（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "clypt": {
      "command": "npx",
      "args": ["-y", "clypt-mcp"],
      "env": {
        "CLYPT_API_KEY": "clypt_your_key_here"
      }
    }
  }
}

Cursor

Cursor の MCP 設定（.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "clypt": {
      "command": "npx",
      "args": ["-y", "clypt-mcp"],
      "env": {
        "CLYPT_API_KEY": "clypt_your_key_here"
      }
    }
  }
}

グローバルインストール

npm install -g clypt-mcp
CLYPT_API_KEY=clypt_your_key_here clypt-mcp

環境変数

変数	必須	デフォルト	説明
CLYPT_API_KEY	はい	-	Clypt API キー
CLYPT_BASE_URL	いいえ	https://clypt.io	カスタム API ベース URL

利用可能なツール

shorten_link

Clypt の短縮リンクを作成します。

• url（必須）— 短縮する URL
• slug — カスタム短縮コード
• tags — 付与するタグ
• expiresAt — 有効期限（ISO 8601）
• password — パスワード保護
• folderId — 整理先のフォルダー

list_links

検索や絞り込みを使って、短縮リンクを一覧表示します。

• search — URL、タイトル、または短縮コードで検索
• tag — タグで絞り込み
• limit — 1 ページあたりの結果数（最大 100）
• offset — ページネーションのオフセット

get_link_analytics

特定のリンクのクリック分析データを取得します。

• linkId（必須）— リンク ID または短縮コード
• period — 期間：7d、30d、90d、または all

get_dashboard_stats

ダッシュボードの概要統計（リンク総数、クリック数、上位の実績）を取得します。パラメーターは不要です。

generate_qr_code

任意の URL の QR コードを生成します。

• url（必須）— エンコードする URL
• size — ピクセル単位のサイズ（100-1000）
• fgColor — 前景色の 16 進カラーコード
• bgColor — 背景色の 16 進カラーコード

manage_tags

タグを作成または一覧表示します。

• action（必須）— create または list
• name — タグ名（作成時）
• color — タグの色の 16 進カラーコード（作成時）

manage_folders

フォルダーを作成または一覧表示します。

• action（必須）— create または list
• name — フォルダー名（作成時）
• parentId — 親フォルダー ID（作成時）

bulk_shorten

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

• urls（必須）— URL の配列
• tags — すべてのリンクに付けるタグ
• folderId — すべてのリンクのフォルダー

delete_link

ID を指定してリンクを削除します。

• linkId（必須）— 削除するリンク ID

create_ab_test

リンクの A/B スプリットテストを作成します（Pro プラン以上）。

• linkId（必須）— テストするリンク ID
• variants（必須）— 2～5 個のバリアントの配列。各バリアントには url、任意の label、および weight を指定します（重みの合計は 100 にする必要があります）

get_ab_test_results

バリアントごとのクリック数、統計的有意性（カイ二乗検定）、勝者の推奨を含む A/B テスト結果を取得します。

• linkId（必須）— リンク ID

end_ab_test

実行中の A/B テストを終了します。リンクは元の URL に戻ります。テストデータは保持されます。

• linkId（必須）— リンク ID

promote_ab_test_winner

勝利したバリアントを唯一の遷移先 URL に設定し、テストを終了します。

• linkId（必須）— リンク ID
• variantId（必須）— 採用するバリアント ID

generate_ai_qr_code

Stable Diffusion + ControlNet を使用して、AI によるアーティスティックな QR コードを生成します（Pro プラン以上）。

• linkId（必須）— 生成対象のリンク ID
• prompt — 希望するアートスタイルを説明するテキストプロンプト
• style — プリセットスタイル：watercolor、oil_painting、cyberpunk、minimal、japanese、nature、abstract、geometric

使用例

設定が完了すると、次のようなことを AI アシスタントに依頼できます。

"https://example.com/my-long-article-url をタグ 'marketing' を付けて短縮してください"

"今月の人気リンクの分析を表示してください"

"clypt.io/abc123 の QR コードを作成してください"

"タグ 'campaign-q1' が付いたリンクをすべて一覧表示してください"

"ニュースレター用に、これら5つの URL を一括で短縮してください"

"ランディングページのリンクで、新しいデザインと古いデザインを 50/50 で比較する A/B テストを設定してください"

"A/B テストの結果を確認してください。勝者は決まりましたか？"

"勝者のバリアントを採用して、テストを終了してください"

開発

git clone https://github.com/Bonsai-Tech-LLC/clypt-mcp.git
cd clypt-mcp
npm install
npm run build
CLYPT_API_KEY=your_key node dist/index.js

ライセンス

MIT — 詳細については LICENSE をご覧ください。

リンク

• Clypt — AI を活用したリンクインテリジェンス
• Clypt API ドキュメント
• MCP プロトコル
• 問題を報告