ElidoをあらゆるAIエージェントに接続。
Elido MCPは、リンク、QR、分析APIをMCPツールとして公開するオープンソースサーバーです。Claude Desktop、Cursor、または自社エージェントに30秒で導入可能です。
MCPとは？
Model Context ProtocolはAnthropicによるオープンスタンダードで、AIエージェントがツール、ファイル、APIと構造化された方法で通信できるようにします。1つのプロトコルで多くのクライアントに対応します。
Before MCP, wiring an AI agent to an external service meant writing custom prompt instructions, maintaining a hand-crafted tool schema, and hoping the model would call it correctly. MCP replaces that with a standardized protocol: the server declares its tools in JSON Schema, the client discovers them automatically, and every call is typed and auditable. One protocol works across Claude Desktop, Cursor, Claude Code, Continue.dev, and any other MCP-aware client.
The Elido MCP server runs locally in your environment. It holds your API key, translates structured tool calls from the agent into REST requests to api.elido.app, and returns structured results. The agent never sees your key; api.elido.app never speaks directly with the model.
Runtime flow
From your chat message to the Elido API and back
The sequence is four steps. Each is fast — the MCP layer adds under 5ms of overhead. The REST call to api.elido.app takes 30-80ms from EU. You see the result in chat before you can alt-tab to a browser.
仕組み
MCPは軽量なワイヤープロトコルです。サーバーはお客様の環境で動作し、APIキーを保持し、エージェントからの構造化されたツール呼び出しを api.elido.app へのRESTリクエストに変換します。
- 1. エージェントがツールを要求する
起動時にMCPクライアント（Claude Desktop、Cursor、独自エージェントなど）がElidoサーバーにツールカタログを要求します。サーバーは利用可能なすべてのツール（名前、パラメータ、戻り値の形式）をJSON-Schema形式で返します。
- 2. ユーザーがチャットでリクエストする
あなたが「タグ launch-2026 を付けてこのURLを短縮して」と言うと、エージェントはカタログと照合し、構造化された引数で create_link を呼び出すことを決定します。クライアントが対応していれば（Claude Desktopなど）、実行前にツール呼び出しの内容が表示されます。
- 3. サーバーが api.elido.app にアクセスする
ローカルのMCPサーバーは、あなたの ELIDO_API_KEY でリクエストに署名し、対応するRESTエンドポイントを呼び出します。レイテンシの大部分は api.elido.app への往復（EUからは通常30〜80ms）であり、MCP層のオーバーヘッドは5ms未満です。
- 4. 結果がエージェントに返される
レスポンスは構造化されたツール結果として返され、エージェントはそれを引用、要約、または次の呼び出しへの連鎖に使用できます。エラーには実用的なメッセージ（レート制限のヒント、スコープ不足、未検出など）が含まれるため、エージェントはユーザーに頼らずに復旧を試みることができます。
利用可能なツール
Every tool is JSON-Schema typed. The agent sees parameter names, types, and descriptions on startup. No manual prompt engineering required.
Example session
What it looks like after install
This is a real Claude Code session after adding the Elido MCP server. The agent discovers tools on startup. From there, plain language is enough.
$ claude
> What tools do you have available?
Claude: I have access to the Elido MCP server with these tools:
- create_link: Shorten a URL with optional slug, domain, and tags
- list_links: Search and filter links by tag, folder, or query
- get_link_analytics: Click counts, geo, devices, conversions
- create_qr: Generate a QR code for a short link
- list_workspaces: Enumerate accessible workspaces
> Shorten https://elido.app/pricing with tag launch-2026
Claude: [calling create_link with {url, slug: "pricing-launch", tags: ["launch-2026"]}]
Result: eldo.link/pricing-launch · 0 clicks · audit loggedThe tool call is visible before it executes in Claude Desktop and Claude Code. You see exactly what arguments the agent passes. You can cancel before the call fires.
チームによる活用事例
本番環境で見られる3つのパターン。チームの現在の作業スタイルに合うものを選んでください。
なぜ直接のAPI呼び出しではなく、MCPなのですか？
どちらのアプローチも同じElidoエンドポイントに到達します。違いはセットアップ時間、セキュリティ体制、そしてエージェントの推論の読みやすさにあります。
| 全機能を徹底比較 | Elido MCP | Direct REST | Browser only |
|---|---|---|---|
| セットアップ時間 | 30秒（設定 + キー） | カスタムプロンプト + ツール定義（数時間） | 手動での貼り付け / スクレイピング（自動化なし） |
| ツールカタログ | 自動検出、JSON-Schemaによる型定義 | 手書き、APIの進化に伴う乖離 | なし — エージェントによる推測が必要 |
| APIキーの取り扱い | ローカルサーバーの環境変数に保持 | プロンプトに貼り付け（漏洩のリスク） | ダッシュボードに貼り付け（クッキーに紐付け） |
| 監査証跡 | チャット履歴内の構造化されたツール呼び出し | フリーテキスト — 後から検索が困難 | ブラウザ履歴 — 意図を把握できない |
| 複数クライアントでの再利用 | 1つの設定で、複数のMCP対応クライアントを利用可能 | クライアントごとに再プロンプト | ブラウザごとの状態、ポータビリティなし |
テスト済みクライアント
Stability ratings are based on our internal test suite that runs against each client on every release. “Stable” means the full tool catalogue passes. “Beta” means it works but edge cases (streaming results, long lists) may behave unexpectedly.
Security
Read-only by default. Key stays local.
The security model follows the principle of fewest-scopes-needed. The default install has read-only access. Every mutation is logged. The API key never leaves the local server process.
Key isolation
ELIDO_API_KEY lives in the server's env — never in a prompt, never sent to the model. The model calls the tool; the server signs the request. Compromise of the model conversation doesn't expose the key.
Scope gating
Read-only is default. Granting write or delete access requires a deliberate workspace setting. Even with writes enabled, every mutation shows up in the workspace audit log with the calling key.
Open source
The server is MIT-licensed at github.com/elidoapp/mcp-server. Read the source before you deploy. Common forks add workspace-specific enrichment or internal tool calls.
30秒でインストール
サーバーはローカルで動作し、ワークスペースのAPIキーで認証します。api.elido.appへの通常の呼び出し以外、データがマシンから出ることはありません。
- 1クライアント設定にサーバーを追加
- 2ELIDO_API_KEYを設定（設定 → APIキー で発行）
- 3クライアントを再起動。エージェントのツールリストにElidoが表示されます。
{
"mcpServers": {
"elido": {
"command": "npx",
"args": ["-y", "@elido/mcp-server"],
"env": { "ELIDO_API_KEY": "elido_pk_..." }
}
}
}Same snippet works for Cursor — drop it into .cursor/mcp.json. For Claude Code, add it to your project’s .mcp.json. Issue the API key in Settings → API Keys. Read-only scope is sufficient for most workflows.
よくある質問
データは自分のマシンから外に出ますか？+
api.elido.app に対して行う呼び出し以外は出ません。MCPサーバーは stdio（デフォルト）またはローカルの SSE です。勝手に外部に送信したり、テレメトリを収集したりすることはありません。ソースコードはGitHubで公開されており、検証可能です。ダッシュボードと同じEU居住規則が適用されます。
エージェントが誤ってリンクを削除してしまうことはありますか？+
デフォルトのインストール設定ではあり得ません。デフォルトは読み取り専用モードです。書き込み/削除の許可には、ワークスペースの設定を意図的に変更する必要があります。書き込みを有効にしても、すべての変更は呼び出したAPIキーと共に監査ログに記録されます。
どのクライアントがサポートされていますか？+
Claude Desktop、Cursor、Claude Codeは安定しています。Continue.devはベータ版です。stdioまたはSSEを介してMCP 0.1.0を話すクライアントであれば動作します。リファレンスクライアントの実装に対してテストを行っています。
レート制限はどうなっていますか？+
ワークスペースのAPIキーと同じです。持続的に100リクエスト/秒、バーストで200リクエスト/秒です。429エラーが発生すると Retry-After を伴って制限されます。MCPサーバーは429をツールエラーとしてそのまま渡すため、エージェントは待機（バックオフ）を試みることができます。追加の制限レイヤーはありません。
／ai／llmにあるLLM連携とどう違うのですか？+
レイヤーが異なります。/ai/llmは一般ユーザー向け（カスタムGPT、Slackボット、ディープリンクボタン）で、構築済みですぐに使えます。MCPはそれらの下に位置する開発者向けプロトコルです。これらの連携機能はMCPの上に構築することが可能で、多くのサードパーティクライアントが実際にそうしています。
独自のフォークを動かすことはできますか？+
はい。リポジトリはMITライセンスです。一般的なフォークでは、カスタムツール（ワークスペース固有のメタデータ補完、Notion/Linearへの内部リンクなど）が追加されています。もし便利なツールを作成された場合は、ぜひIssueを作成してください。広く有用なツールは本体に取り込みたいと考えています。
エアギャップ環境（隔離環境）で動作しますか？+
セルフホスト版Elidoであれば動作します。MCPサーバーは api-core エンドポイントへのネットワークアクセスのみを必要とするため、プライベートVPC内でも動作可能です。パブリッククラウド版Elidoの場合は、他のAPIクライアントと同様に api.elido.app への外向き通信が必要です。
APIキーのセキュリティモデルはどうなっていますか？+
「必要最小限のスコープ」の原則が適用されます。単一のワークスペースに限定したスコープでキーを発行し、クライアントが固定IPから実行される場合はIP制限をかけ、四半期ごとに更新してください。キーが漏洩した場合の被害範囲は、通常のAPIキーの漏洩と同じです（ワークスペース内に限定、監査ログに記録、無効化可能）。
30秒でセットアップ完了
スニペットをClaude DesktopやCursorに貼り付け、再起動するだけで、エージェントのカタログにツールが表示されます。