連携

Claude、ChatGPT、n8n向けMCPサーバー

アシスタントがリンクの一覧表示、訪問データの読み取り、計測URLの作成を行えるリモートModel Context Protocolエンドポイント。

Ultimateのワークスペースでは、https://letl.ink/mcpでリモートModel Context Protocolサーバーが公開されます。Claude、ChatGPT、n8nのMCP ClientはStreamable HTTP上のJSON-RPCで通信します。トークンはREST APIと同じAPIトークンです。Free、Solo、Growthのワークスペースは、別の理由ですでにトークンを持っていても/mcpで403を受け取ります。

プロトコルと認証

  • プロトコルバージョン2025-03-26。
  • メソッド:initialize、ping、tools/list、tools/call。resources/listとprompts/listは空のリストを返します。
  • Authorization: Bearer YOUR_TOKENまたはX-API-KEY: YOUR_TOKENで認証します。
  • オーナーと管理者は連携 → MCPでトークンを生成します。再生成するとすべてのMCPクライアントの接続が一度に切断されます。

Claudeを接続

  1. Claudeで設定 → コネクタ → カスタムコネクタを追加を開きます。
  2. URL:https://letl.ink/mcp。
  3. 認証ヘッダー:Authorization: Bearerとトークン。
  4. 接続したら、Claudeにワークスペースの要約、リンクの一覧表示、計測短縮URLの作成を依頼してみましょう。

ChatGPTを接続

  1. ChatGPTで設定 → コネクタ → MCPを開きます。
  2. 同じURLとBearerトークンを使用します。
  3. ChatGPTのワークスペースによっては、カスタムMCPサーバーを表示する前に開発者モードが必要です。コネクタが見つからない場合は、まずその設定を確認してください。

n8nを接続

MCP Clientノード → トランスポート Streamable HTTP → URL https://letl.ink/mcp → ヘッダーAuthorization: Bearer YOUR_TOKEN。詳細とn8nの他の2つの方法はn8nの記事をご覧ください。

ツール

ツール 返す内容/動作
workspace_summary ワークスペース名、プラン、使用リンク数/上限、今月(暦月)のクリック数、ドメイン、QRコード、保存日数、地域機能とAPIが有効かどうか、ボットをブロックが有効かどうか
list_links 有効なリンク(任意のlimit、デフォルト50、最大200)
get_link 数値のidまたはshort_codeで指定した1つのリンク
get_recent_visits 最近記録されたクリック(任意のlimit、デフォルト25、最大100)。国を含む
create_link 計測リンクを作成します。typeはdirect、utm、appstore、instagram、mobile、deviceのいずれかです。スマートタイプはプランに従います。リンク先、UTM、ストアURLはREST APIの作成ボディと同じです
最小限のinitialize(HTTPS + Bearerの後)
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {},
    "clientInfo": { "name": "docs", "version": "1" }
  }
}

モデルに伝えられる内容

initialize時、サーバーはletlinkとして自身を通知し、クライアントに対してこのワークスペースの計測短縮リンク(地域フィールドを含む)を照会・作成するよう指示します。ツールはJSONをテキストコンテンツとstructuredContentの両方で返すため、構造化結果に対応したクライアントは解析を省略できます。

安全性

接続したアシスタントは、APIアクセス権を持つチームメイトとして扱ってください:訪問データの行(一部のペイロードではIPアドレスを含む)を読み取り、上限にカウントされるリンクを作成できます。Bearerトークンをチャットに貼り付けないでください。不要になったクライアントがあれば、コネクタを無効にしてトークンをローテーションしてください。

まだご質問がありますか?

お手伝いします。ご連絡いただければ、できるだけ早くご返信します。