Limelink Mcp Server

@limelink/mcp

한국어 · ドキュメント · 機能リファレンス

LimeLink のダイナミックリンク管理を行う Model Context Protocol（MCP） サーバーです。Claude Code、Claude Desktop、または MCP 互換クライアントから直接、ダイナミックリンクの作成、検索、管理ができます。

すぐに使い始める場合、API キーは不要です！ ドキュメントと SDK のセットアップガイドは、設定なしで利用できます。接続するだけで、AI アシスタントを使って LimeLink の機能を試せます。

機能

• ドキュメントリソース — AI アシスタントから LimeLink のドキュメント（15 ページ＋インデックス）に直接アクセスできます — API キーは不要です
• 5 つのツール — プロファイルと Projects の確認、ダイナミックリンクの作成、リンクの検索ができます（API ツールには設定済みのプロファイルが必要です）
• インメモリキャッシュ — ドキュメント取得用の有効期間 1 時間のキャッシュ

実行環境

• Node.js 18 以降
• stdio トランスポートのみ対応。リモート MCP／HTTP トランスポートには対応していません
• npm パッケージ：@limelink/mcp、グローバル実行ファイル：limelink-mcp
• stdout は MCP プロトコル用に予約されています。診断情報とラッパーのログは stderr に出力する必要があります

運用上の仕様については、インストールと設定およびネットワーク動作をご覧ください。

API キーなしで利用できる機能

機能	カテゴリ	API キー	説明
limelink://docs/index	リソース	不要	ドキュメントの完全なインデックス
limelink://docs/{slug}	リソース	不要	個別のドキュメントページ 15 件
list-profiles	ツール	不要	API に接続せず、ローカルで設定されたプロファイルのエイリアスを一覧表示
list-projects	ツール	必須	選択した Organization プロファイルの Projects を一覧表示
list-custom-domains	ツール	必須	選択した Project の Custom Domains を一覧表示
create-link	ツール	必須	API 経由で V2 Core Links を作成
get-link-by-suffix	ツール	必須	サフィックスでリンクを検索
get-link-by-url	ツール	必須	URL でリンクを検索

クイックスタート

API キーなしで利用（ドキュメントとガイド）

API キーは不要です。接続すれば、すぐに LimeLink のドキュメントとセットアップガイドを確認できます。

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"]
    }
  }
}

AI アシスタントに次のように尋ねてみましょう。

• 「LimeLink の入門ドキュメントを読んで」
• 「iOS のディープリンクを設定する方法を教えて」
• 「LimeLink SDK の統合ガイドを見せて」

Organization プロファイルを使用（すべての機能）

以下に示すバージョン 1 のプロファイルファイルを作成し、その絶対パスを渡します。

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"],
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

グローバルインストールでの使用方法

npm install -g @limelink/mcp

