ulink

Ulinkly MCP サーバー

Ulinkly のディープリンクプロジェクトを Claude Code、Cursor、Windsurf などの AI アシスタントに接続します。

Model Context Protocol（MCP）は、LLM が Ulinkly などの外部サービスとやり取りする方法を標準化します。AI アシスタントを Ulinkly アカウントに直接接続し、プロジェクトの管理、スマートリンクの作成、ドメインの設定などのタスクを実行できるようにします。ツールの全一覧をご覧ください。

セットアップ

1. MCP サーバーをインストールする

MCP クライアントを選択し、対応するコマンドを実行します。

Claude Code:

claude mcp add ulink -- npx -y @ulinkly/mcp-server@latest

Cursor:

Settings > MCP > Add new MCP server を開くか、.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "ulink": {
      "command": "npx",
      "args": ["-y", "@ulinkly/mcp-server@latest"]
    }
  }
}

Windsurf:

Settings > MCP > Add new MCP server を開くか、~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "ulink": {
      "command": "npx",
      "args": ["-y", "@ulinkly/mcp-server@latest"]
    }
  }
}

お使いの MCP クライアントが上記にない場合は、クライアントの MCP ドキュメントを確認し、次のサーバーコマンドを使用してください。

npx -y @ulinkly/mcp-server@latest

2. 認証する

MCP サーバーは、Ulinkly CLI と認証情報を共有します。すでに ulink login でログインしている場合、MCP サーバーはそのトークンを自動的に使用するため、追加のログインは必要ありません。

それ以外の場合、初回使用時に MCP クライアントが認証用のブラウザーウィンドウを開きます。トークンは ~/.ulink/config.json に保存され、CLI と共有されます。セッションは維持され、トークンは自動的に更新されます。

API キー（代替方法）

CI 環境やヘッドレスサーバーでは、ULINK_API_KEY 環境変数を設定してブラウザーでの認証を省略できます。

Claude Code:

claude mcp add ulink -e ULINK_API_KEY=your-api-key -- npx -y @ulinkly/mcp-server@latest

手動で設定する場合:

{
  "mcpServers": {
    "ulink": {
      "command": "npx",
      "args": ["-y", "@ulinkly/mcp-server@latest"],
      "env": {
        "ULINK_API_KEY": "your-api-key"
      }
    }
  }
}

Ulinkly ダッシュボードの Project Settings > API Keys から、または create_api_key ツールを使用して API キーを生成できます。

3. 利用を開始する

接続すると、AI アシスタントから Ulinkly プロジェクトを直接管理できます。次のように依頼してみてください。

• 「Ulinkly プロジェクトの一覧を表示して」
• 「アプリ用の新しいスマートリンクを作成して」
• 「最新のリンクのクリック分析を表示して」
• 「プロジェクトにカスタムドメインを追加して」

ツール

以下の Ulinkly ツールを、カテゴリ別に整理して LLM から利用できます。

プロジェクト管理

• list_projects：認証済みユーザーが所有または共有されているすべての Ulinkly プロジェクトを一覧表示します。
• get_project：設定やメンバーシップを含む、特定のプロジェクトの詳細情報を取得します。
• create_project：名前とデフォルトのフォールバック URL を指定して、新しいプロジェクトを作成します。
• update_project：既存のプロジェクトの名前またはデフォルト URL を更新します。
• configure_project：プラットフォーム固有の設定（iOS のバンドル ID、Android のパッケージ名、ディープリンクのスキーマ、SHA-256 フィンガープリント）を設定します。

リンク管理

• create_link：プラットフォーム固有の URL、パラメーター、メタデータを指定して、統合型または動的なスマートリンクを作成します。allowQueryPassthrough をサポートしています（下記参照）。
• list_links：ページネーションを使って、プロジェクト内のすべてのリンクを一覧表示します。
• get_link：特定のリンクの詳細情報を取得します。
• update_link：リンクの URL、パラメーター、またはメタデータを更新します。allowQueryPassthrough をサポートしています（下記参照）。
• delete_link：リンクを完全に削除します。この操作は取り消せません。
• get_link_analytics：リンクのクリック数合計や、プラットフォーム、国、参照元別の内訳など、クリック分析を取得します。

クエリのパススルー

create_link と update_link はどちらも、allowQueryPassthrough ブール値フィールドを受け付けます（デフォルト：false）。有効にすると、クリック時にリンク URL に追加されたクエリパラメーター（例：https://go.example.com/abc?orderId=123&ref=email）が、解決されたリンクのparametersにマージされ、同じキーを持つ保存済みパラメーターは上書きされます。パラメーター値は常に文字列として渡されます。この機能は、アプリをすぐに開く場合にも、インストール後に遅延して開く場合にも利用でき、SDK の変更は不要です。

パススルーパラメーターの検証ルール：キーは[A-Za-z0-9_-]{1,64}に一致する必要があり、パラメーターは最大 25 個まで、各値は 1,024 文字以下、ペイロード全体は 4 KB 以下である必要があります。また、キーdebugは予約されています。

ドメイン管理

• list_domains：プロジェクトに関連付けられたすべてのドメイン（共有ドメインとカスタムドメイン）を一覧表示します。
• add_domain：プロジェクトにカスタムドメインを追加します。DNS の設定と検証が必要です。
• verify_domain：カスタムドメインの DNS 検証を開始します。
• delete_domain：プロジェクトからカスタムドメインを削除します。このドメインを使用するリンクは機能しなくなります。

API キー

• list_api_keys：プロジェクトのすべての API キーを一覧表示します（メタデータのみで、キーの値は含まれません）。
• create_api_key：新しい API キーを作成します。キー全体が返されるのは一度だけなので、安全に保管してください。
• revoke_api_key：API キーを永久に失効させます。このキーを使用するアプリケーションは、直ちにアクセスできなくなります。

アカウントと請求

• get_subscription：プロジェクトのサブスクリプションプラン、ステータス、更新日を取得します。projectIdは任意で指定できます。
• list_plans：利用可能なすべてのサブスクリプションプランを、料金と上限とともに一覧表示します。billingPeriod（月次／年次）は任意で指定できます。
• get_usage：現在の請求期間におけるプロジェクトの利用状況（クリック数、リンク数、API 呼び出し数）を取得します。projectIdは任意で指定できます。

環境変数

変数	デフォルト	説明
ULINK_API_KEY	—	認証用 API キー（ブラウザーの OAuth フローをスキップします）

要件

• Node.js 18 以降

リソース

• Ulinkly のドキュメント：Ulinkly のディープリンクプラットフォームについて詳しく説明しています。
• AI を活用したセットアップ：Ulinkly のセットアップスキルと CLI でこのサーバーを使用します。
• Firebase Dynamic Links からの移行：FDL のリンクとアプリ設定を Ulinkly に移行します。
• Model Context Protocol：MCP とその機能について詳しく説明しています。

ライセンス

MIT