Claude DesktopとCursorでElidoを使う

ElidoはMCP（Model Context Protocol）サーバーを https://api.elido.app/mcp で公開しています。接続すると、ClaudeやCursorはリンクのアナリティクスを読み取り、URLを短縮し、リンクの詳細を確認できます — チャットやエディターから直接。

MCPが提供するもの#

• 「spring-2026 は今週何クリック取れましたか？」と聞くと — ClaudeがElidoに問い合わせて実際の数字で答えます。
• 「https://example.com/very-long-path をタグnewsletterで短縮して」と言うと — Claudeがリンクを作成して短縮URLを表示します。
• Cursorでリリースの説明をして「リリースブログ記事の短縮リンクを作成して」と頼むと — インラインで短縮します。

デフォルトは読み取り専用アクセスです。書き込みアクセス（リンクの作成、更新）は認証時にオプトインが必要です。

ステップ1 — Elido APIトークンを生成する#

1. Dashboard → API Keys → New key に移動します。
2. スコープを選択します：
   • 読み取り専用には links:read analytics:read。
   • Claudeがリンクを作成できるようにするには links:write も追加。
3. トークンをコピーします（ek_ で始まります）。

Claude Desktopで接続する#

Claude Desktopは ~/.claude.json（または新しいバージョンではSettings UI）にMCPサーバー設定を保存します。

オプションA — Settings UI（Claude Desktop 0.10+）：

1. Claude Desktop → Settings → Connectors → Add connector → Custom MCP server を開きます。
2. サーバーURLを貼り付けます：https://api.elido.app/mcp
3. Authenticationで Bearer token を選択し、Elido APIトークンを貼り付けます。
4. Connect をクリックします。Claudeがツールマニフェストを取得します（約2秒）し、利用可能なElidoツールが表示されます。

オプションB — 設定ファイルを直接編集：

テキストエディターで ~/.claude.json を開き、mcpServers の下にエントリーを追加します：

{
  "mcpServers": {
    "elido": {
      "url": "https://api.elido.app/mcp",
      "headers": {
        "Authorization": "Bearer ek_your_token_here"
      }
    }
  }
}

ファイルを保存します。Claude Desktopを再起動します。Elidoコネクターがコネクターリストに表示されます。

Cursorで接続する#

1. Cursor → Settings → MCP（または Cmd/Ctrl + , → 「MCP」で検索）を開きます。
2. Add MCP server をクリックします。
3. Server URL：https://api.elido.app/mcp
4. Auth header：Authorization: Bearer ek_your_token_here
5. Save をクリックします。Cursorがマニフェストを取得します。利用可能なツールがMCPパネルに表示されます。

代替手段 — Claude Code CLI（ターミナルユーザー向け）：

claude mcp add elido https://api.elido.app/mcp \
  --header "Authorization: Bearer $ELIDO_TOKEN"

これによりコマンドラインから ~/.claude.json にサーバーが追加されます。ELIDO_TOKEN をシェルプロファイルに設定して、すべてのセッションで利用できるようにします。

利用可能なツール#

ツール	必要なスコープ	機能
list_links	links:read	オプションのフィルター（タグ、ドメイン、検索）でリンクを一覧表示
get_link	links:read	スラグまたはIDで単一のリンクを取得
get_analytics	analytics:read	リンクのクリック数と内訳を取得
create_link	links:write	新しい短縮リンクを作成
update_link	links:write	宛先、スラグ、タグ、有効期限を更新

ツールはデフォルトで読み取り専用です。リンクの作成と更新にはAPIトークンの links:write スコープが必要です。

アクセスの範囲#

MCPサーバーはAPIトークンが属するワークスペースのデータのみを公開します。他のワークスペースにはアクセスできません。複数のワークスペースがある場合は、それぞれ別のトークンを作成し、異なる名前（elido-workspace-a、elido-workspace-b）で複数のMCPサーバーエントリーを追加してください。

トラブルシューティング#

「Failed to fetch tool manifest」 — MCPサーバーURLが間違っているかアクセス不能です。ブラウザで https://api.elido.app/mcp を開いて確認してください — JSONマニフェストが返るはずです。証明書エラーが出る場合、ネットワークが api.elido.app へのTLSをブロックしている可能性があります。

ツール呼び出し時に「Unauthorized」 — AuthorizationヘッダーにAPIトークンがないか、間違っています。形式が正確に Authorization: Bearer ek_...（余分なスペースなし、正しいプレフィックス）であることを確認してください。

ツールは表示されるが書き込みツールが「forbidden」を返す — APIトークンに links:write がありません。そのスコープで新しいトークンを生成し、MCP設定のヘッダーを更新してください。

設定を編集後、Claude DesktopにElidoがコネクターとして表示されない — Claude Desktopを完全に再起動してください（ウィンドウを閉じるだけでなくQuit）。macOSでは、メニューバーで実行中のClaudeインスタンスを確認してください。

CursorのMCPパネルが「disconnected」を表示する — Cursorはセッションごとにマニフェストを再取得します。api.elido.app の応答が遅い場合、Cursorがタイムアウトする可能性があります。MCPパネルで Reconnect をクリックしてみてください。問題が続く場合はElidoのステータスページを確認してください。