Claude DesktopとCursorでElidoを使う

Elido の Model Context Protocol(MCP)サーバーはローカルプログラムとして提供されます。お使いのマシン上で動作し、API キーで Elido の REST API を呼び出し、stdio でクライアントと通信します。ホスト型の MCP URL や OAuth コネクタはなく、Claude の Connectors 画面にサーバー URL を貼り付けることはできません。

ステップ 1:サーバーをビルドする

Elido リポジトリのチェックアウトで以下のコマンドを実行します。packages/mcp-server/dist/index.js が生成されるので、絶対パスを控えておきます。

pnpm install
pnpm --filter @elido/mcp-server build

ステップ 2:API キーを作成する

1. Dashboard → API Keys → New key を開きます。
2. 権限を選びます(読み取り専用なら links:read と analytics:read、リンク作成には links:write も追加)。
3. キーをコピーします。API には Authorization: Bearer … として送信されます。

Claude Desktop

{
  "mcpServers": {
    "elido": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "ELIDO_API_KEY": "your_api_key",
        "ELIDO_WORKSPACE_ID": "42"
      }
    }
  }
}

~/Library/Application Support/Claude/claude_desktop_config.json(macOS)または %APPDATA%\Claude\claude_desktop_config.json(Windows)を編集し、Claude Desktop を完全に再起動します。

Cursor

同じ mcpServers ブロックをプロジェクトの .cursor/mcp.json(全プロジェクト共通なら ~/.cursor/mcp.json)に追加し、Cursor を再起動します。

Claude Code

claude mcp add elido --env ELIDO_API_KEY=your_api_key -- \
  node /absolute/path/to/packages/mcp-server/dist/index.js

claude mcp list を実行して、サーバーが接続されていることを確認します。

利用できるツール

ツール	内容
create_link	スラッグ、ドメイン、タイトル、タグを任意指定して URL を短縮する
list_links	ワークスペースの最近のリンクを一覧表示する
query_analytics	ワークスペースまたはリンクのクリック数の時系列(タイムゾーン対応)
generate_qr	既存のリンクの QR コード(SVG または PNG)を生成する
list_workspaces	API キーでアクセスできるワークスペースを一覧表示する

環境変数:ELIDO_API_KEY(必須)、ELIDO_WORKSPACE_ID(キーが複数のワークスペースを参照できる場合に指定)、ELIDO_API_BASE(既定は https://api.elido.app、セルフホストでは変更)。

トラブルシューティング

クライアントでサーバーが失敗と表示される。 args のパスが絶対パスで、dist/index.js が存在するか確認してください(ビルドをやり直す)。ターミナルで ELIDO_API_KEY=test node /absolute/path/to/packages/mcp-server/dist/index.js を実行すると起動エラーを確認できます。

「Unauthorized」になる。 キーが未設定、誤り、または失効しています。Dashboard → API Keys で新しく作成してください。

リンク作成で「forbidden」になる。 キーに links:write がありません。