{
  "mcpServers": {
    "limelink": {
      "command": "limelink-mcp",
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

設定

Claude Code

MCP サーバーを追加する最も簡単な方法は、claude mcp add コマンドを使用することです。

# Without API key (docs & guides only)
claude mcp add --scope user --transport stdio limelink -- npx -y @limelink/mcp

# With API key (full features)
claude mcp add --scope user --transport stdio limelink \
  --env LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json \
  -- npx -y @limelink/mcp

スコープのオプション：

• --scope user — すべてのプロジェクトで利用できます
• --scope project — .mcp.json に保存されます（Git 経由でチームと共有できます）

Claude Desktop およびその他の MCP クライアント

クライアントの設定ファイルに JSON 設定を追加します。

クライアント	設定ファイル
Claude Desktop（macOS）	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop（Windows）	%APPDATA%\Claude\claude_desktop_config.json

プロファイルファイル

{"version":1,"defaultProfile":"work","profiles":{"work":{"apiKey":"your_api_key","organizationLabel":"Work","projects":{"marketing":"11111111-1111-4111-8111-111111111111"}}}}

環境変数

変数	必須	デフォルト	説明
LIMELINK_PROFILES_FILE	いいえ	—	名前付き Organization 認証情報プロファイルを含む、バージョン 1 の JSON ファイルへのパスです。

LIMELINK_API_KEY と LIMELINK_PROJECT_ID は無視されます。認証情報プロファイルが設定されていない場合、API を利用するツールは、Organization API キーを発行してプロファイルファイルを設定するよう、エージェントに Organizations を案内します。Project を利用するツールには、Project UUID を直接指定できます。プロファイルの省略可能な projects マップは、繰り返し使用する Project のための便利な推奨機能であり、必須ではありません。必要に応じて、list-projects で確認した後にエイリアスを追加してください。プロファイルは、API を利用する最初の呼び出し時に認証情報のイントロスペクションを通じて遅延初期化されます。エイリアスの追加など、プロファイルファイルを変更した場合は、MCP サーバーを再起動する必要があります。

API キーは LimeLink Dashboard から取得できます。API キーがなくても、ドキュメントリソースと SDK セットアップガイドはすべて利用できます。

ツール

list-profiles

API に接続せずに、設定済みのエイリアス、Organization のラベル、デフォルトの状態、現在の初期化状態を一覧表示します。初期化済みのプロファイルにはスコープも含まれます。API キーの値は機密情報として扱われ、返されることはありません。Organization、Project、Custom Domain、認証情報の識別子とキーのプレフィックスは機密情報ではない識別子であり、必要に応じて API を利用するツールの応答に含まれることがあります。

list-projects

選択したプロファイルの認証情報から検出された Organization 内の Project を一覧表示します。省略可能な profile を指定できます。認証情報には projects:read が必要です。

list-custom-domains

必須の project（エイリアスまたは UUID）に対応する Custom Domain を一覧表示します。省略可能な profile を指定できます。認証情報には domains:read が必要です。

create-link

プラットフォーム固有のディープリンク、Custom Domain の選択、ソーシャルプレビュー、UTM トラッキングに対応する V2 Core Link を作成します。

パラメーター：

パラメーター	型	必須	説明
dynamic_link_suffix	string	いいえ	短い URL パス識別子（1～100）。省略時は API が生成します
dynamic_link_url	string	はい	リンク先 URL（最大 500）
dynamic_link_name	string	はい	リンク名（最大 100）
project	string	はい	選択したプロファイル内の Project エイリアス、または Project UUID
profile	string	いいえ	プロファイルのエイリアス。指定しない場合は、設定済みのデフォルトまたは唯一のプロファイルを使用します
custom_domain_id	UUID string	いいえ	Core Link に使用する Custom Domain
stats_flag	boolean	いいえ	分析トラッキングを有効にします
apple_options	object	いいえ	iOS ディープリンクのオプション
android_options	object	いいえ	Android ディープリンクのオプション
additional_options	object	いいえ	ソーシャルプレビューと UTM のオプション

Claude での使用例：

「https://example.com/product/123 のダイナミックリンクを、サフィックス 'product-123' で作成し、分析を有効にしてください」

get-link-by-suffix

サフィックスを指定してダイナミックリンクを検索します。

パラメーター	型	必須	説明
suffix	string	はい	ダイナミックリンクのサフィックス
project	string	はい	選択したプロファイル内の Project エイリアス、または Project UUID
profile	string	いいえ	プロファイルのエイリアス。指定しない場合は、設定済みのデフォルトまたは唯一のプロファイルを使用します

get-link-by-url

URL 全体を使用して、V2 API 経由で Link を解決します。バックエンドが、その URL が Free のデフォルト名前空間、Project のホスト名、または有効な Custom Domain のいずれに属するかを判定します。Project の選択やローカルでのサフィックス解析は不要です。

URL は絶対 HTTPS URL である必要があります。また、パスセグメント /{suffix} を 1 つだけ含み、クエリ、フラグメント、明示的なポート、認証情報を含めることはできません。

パラメーター	型	必須	説明
url	string	はい	解決する LimeLink URL 全体（最大 2048 文字）
profile	string	いいえ	プロファイルのエイリアス。指定しない場合は、設定済みのデフォルトまたは唯一のプロファイルを使用します

リソース

limelink://docs/index

LimeLink のドキュメントインデックス全体（llms.txt）を返します。

limelink://docs/{slug}

個々のドキュメントページを返します。利用可能なスラッグは次のとおりです。

introduction、getting-started、project、application、dynamic-link、create-link、link-detail、link-management、appearance、sdk-integration、ios-sdk、android-sdk、api-integration、advanced、llm-agent

Claude での使用例：

「LimeLink API の統合ドキュメントを読んでください」

Claude は limelink://docs/api-integration にアクセスします。

開発

前提条件

• Node.js >= 18
• pnpm

セットアップ

git clone https://github.com/hellovelop/limelink-mcp-server.git
cd limelink-mcp-server
pnpm install
pnpm run build

ローカルでの実行

LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json node dist/index.js

テスト

pnpm test          # Unit tests
pnpm test:e2e      # E2E tests (MCP stdio communication)
pnpm test:watch    # Unit tests in watch mode
pnpm test:coverage # Coverage report

プロジェクト構成

src/
├── index.ts              # Entry point
├── lib/
│   ├── config.ts         # Environment variable loading
│   ├── cache.ts          # In-memory TTL cache
│   ├── api-client.ts     # LimeLink API HTTP client
│   └── doc-fetcher.ts    # Documentation fetcher with caching
├── tools/
│   ├── create-link.ts    # create-link tool
│   ├── get-link-by-suffix.ts
│   └── get-link-by-url.ts
└── resources/
    └── documentation.ts  # Documentation resources

ライセンス

MIT